SAMPLE LOCATOR 3

PSMLC3

CALL SEQUENCE

CALL PSMLC3 (WKID, LCDNR, VIEWI, LPX, LPY, LPZ)

INPUT PARAMETERS

INTEGER WKID

Workstation identifier.

INTEGER LCDNR

LOCATOR input device identifier.

OUTPUT PARAMETERS

INTEGER VIEWI

Current point view number.

REAL LPX, LPY, LPZ

Current point coordinates (WC).

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Read current 3D position of graphic cursor in WC space on active input device LCDNR.

Example:

C Sample locator on workstation number 1 using device number 1
	INTEGER WKID,LCDNR,VIEWI
	REAL PX,PY,PZ
	.....
	WKID = 1
	LCDNR = 1
	call PSMLC3(WKID,LCDNR,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

252

Ignoring function, the function requires the input device to be in SAMPLE mode

SEE ALSO

sample locator, set locator mode, initialize locator 3, request locator 3, get locator 3, await event, inquire locator device state 3, inquire default locator device state 3, locator without interaction (ext)