PQSKS3(3g) — Subroutines

Name

PQSKS3 − Returns information about the stroke device state.

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

Old Syntax

PQSKS3 (WKID, SKDNR, TYPE, N, MLDR, ERRIND, MODE, ESW, IVIEWI, NP,
IPXA, IPYA, IPZA, PET, EVOL, BUFLEN, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WKID              Integer        Read      Workstation identifier
SKDNR             Integer        Read      Stroke device number
TYPE              Integer        Read      Type of the returned values
N                 Integer        Read      Maximum number of points
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
NP                Integer        Write     Number of points
IPXA(N), IPYA(N) Real           Write     Initial points in the stroke,
IPZA(N)                                    in world coordinates
PET               Integer        Write     Prompt and echo type
EVOL(6)           Array of       Write     Echo volume, in device
                  reals                    coordinates (XMIN, XMAX, YMIN,
                                           YMAX, ZMIN, ZMAX)
BUFLEN            Integer        Write     Input buffer size
LDR               Integer        Write     Number of array elements used in
                                           a data record
DATREC(MLDR)      Character ∗80 Write     Data record
---------------------------------------------------------------------------

New Syntax

PQSKS3 (WKID, SKDNR, TYPE, N, MLDR, ERRIND, MODE, ESW, IVIEWI, NP,
IPXA, IPYA, IPZA, PET, EVOL, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WKID              Integer        Read      Workstation identifier
SKDNR             Integer        Read      Stroke device number
TYPE              Integer        Read      Type of the returned values
N                 Integer        Read      Maximum number of points
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
NP                Integer        Write     Number of points
IPXA(N), IPYA(N) Real           Write     Initial points in the stroke,
IPZA(N)                                    in world coordinates
PET               Integer        Write     Prompt and echo type
EVOL(6)           Array of       Write     Echo volume, in device
                  reals                    coordinates (XMIN, XMAX, YMIN,
                                           YMAX, ZMIN, ZMAX)
LDR               Integer        Write     Number of array elements used in
                                           a 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

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

•Operating mode value

•Echo switch value

•List of initial stroke points in world coordinates

•Prompt and echo type

•Echo volume in device coordinates

•Stroke data record

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