**CIGAL Reference Manual, Chapter 3 (Functions): GETXYZ**
===== GETXYZ -- Read the cursor position =====
**usage: v = getxyz(flag)**

GETXYZ reads the cursor's position and returns a vector with the
cursor X, Y, Z and Key values.  The Key value is the character or
command number that terminated the GETXY call.  These values are
returned in a VECTOR suitable for assigning to a VECTOR type variable.
Assigning the results of a GETXYZ call to a NUMBER variable, assigned
the KEY value.  In this case you read the X and Y values using the number
registers CURSX and CURSY (see [[jvs:cigal:manual:chapter4:cursx|CURSX(4)]] and [[biac:jvs:cigal:manual:chapter4:cursy|CURSY(4)]]).  For example:
                  getxyz
then move the cursor around and when done type a 'q' on the keyboard. GETXY returns:
                  100 150 0 113
100 and 150 are sample X and Y cursor positions and 113 is the ASCII code for the letter 'q'.

**See Also:**\\
[[jvs:cigal:manual:chapter4:cursor|CURSOR(4)]], 
[[jvs:cigal:manual:chapter4:cursx|CURSX(4)]], 
[[jvs:cigal:manual:chapter4:cursy|CURSY(4)]], 
[[jvs:cigal:manual:chapter4:getx|GETX(4)]], 
[[jvs:cigal:manual:chapter4:gety|GETY(4)]], 
[[jvs:cigal:manual:chapter1:vectors|VECTORS(1)]], 
[[jvs:cigal:manual:chapter4:zdev|ZDEV(4)]], 
[[jvs:cigal:manual:chapter4:zvalue|ZVALUE(4)]]

[[jvs:cigal|CIGAL Home]], 
[[jvs:cigal:manual|CIGAL Manual]], 
[[jvs:cigal:manual:chapter3|Functions List]], 
[[jvs:cigal:manual:help|Manual Help]]