PSCMR(3g) — Subroutines

Name

PSCMR − Associates the color mapping index with the specified parameters.

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

Syntax

PSCMR (WKID, CMI, CMM, LDR, DATREC)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
WKID           Integer        Read      Workstation identifier
CMI            Integer        Read      Color mapping index
CMM            Integer        Read      Color mapping method
LDR            Integer        Read      Length of the data record array
DATREC(LDR)    Character ∗80 Read      Data record
---------------------------------------------------------------------------

Constants

Defined Argument       Constant        Description
---------------------------------------------------------------------------
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

PSCMR associates the color mapping index with the specified parameters.

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   = ()