REQUEST LOCATOR 3
CALL SEQUENCE
PRQLC3 (WKID, LCDNR, STAT, VIEWI, PX, PY, PZ)
INPUT PARAMETERS
INTEGER WKID
INTEGER LCDNR
OUTPUT PARAMETERS
INTEGER STAT
INTEGER VIEWI
REAL PX, PY, PZ
ARGUMENTS
- WKID
- Workstation identifier.
- LCDNR
- LOCATOR input device identifier.
- STAT
- State of request carried out.
- PNONE:
- 0 (NONE)
- POK:
- 1 (OK)
- VIEWI
- View number in which selection was made.
- PX, PY, PZ
- Coordinates of selected point (WC).
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request the 3D position of the graphic cursor in WC space by user action on the
left mouse button of the active input device LCDNR with the possibility
of cancelling the input by clicking on the right button of the mouse.
The request state is thus attributed the OK or NONE (break) state.
Example:
C Request locator on workstation number 1 using device number 1
INTEGER WKID,LCDNR,STAT,VIEWI
REAL PX,PY,PZ
.....
WKID = 1
LCDNR = 1
call PRQLC3(WKID,LCDNR,STAT,VIEWI,PX,PY,PZ)
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
SEE ALSO
set locator mode, request locator, initialize locator 3, sample locator 3, get
locator 3, await event, inquire locator device state 3, inquire default locator
device state 3, locator without interaction (ext)