READ LOCATOR

Reads the locator device without waiting for a digitize operation.

READ LOCATOR x-variable,y-variable [,string-name$]

Usage:

READ LOCATOR X,Y

READ LOCATOR Xcoor,Ycoor,Position$

Description:

The locator device position is read into the X and Y variables without waiting for a digitize operation. The current GRAPHICS INPUT IS device coordinates are in default units or the units defined in a WINDOW or SHOW statement. The optional string variable will receive the 8 byte status message defined as follows:

Byte	Meaning
1	Button Status - Status of the digitizing button on the locator. If the character is a "1", then the button is pressed; if it is a "0", then the button is not pressed.
2	Comma delimiter character.
3	Clip Indicator - If the character is a "0", then the point is outside the hard-clip limits. If a "1", the point is inside the hard-clip limits, but outside the soft-clip limits (clipping rectangle - see CLIP). If a "2" then it's inside the soft-clip limits
4	Comma delimiter character
5	Tracking ON/OFF - If the character is a "0", then tracking is off; if a "1", then tracking is on.
6	Comma delimiter character.
7-8	Button Positions - If S$ is the status string and B is the button number you wish to test, then BIT( VAL(S$[7,8]), B-1) returns one if B is down and zero if B is up.