PINLC(3g) — Subroutines
Name
PINLC − Sets the locator device to application-specific values.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PINLC (WKID, LCDNR, IVIEWI, IPX, IPY, PET, XMIN, XMAX, YMIN, YMAX,
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
coordinates (x, y)
PET Integer Read Prompt and echo type
XMIN, XMAX, Real Read Echo area, in device coordinates
YMIN, YMAX
LDR Integer Read Dimension of the data record array
DATREC(LDR) Character ∗80 Read Data record
---------------------------------------------------------------------------
Description
PINLC 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. The z-component of a previously specified locator position remains unchanged.
This function accepts the echo area in a 4-component list of x- and y-coordinates, in device coordinates. The order of the list components is XMIN < XMAX, YMIN < YMAX. The z-components of a previously specified echo volume remain unchanged.
When an application calls PINLC, 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
PGTLC
PINLC3
PQDLC
PQLCS
PRQLC
PSMLC
PSLCM
PSVTIP