Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileSETMOUSE mx,my[,mk]

mx, my, mk: iexp

The command SETMOUSE permits the positioning of the mouse cursor under program
control. The optional parameter mk can simulate the mouse buttons being pressed
or released. This unfortunately is only valid for the VDI, not, (or seldom)
with the AES.

Example:

    FOR i%=0 to 300
      HIDEM
      SETMOUSE i%,i%
      PLOT MOUSEX,MOUSEY
      SHOWM
      PAUSE 2
    NEXT i%

--> Moves the mouse pointer diagonally down the screen, plotting points at its
    current position as it goes.

Memo: This command should be considered a Line-A call.
      Use with caution or not at all.

      SETMOUSE -> CUR_X/CUR_Y, GCURX/GCURY, MOUSE_BT (Line-A variables)
                  USER_MOT, USER_BUT, DEV_TAB

      The editor seems to swap the left and right button values:
      As documented by Atari: (the compiler works as documented)
      Bit  Value  Meaning  Bit status
      ---  -----  -------  --------------
      01   1      Left     On=down/Off=up
      10   2      Right    On=down/Off=up
      11   3      Both     On=down/Off=up

Line-A Variable Table+
appl_tplay()+, vsm_locator()+, vex_motv()+, vex_butv()+