PQDCR(3g) — Subroutines

Name

PQDCR − Returns values for depth cue mode, reference planes, scale factors, and color.

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

Old Syntax

DQDCR (WKID, DCI, TYPE, ERRIND, MODE, BKPLN, FTPLN, BKSCL, FTSCL,
CLRTYP, ICOLR, COLR)

Argument          Data Type     Access     Description
---------------------------------------------------------------------------
WKID              Integer       Read       Workstation identifier
DCI               Integer       Read       Depth cue index
TYPE              Integer       Read       Type of values to return
ERRIND            Integer       Write      Error indicator
MODE              Integer       Write      Depth cue mode
BKPLN, FTPLN      Array of      Write      Depth cue reference planes
                  reals
BKSCL, FTSCL      Array of      Write      Scale factors at (BKPLN, FTPLN)
                  reals
CLRTYP            Integer       Write      Color type
ICOLR             Integer       Write      Indexed color value
COLR(3)           Array of      Write      Direct color values
                  reals
---------------------------------------------------------------------------

New Syntax

PQDCR (WKID, DCI, CCSBSZ, TYPE, ERRIND, DCMODE, DQMIN, DQMAX,
DCSFMI, DCSFMX, CTYPE, COLI, NCC, COLR)

Argument          Data Type     Access     Description
---------------------------------------------------------------------------
WKID              Integer       Read       Workstation identifier
DCI               Integer       Read       Depth cue index
CCSBSZ            Integer       Read       Buffer size of the color component
                                           specification
TYPE              Integer       Read       Type of values to return
ERRIND            Integer       Write      Error indicator
DCMODE            Integer       Write      Depth cue mode
DQMIN, DQMAX      Array of      Write      Depth cue reference plane, in
                  reals                    normalized projection coordinates
DCSFMI, DCSFMX    Array of      Write      Depth cue scale factors at
                  reals                    (DQMIN, DQMAX)
CTYPE             Integer       Write      Color type
COLI              Integer       Write      Color index
NCC               Integer       Write      Number of color value components
COLR(CCSBSZ)      Array of      Write      Color values
                  reals
---------------------------------------------------------------------------

Constants

Defined Argument     Constant    Description
---------------------------------------------------------------------------
TYPE                 PSET        Use the exact state list values.
                     PREALI      Use the values approximated by the graphics
                                 handler.
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

PQDCR returns values for the following:

•Depth cue mode

•Depth cue reference planes

•Depth cue scale factors

•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 PREALI, the function returns the representation for the depth cue index 1.