Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevsm_locator()
vsin_mode()
vrq_locator()                                                           VDI

Syntax

VOID vrq_locator( handle, mx, my, xout, yout, term )
WORD handle, mx, my;
WORD *xout, *yout, *term;

Function      vrq_locator() inputs information from the 'locator' device
              in request mode.

Opcode        28

Availability  This call is not guaranteed to be available with any driver
              and its use should therefore be restricted.

Parameters    handle specifies a valid workstation handle. To start, the
              mouse cursor is displayed at the location given by mx and
              my. When a key or mouse button is pressed, the call returns.
              The final location of the mouse pointer is filled into the 2
              WORDs pointed to by xout and yout. The WORD pointed to by
              term is filled in with the ASCII key of the character that
              terminated input, 32 (0x20) if the left mouse button was
              struck, or 33 (0x21) if the right mouse button was struck.

Binding       contrl[0] = 28;
              contrl[1] = 1;
              contrl[3] = 0;
              contrl[6] = handle;

              ptsin[0] = mx;
              ptsin[1] = my;

              vdi();

              *term = intout[0];

              *xout = ptsout[0];
              *yout = ptsout[1];

Comments      Using this function will confuse the AES's mouse input
              functions.

See Also      vsm_locator(), vsin_mode()

Group         VDI Input