PQPDCR(3g) — Subroutines

Name

PQPDCR − Returns predefined depth cue information for the index.

Operating States: PHOP, ∗, ∗, ∗
PHIGS PLUS function

Old Syntax

DQPDC (WTYPE, DCI, ERRIND, MODE, BKPLN, FTPLN, BKSCL, FTSCL,
CLRTYP, ICOLR, COLR)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
DCI               Integer        Read      Predefined depth cue index
ERRIND            Integer        Write     Error indicator
MODE              Integer        Write     Depth cue mode
BKPLN, FTPLN      Real           Write     Depth cue reference planes
BKSCL, FTSCL      Real           Write     Scale factor at (BKPLN, FTPLN)
CLRTYP            Integer        Write     Depth cue color type
ICOLR             Integer        Write     Indexed color value
COLR(3)           Array of       Write     Direct color value
                  reals
---------------------------------------------------------------------------

New Syntax

PQPDCR (WTYPE, PDCI, CCSBSZ, ERRIND, DCMODE, DQMIN, DQMAX, DCSFMI,
DCSFMX, CTYPE, COLI, NCC, COLR)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
PDCI              Integer        Read      Predefined depth cue index
CCSBSZ            Integer        Read      Buffer size of the color component
                                           specification
ERRIND            Integer        Write     Error indicator
DCMODE            Integer        Write     Depth cue mode
DQMIN, DQMAX      Real           Write     Depth cue reference planes
DCSFMI, DCSFMX    Real           Write     Scale factor at (DQMIN, DQMAX)
CTYPE             Integer        Write     Depth cue color type
COLI              Integer        Write     Color index
NCC               Integer        Write     Number of color value components
COLR(CCSBSZ)      Array of       Write     Color values
                  three reals
---------------------------------------------------------------------------

Constants

Defined Argument     Constant    Description
---------------------------------------------------------------------------
DCMODE               PSUPPR      No depth cueing
                     PALLOW      Perform depth cueing
CTYPE                PINDIR      Indirect (indexed) color
                     PRGB        Direct specification of red, green, and
                                 blue
                     PCIE        Direct specification in the format of the
                                 Commission Internationale de l’Eclairage
                     PHSV        Direct specification of hue, saturation,
                                 and value
                     PHLS        Direct specification of hue, lightness,
                                 and saturation
---------------------------------------------------------------------------

Description

PQPDCR returns values for the following:

•Depth cue mode

•Depth cue reference planes

•Depth queue scaling

•Depth cue color

If the specified depth cue index is not in the depth cue table on the specified workstation, and the specified type of returned value is REALIZED, the function returns the representation for the depth cue index 1.