PINLC3(3g) — Subroutines
Name
PINLC3 − Sets the locator device to application-specific values.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PINLC3 (WKID, LCDNR, IVIEWI, IPX, IPY, IPZ, PET, EVOL, LDR, DATREC)
Argument Data Type Access Description
---------------------------------------------------------------------------
WKID Integer Read Workstation identifier
LCDNR Integer Read Locator device number
IVIEWI Integer Read Initial view index
IPX, IPY Real Read Initial locator position, in world
IPZ coordinates (x, y, z)
PET Integer Read Prompt and echo type
EVOL(6) Array of Read Echo volume, in device coordinates
reals (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX)
LDR Integer Read Dimension of the data record array
DATREC(LDR) Character ∗80 Read Data record
---------------------------------------------------------------------------
Description
PINLC3 sets the locator device to application-specific values. You specify the initial locator position (in world coordinate values), and the initial view index of the view transformation Digital PHIGS uses to translate the device coordinate point to a normalized projection coordinate point.
This function accepts the echo volume in a 6-component list of x-, y-, and z-coordinates, in device coordinates. The order of the list components is XMIN < XMAX, YMIN < YMAX, ZMIN < ZMAX.
When an application calls PINLC3, the workstation surface cannot contain the locator device’s prompt. To remove an existing prompt from the surface, call the PSLCM function and place the device in request mode.
The size and contents of the data record depend on the prompt and echo type you specify. If the size or contents of the data record does not match the requirements of your chosen prompt and echo type, Digital PHIGS generates an error.
See Locator-Class PETs for information on locator-class prompt and echo types.
See Also
PGTLC3
PINLC
PQDLC3
PQLCS3
PRQLC3
PSMLC3
PSLCM
PSVTIP