REVMEDIA FKB Articles - AREV, OI, REV G, jREV, JCDC, LIVEWATER,ADVANCED REVELATION, OPENINSIGHT, REVELATION G

RevMedia FKB

Document	V4I5A1
Title	Version 3 Technical Highlights - Mouse_Subs
Keywords	MOUSE_SUBS
Text	The Mouse_Subs routine has been fundamentally rewritten (to conform very closely to the published specifications for the Microsoft mouse driver based around interrupt 33 calls) since it was discussed in Volume 3 Issue 7 It now only takes 4 parameters As previously the first one is an action code but again as this is a C or assembler routine the other parameters vary based upon the action code Code � Description � Param1 � Param2 � Param3 �� 0 � Initialize mouse driver � Must be null � Must be null � Must be null � Code returns 0 if a � Returns the � � � mouse is not installed � number of � � � or 1 if a mouse is � buttons which� � � installed and RESET � is always 2 � � � � or Microsoft � � � If the mouse has been � Mouse � � � lost (due to PCing to � � � � DOS or somesuch) it can � � � � be restored WITH a � � � � Ctrl Break OR by calling� � � � Mouse_Subs PASSING it a � � � � 0 followed by a 1 � � � �� 1 � Turns mouse back on � Must be null � Must be null � Must be null � AFTER it has been turned� � � � off WITH a code 2 � � � �� 2 � Turns mouse off � Must be null � Must be null � Must be null � temporarily � � � �� 3 � Returns CURRENT location� Must be � Must be � Must be � and state of mouse � initialised � initialised � initialised � � Returns � Returns the � Returns the � � 0 No key � X position of� Y position of � � being � the mouse � the mouse � � pressed � � � � 1 Left key � � � � being � � � � pressed � � � � 2 Right key � � � � being � � � � pressed � � � � 3 Left and � � � � right keys � � � � being � � � � pressed � � �� 4 � Locates mouse at a given� Must be null � X position � Y position � X Y position on screen � � � �� 5 � Returns CURRENT location� Must be � Must be � Must be and 6� and button press state � initialised � initialised � initialised � of mouse � Returns � � � � 0 Key � � � � released � � � � 1 Left key � � � � being � � � � held down � � � � 2 Right key � � � � being � � � � held down � � � � 3 Left and � � � � right keys � � � � being � � � � held down � � �� 7 � Sets the X coordinates � Must be null � Leftmost X � Rightmost X � within which the mouse � � position or � position or � can operate � � rightmost X � leftmost X � � � position � position �� 8 � Sets the Y coordinates � Must be null � Leftmost Y � Rightmost Y � within which the mouse � � position or � position or � can operate � � rightmost Y � leftmost Y � � � position � position �� 10 � Permits the definition � Initialise to� Set to 32512 � Set to the � of the mouse CURSOR � zero � if USING the � ascii value � character and the cursor� � third � to use for � colour At the time of � � parameter to � the mouse � going to press the � � specify the � CURSOR E G � actual values have not � � character to � 2 for a � been fully understood as� � use for the � smiley face � it only seems to be used� � CURSOR � 65 for the � in PAINT when several � � � letter A etc � items are selected by � � Set to 30719 � � "boxing" � � to RESET the � Set to 30464 � � � block CURSOR � to RESET the � � � � block CURSOR �� 11 � Returns a location � Must be null � Must be � Must be null � relative to the last � � initialised � � time the mouse was � � Returns the � � queried Whilst this � � position of � � information is not � � the mouse � � stunningly useful on its� � relative to � � own it does provide a � � where it last� � good way of finding out � � was as a � � whether the mouse is � � positive or � � moving If the second � � negative � � parameter returns a 0 � � integer � � then the mouse is still � � � � any other value means � � � � that the mouse is moving� � � �� 15 � Sets the mickey to pixel� Must be null � The � The � ratio that is how far � � horizontal � vertical � the mouse must move � � sensitivity � sensitivity � before the mouse CURSOR � � of the mouse � of the mouse � moves accordingly The � � The lower the� The lower the � lower the value in � � number the � number the � Param2 and Param3 the � � more the � more the � more sensitive the mouse� � mouse CURSOR � mouse cursor � is � � moves for a � moves for a � � � given mouse � given mouse � � � movement � movement � � � Experiment � Experiment � � � WITH values � WITH values � � � between 1 and� between 1 and � � � 20 � 20 �� 21 � Gets buffer size in � Returns � Must be null � Must be null � bytes required by mouse � buffer size � � �� 26 � Sets mouse sensitivity � X value � Y value � THRESHOLD for � The lower the value used� Defaults to � Defaults to � double speed � the less sensitive the � 50 � 50 � Defaults to � mouse is The range � � � 50 � appears to be 1 to 100 � � � �� 27 � Queries mouse � X value � Y value � THRESHOLD for � sensitivity � � � double speed �� 36 � Queries the version � Must be � Must be � Must be � number and the type of � initialised � initialised � initialised � the mouse � to null � to null � to null � � Returns the � Returns the � � � version � type of � � � number as � mouse � � � what appears � multiplied by� � � to be a � 256 Thus to � � � decimal � get the mouse� � � string that � type divide � � � needs to be � by 256 and � � � converted to � use the � � � a hex string � figures below� � � My mouse � taken FROM � � � version is � the � � � 7 04 the � SYSINCLUDE � � � number � record � � � returned for � CONFIGURE � � � this is 1796 � RECORD EQUS � � � which if � 1 Bus � � � printed � 2 Serial � � � "MXyMD2" � 3 InPort � � � gives 7 04 � 4 PS/2 � � � � 5 HP � �� Some CALLS have been omitted FROM the table above specifically those which have little practical use for normal AREV programming Note that several of the CALLS documented above are not currently used by AREV and thus may not be future proof (It is considered that if AREV itself uses undocumented routines they are far more likely to stay there!) For further information about the missing CALLS see the Microsoft Mouse Programmer's Reference Codes 7 and 8 are used to construct a box on the screen within which the mouse may move Normally this would be set to the screen WIDTH and DEPTH but there might be times when mouse movement within an area is desirable The code 10 can be used to good effect within a LOOP in a PROGRAM when you wish to indicate to a USER that the mouse is inactive and that INPUT FROM it will be ignored The mouse CURSOR can be changed to another figure or even as in the following EXAMPLE changed within the LOOP to give the illusion of a turning bar /* Following code for demonstration purposes only change the DELAY loop to suit your own computer / For z = 1 to 100 CALL MOUSE_SUBS( 10 0 32512 47 ) ; "/" for x = 1 to 1000 ; next CALL MOUSE_SUBS( 10 0 32512 196 ) ; * " " for x = 1 to 1000 ; next CALL MOUSE_SUBS( 10 0 32512 92 ) ; * "\" for x = 1 to 1000 ; next CALL MOUSE_SUBS( 10 0 32512 124 ) ; * "\|" for x = 1 to 1000 ; next next CALL MOUSE_SUBS( 10 0 30719 30464 ) (Volume 4 Issue 5 Pages 4 7)

[revmedia/copyrigh.htm]

Page last modified: 31/01/03