PQCR(3g) — Subroutines

Name

PQCR − Returns color values.

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

Old Syntax

PQCR (WKID, COLI, TYPE, ERRIND, C1, C2, C3)

Argument          Data Type     Access    Description
---------------------------------------------------------------------------
WKID              Integer       Read      Workstation identifier
COLI              Integer       Read      Color index
TYPE              Integer       Read      Type of the returned values
ERRIND            Integer       Write     Error indicator
C1, C2, C3        Real          Write     Color components
---------------------------------------------------------------------------

New Syntax

PQCR (WKID, COLI, CCSBSZ, TYPE, ERRIND, OL, CSPEC)

Argument          Data Type     Access    Description
---------------------------------------------------------------------------
WKID              Integer       Read      Workstation identifier
COLI              Integer       Read      Color index
CCSBSZ            Integer       Read      Buffer size of the color
                                          component specification
TYPE              Integer       Read      Type of the returned values
ERRIND            Integer       Write     Error indicator
OL                Integer       Write     Number of color components in
                                          the color specification
CSPEC(CCSBSZ)     Array of      Write     Color specification
                  reals
---------------------------------------------------------------------------

Constants

Defined Argument     Constant    Description
---------------------------------------------------------------------------
TYPE                 PSET        Use the exact state list values.
                     PREALI      Use the values approximated by the graphics
                                 handler.
---------------------------------------------------------------------------

Description

PQCR queries the workstation state list and returns the color values. If the color model uses a triplet, the values are the color coordinates of the color in the current color model on the workstation. (See the PSCMD and PSCR functions.) The returned values are affected by the specified type of returned values, as follows:

•When the specified type of returned values is PSET, the function sets the values it returns to the color triplet as closely as possible to the color associated with the specified color index predefined by Digital PHIGS or set by this function. In some cases, PSET will cause the function to return the same values when you specify PREALI.

•When the specified type of returned values is PREALI, the function sets the values it returns to the color triplet to the colors associated with color index 1, if one of the following conditions exists:

•The color associated with the specified color index was not predefined or set.

•The specified color index is greater than the range of the workstation color table.