Name

PSCR − Associates the color index with the color triplet values in the color table. 

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

Old Syntax

PSCR (WKID, CI, C1, C2, C3)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
WKID           Integer        Read      Workstation identifier
CI             Integer        Read      Color index
C1, C2, C3     Real           Read      Color components
---------------------------------------------------------------------------

New Syntax

PSCR (WKID, CI, NCSS, CSPEC)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
WKID           Integer        Read      Workstation identifier
CI             Integer        Read      Color index
NCSS           Integer        Read      Number of components in the color
                                        specification
CSPEC(NCSS)    Real           Read      Color specification
---------------------------------------------------------------------------

Description

PSCR associates the color index with the color triplet values in the color table.  The color table is in the workstation state list of the workstation specified by the workstation identifier. 

  This function allows you to create or redefine an entry for the workstation color table.  To determine the predefined bundle table entries, which are provided for all workstations of type OUTPUT and OUTIN, and which are derived from the workstation description table, run the program phigs_predef. 

The color triplet argument specifies the coordinates of the current color model at the workstation.  See the PSCMD function for a description of the color models. 

Digital PHIGS provides at least two predefined entries (index 0 and 1) for the color bundle tables for every OUTPUT and OUTIN category workstation.  Entry values are derived from the workstation description table and maintained in the workstation state list. 

When Digital PHIGS displays primitives during structure traversal, the applicable current color index entry in the PHIGS traversal state list points to an entry in the color table on the workstation.  If Digital PHIGS does not find the specified color index, it uses the index value 1 for the foreground color, and the index value 0 for the background color. 

See Also

PQCF
PQCMD
PQCR
PQPCR
PSCMD
PSEDC
PSIC
PSPLC
PSPMC
PSRCM
PSTXC