PSDCR(3g) — Subroutines

Name

PSDCR − Associates a depth cue index with related depth cue information.

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

Old Syntax

DSDCR (WKID, DCI, MODE, BKPLN, FTPLN, BKSCL, FTSCL, CLRTYP, ICOLR,
COLR)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
WKID           Integer        Read       Workstation identifier
DCI            Integer        Read       Depth cue index
MODE           Integer        Read       Depth cue mode
BKPLN, FTPLN   Real           Read       Depth cue reference planes
BKSCL, FTSCL   Real           Read       Depth cue scale factors at
                                         BKPLN and FTPLN
CLRTYP         Integer        Read       Color type
ICOLR          Integer        Read       Indexed color value
COLR(3)        Array of       Read       Direct color value
               reals
---------------------------------------------------------------------------

New Syntax

PSDCR (WKID, DCI, 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
DCMODE         Integer        Read       Depth cue mode
DQMIN, DQMAX   Real           Read       Depth cue reference planes, in
                                         normalized projection coordinates
DCSFMI,        Real           Read       Depth cue scale factors
DCSFMX
CTYPE          Integer        Read       Color type
COLI           Integer        Read       Color index
NCC            Integer        Read       Number of color value components
COLR(NCC)      Array of       Read       Color values
               reals
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
DCMODE                PSUPPR        No depth cueing. This is the default
                                    value.
                      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

PSDCR associates a depth cue index with the following related depth cue criteria:

•Depth cue mode

•Depth cue reference planes

•Depth cue scaling

•Depth cue color values in the depth cue table, on the workstation specified by the workstation identifier

This function associates the specified index with the specified depth cue values to create or modify the depth cue table entry. Each entry contains a depth cue mode, two depth cue reference planes, two depth cue scale factors, and a depth cue color. Depth cue index 0 cannot be modified.

A depth cue mode of SUPPRESSED or ALLOWED disables or enables the effects of depth cueing. The depth cue reference planes are two z values in normalized projection coordinates that define a back reference plane and a front reference plane for depth cueing. The depth cue scale factors are two values between 0.0 and 1.0. These values correspond to the z values of the depth cue reference planes and define the portion of the primitive’s color and the depth cue color that will be combined as a function of z in normalized projection coordinates.

Depth cue color consists of three real values. See the PSCMD and PSCR functions for information about color models and representation.

Digital PHIGS defines depth cueing for all primitives, unlike lighting and shading, which apply to area-defining primitives only. If CTYPE = PINDIR, the function uses the COLI argument. Otherwise, the function uses the COLR argument.

The new function syntax conforms to the ISO Fortran standard. Digitael recommends that you code using the new function syntax.