PQPCMR(3g) — Subroutines

Name

PQPCMR − Returns predefined color mapping type and color data for the index.

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

Syntax

PQPCMR (WTYPE, PCMI, MLDR, ERRIND, CMM, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
PCMI              Integer        Read      Predefined color mapping index
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
---------------------------------------------------------------------------
CMTYP                  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

PQPCMR queries the workstation description table and returns the color mapping type and color data for the specified index.

Digital PHIGS Version 3.1 does not support this function.

Data Record Information

If CMTYP is PTRUE, there is no data record.

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