PQCMR(3g) — Subroutines

Name

PQCMR − Returns color mapping information for the index.

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

Syntax

PQCMR (WKID, CMI, TYPE, MLDR, ERRIND, CMM, LDR, DATREC)

Argument          Data Type      Access   Description
---------------------------------------------------------------------------
WKID              Integer        Read     Workstation identifier
CMI               Integer        Read     Color mapping index
TYPE              Integer        Read     Type of value to return
MLDR              Integer        Read     Dimension of the data record array
ERRIND            Integer        Write    Error indicator
CMM               Integer        Write     Color mapping method
LDR               Integer        Write    Length of the data record array
DATREC(MLDR)      Character ∗80 Write    Data record
---------------------------------------------------------------------------

Constants

Defined Argument   Constant     Description
---------------------------------------------------------------------------
TYPE               PSET         Use the exact state list values.
                   PREALI       Use the values approximated by the graphics
                                handler.
CMM                PTRUE        Digital PHIGS performs the identity
                                mapping.
                   PSUD         Digital PHIGS converts the colors to a
                                single integer index.
                   PSUDN        Digital PHIGS converts the colors to a set
                                of indexes.
---------------------------------------------------------------------------

Description

PQCMR returns the color mapping information associated with the specified index.

Digital PHIGS Version 3.1 does not support this function.

Data Record Information

If CMM is PTRUE, there is no data record.

If CMM is PSUD, the data record has the following format:

INTEGER IL    = 3              Number of integer values
INTEGER IA(1) =                Color model
INTEGER IA(2) =                Number of color value components (NCC);
                                   the same as the number of the weight vector
                                   value
INTEGER IA(3) =                Number of the list of colors in the specified
                                   model (NLC)
INTEGER RL    = NCC+NCC∗NLC    Number of real values
REAL    RA    =                Elements 1 through NCC contain the weight
                                   vector
REAL    RA    =                Elements NCC = 1 through NCC∗NLC+NCC contain
                                   the color value (such as r1, g1, b1, r2, g2,
                                   b2
...
)
        SL    = 0
        LSTR = ()
        STR   = ()

If CMM is PSUDN, the data record has the following format:

INTEGER IL    = 2            Number of integer values.
INTEGER IA(1) =              Color model.
INTEGER IA(2) =              Number of color value components (NCC).
INTEGER IA    =              Elements 3 through NCC+2 contain the array of
                                 end indexes for the lists of color coordinates.
INTEGER RL    = IA(NCC+2)    Number of real values.
REAL    RA    =              Elements 1 through IA(NCC+2) contain the lists of
                                 color coordinates. For example, if the color
                                 type is PRGB:
                                     RA elements 1 through IA(3) contain red
                                        values
                                     RA elements IA(3)+1 through IA(4) contain
                                        green values
                                     RA elements IA(4)+1 through IA(5) contain
                                        blue values
        SL    = 0
        LSTR = ()
        STR   = ()