Name

PQLCS − Returns information about the locator device state. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

PQLCS (WKID, LCDNR, TYPE, MLDR, ERRIND, MODE, ESW, IVIEWI, IPX,
IPY, PET, EAREA, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WKID              Integer        Read      Workstation identifier
LCDNR             Integer        Read      Locator device number
TYPE              Integer        Read      Type of the returned values
MLDR              Integer        Read      Dimension of the data record
                                           array
ERRIND            Integer        Write     Error indicator
MODE              Integer        Write     Operating mode
ESW               Integer        Write     Echo switch
IVIEWI            Integer        Write     Initial view index
IPX, IPY          Real           Write     Initial locator position, in
                                           world coordinates
PET               Integer        Write     Prompt and echo type
EAREA(4)          Array of       Write     Echo area, in device coordinates
                  reals                    (XMIN, XMAX, YMIN, YMAX)
LDR               Integer        Write     Number of array elements used in
                                           the data record
DATREC(MLDR)      Character ∗80  Write     Data record
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
TYPE                 PSET         Use the exact state list values.
                     PREALI       Use the values approximated by the
                                  graphics handler.
MODE                 PREQU        Request mode.
                     PSAMPL       Sample mode.
                     PEVENT       Event mode.
ESW                  PNECHO       Echo disabled.
                     PECHO        Echo enabled.
---------------------------------------------------------------------------

Description

PQLCS queries the workstation state list and returns values for the following:

•Operating mode

•Echo switch value

•Initial view index

•Initial locator position in world coordinates

•Prompt and echo type

•Values of the echo area in device coordinates

•Locator data record

See Chapter 9 for information on building data records for initializing input devices. 

See Also

PQLCS3
PINLC
PSLCM