Mouse
The Mouse module provides access and control of your desktop mouse. Using the Mouse module you can
read in the current mouse coordinates and button status. Using the exact same interface you can also
control the mouse position and button status. The interface is bidirectional in that sense.
If the variables specified in the interface change based on some other module or VBScript program those
values will be used to position the desktop mouse to those coordinates/button status. If, however,
the current pipeline does NOT change the variables specified then AND the mouse changes position then
those values are put into the specified variables. Thus, if you change the variables specified the mouse
will respond accordingly, but if you only read the variables then the values of the actual mouse
position and button status will be used to populate the variables. The direction is based on how you
use the variables.
Interface
Instructions
1. Get/Set - Specify the variables that will either contain the values to set the mouse cursor or are used to
read in the current mouse position and button status.
2. Limits - To ensure that the mouse coordinates remain within a specified boundary specify the minimum and maximum limits that
the mouse values can range from.
You can set the button status by using one of:
- LEFT_CLICK
- RIGHT_CLICK
- MIDDLE_CLICK
- LEFT_DOWN
- RIGHT_DOWN
- MIDDLE_DOWN
- LEFT_UP
- RIGHT_UP
- MIDDLE_UP
When reading the button status the value will be one of:
-
- LEFT_DOWN
- RIGHT_DOWN
- MIDDLE_DOWN
Example
 Click here
to load a configuration to move the Mouse based on the position of a red object! We configured the
mouse button to fire when the ball becomes > 50 pixels. You may need to change that based on
your red object size and how close you are to the camera.
Moving a red object in front of your camera will cause the mouse to also move. Note that moving the
object up moves the mouse down. If you move the object towards the camera (zooming) and the COG_BOX_AREA
is above 50 then a mouse button click is simulated. So if you start out with a really large red object
your desktop will probably get quite crazy as simulated mouse clicks are spread around. The best way to
start this demo is to not have any red objects around, then introduce a small red object (like a object
the size of a gold ball) and then gradually move the object towards the camera to click.
Clicking on a window is very tricky. You have to keep your hand steady with respect to the camera while
approaching the camera to ensure that the mouse does not move away from the window bar.
You can still use your mouse even when RoboRealm is trying to control it. Once RoboRealm sees
the mouse moving it will wait until the mouse is stable for 3 seconds and then start setting its position
again. When you run the above example, wait for 3 seconds, and you should then start to
see your mouse jumping around. The above configuration is created for a 320x240 camera meant for a
1280x960 screen. Thus there is a scale factor of 4 in the VBScript that you may change based on your
screen and camera size. The larger the camera size the more stable the mouse will become.
Variables
SCREEN_WIDTH - specifies the desktop screen width
SCREEN_HEIGHT - specifies the desktop screen height
See Also
Joystick
|
