MOUSEKB release 1 date: August 1992. An external driver to be used as an extension of the keyboard. INTRODUCTION ------------ The program MOUSEKB.EXE is a mouse driver that functions as a supplementary driver for any Microsoft Mouse and compatible pointing devices. As such, it is a must to have a Microsoft compatible mouse driver loaded into memory BEFORE activating of MOUSEKB.EXE. Refer to the mouse documentation for details of your specific driver. MOUSEKB.EXE consists of a general part which is used to install and a part which remains resident in memory as long as the system stays powered on. Reactivation of the program overwrites the existing parameters with the 'new' parameters. INSTALLATION ------------ BEFORE installing MOUSEKB.EXE, you MUST HAVE INSTALLED YOUR REGULAR MOUSE DRIVER as usual. Check your mouse documentation for more details. In order to install this extra mouse driver, you have to type the command MOUSEKB at the DOS command line, or you can put the same command in a BATCH-file, before starting your application program. Starting MOUSEKB results (with no Q-parameter present , ref. later on) in the message that this action was successful. If for any reason (f.i. no 'regular' mouse driver loaded) the installation was unsuccessful, an appropriate message will indicate this situation. When finished, this driver can be desactivated with the command option X as follows MOUSE /X When optional parameter(s) are used on the command, several actions of the mouse can be configured. The command with parameters is as follows MOUSEKB {a}{b}{c}.... where {a}... are optional parameters. Each optional parame- ter starts with a slash ('/'). E.g. MOUSEKB /I Parameters are executed in the order they are given. This can be important because some optional parameters will destroy other ones and consequently cancel your previous entered parameter. Each of the optional parameters which can be used are explai- ned in the next chapter. USAGE ----- Activation of this extra mouse driver duplicates several keys of the keyboard. One keyboard key can be determined for each mouse movement direction (North, East, South and West) and one key for each push-button of the mouse (2 or 3, depending on mouse hardware). Moving the mouse or activating a mouse button has the same effect as activating the keyboard key which is configured, it acts as a duplication of this key of the keyboard. Running of MOUSEKB for the first time without any extra parameters results in duplication of the 'default' keyboard keys. These are as follows: moving Up (North) : arrow UP moving Down (South) : arrow Down moving Left (West) : arrow Left moving Right (East) : arrow Right activation Left button : activation Middle button : -C activation Right button : Moreover, other parameters, such as as sensitivity, angle allowance, etc can be adjusted. These are described in the next paragraphs. /I Init of the parameters to a standard value as defi- ned for each individual option. This command can be useful if you want to reset all parameters to the default value at once. /A0 Angle movement of the mouse is desactivated. This means that with a movement of the mouse in an 'almost' vertical direction, only the vertical movement will be seen. This is also true for an 'almost' horizontal movement, where the result will be a simple horizontal movement. This option can be useful for menus and submenus where we can move in both directions but where only one direction is allowed at once. For applications in which angle movement is wanted, this parameter has to be put on 'active' (see next). /A1 Angle movement of the mouse is activated. This means that a movement of the mouse under a specific angle, will result in an equal angle input simulation. Graphical applications do probably prefer this para- meter active. This is the default value. /Hy Horizontal sensitivity. This option determines how far the mouse has to be moved in horizontal direction before the code 'East' or 'West' will be generated. The value of y has to be numeric and be- tween 0 and 9. A value 0 results in the lowest sen- sitivity, whereas a value 9 indicates the highest sensitivity. Each step deviates with about 50% with respect to its predecessor or successor. The stand- ard value is 5. /Vy Vertical sensitivity. This option determines how far the mouse has to be moved in vertical direction before the code 'North' or 'South' will be generated. The value of y has to be numeric and be- tween 0 and 9. A value 0 results in the lowest sensitivity, while a value of 9 results in the highest one. Each step deviates with about 50% with respect to its predecessor or successor. The standard value is 5. /Nxxx{F} North code. This option determines the keyboard code which will be executed when the mouse is moved up- wards (North). The code consists of 3 positions (xxx) as given in an ASCII-table (decimal value). Extended codes have to be followed by 'F'. example 1: We want to generate an 'O' when the mouse is moved upwards. The option is /N048. example 2: We want a simulation when the mouse is moving upwards. The optional code has to be /N071F. /Exxx{F} East code. Same principle as for the 'North code'. This is used for a movement to the right (East) direction. /Sxxx{F} South code. Same principle as used for 'North code'. This option is used for a movement downward. /Wxxx{F} West code. Same principle as used for 'North code'. This option is used for movements to the left. /Lxxx{F} Left mouse button. This option determines the key- board-code which will be executed when the left button of the mouse is activated. The code consists of 3 positions (xxx) as given in an ASCII-table (decimal value). Extended codes have to be followed by 'F'. Example: We want to generate a linefeed when the left button is activated. The code is /L010. /Mxxx{F} Middle mouse button. Same principle as used for 'Left mouse button'. This option is used for middle button activation. /Rxxx{F} Right mouse button. Same principle as used for 'Left mouse button'. This option is used for the right button activation. /Q Quiet operation. Prevents that messages will be printed on the screen. /X Exit. This option keeps this extra mouse driver asleep;in other words: this option disables this extra mouse driver. Reactivation will be done by the next MOUSEKB command. REMARK: To get an overview of the available options, the command MOUSEKB /? has to be given. Any unvalid option will have the same result. STANDARD OPTIONS ---------------- These are the options used as standard when the program is started for the first time (without options) or when the option '/I' is given. /I1 angle direction allowed /H5 average horizontal sensitivity /V5 average vertical sensitivity /N072F arrow up for upward movement /E077F arrow right for right movement /S080F arrow down for downward movement /W075F arrow left for left movement /L013 left mouse button is /M003 middle mouse button (if present) is WARRANTY AND SUPPORT -------------------- The author assumes no responsibility for any loss or damage caused by the use of this software. Neither does he warrant that it will do the expected tasks. Users should agree to accept any risk as a condition of the free use of this softwa- re. The author does not anticipate that any support will be nee- ded. If you have any ideas for improvement, please let me know and I will consider implementation in a new release. I hope I can contribute in this way to what others have done. J. Clerx Breynissemberg, 9 B3300 Tienen Belgium ---------------------------------------------------