INITIALIZE LOCATOR

PINLC

CALL SEQUENCE

CALL PINLC (WKID, LCDNR, IVIEWI, IPX, IPY, PET, XMIN, XMAX, YMIN, YMAX, LDR, DATREC)

INPUT PARAMETERS

INTEGER WKID

Workstation identifier.

INTEGER LCDNR

Locator 2 input device identifier.

INTEGER IVIEWI

View index.

REAL IPX, IPY

Initial position of locator in WC (World Coordinates).

INTEGER PET

Echo type.

REAL XMIN, XMAX, YMIN, YMAX

Echo area in DC.

INTEGER LDR

Number of data records.

CHARACTER*80 DATREC(LDR)

Data record.

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Restricts the 3D initialize locator function to 2D. This function initializes the locator input device (designation of a point on a plane) number LCDNR for workstation WKID .

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

254

Ignoring function, invalid echo area volume: XMIN>=XMAX, YMIN>=YMAX

255

Ignoring function, one of the echo area volume boundary points is outside the range of the device

253

Ignoring function, the specified prompt echo type is not available on the specified workstation

260

Ignoring function, one of the fields within the input device data record is in error

261

Ignoring function, initial value is invalid

114

Ignoring function, the view index value is less than zero

SEE ALSO

initialize locator 3, set locator mode, request locator, sample locator, get locator, inquire locator device state, inquire default locator device state, inquire number of available logical input devices