pinq_colr_map_rep(3g) — Subroutines

Name

pinq_colr_map_rep − Returns color mapping information associated with an index.

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

Syntax

void pinq_colr_map_rep (
Pint             wsid,      /∗ (I) Workstation identifier. ∗/
Pint             index,     /∗ (I) Color mapping index. ∗/
Pinq_type        type,      /∗ (I) Type of returned values. ∗/
Pstore           store,     /∗ (I) Handle to store the object. store
                                     manages the memory referenced by
                                     ∗rep. ∗/
Pint            ∗error_ind, /∗ (O) Error indicator. ∗/
Pcolr_map_rep ∗∗rep        /∗ (O) Color mapping representation. ∗/
)

Data Structures

typedef enum {
    PINQ_SET,        /∗ Use the exact state list values. ∗/
    PINQ_REALIZED    /∗ Use the values approximated by the graphics
                        handler. ∗/
} Pinq_type;
typedef void ∗Pstore;
typedef struct {
    Pint     method;   /∗ color mapping method ∗/
    union Pcolr_map_rep_data {
        struct Pcolr_map_rep_pseudo {
            Pint            model;              /∗ color model ∗/
            Pfloat_list     weight_vector;      /∗ list of weight
                                                   vectors ∗/
            Pcolrv_list    colrs;              /∗ list of color values ∗/
        } pseudo;
        struct Pcolr_map_rep_pseudo_N {
            Pint            model;              /∗ color model ∗/
            Pfloat_set      colrs;              /∗ list of lists of color
                                                   coordinates ∗/
        } pseudo_N;
    } data;
} Pcolr_map_rep;

    typedef struct {
        Pint      num_floats;   /∗ number of floats in list ∗/
        Pfloat   ∗floats;       /∗ list of floats ∗/
    } Pfloat_list;
    typedef struct {
        Pint          num_colrs;   /∗ number of colors ∗/
        Pcolrv_ptr    colrs;       /∗ list of color values ∗/
    } Pcolrv_list;
        typedef union {
            Pint            ∗colr_inds;   /∗ pointer to color indexes ∗/
            Pcolr_rep_ptr    colr_reps;   /∗ pointer to color
                                             representations ∗/
        } Pcolrv_ptr;
            typedef union {
                Prgb     ∗rgb;      /∗ pointer to RGB color values ∗/
                Pcieluv ∗cieluv;   /∗ pointer to CIELUV color values ∗/
                Phls     ∗hls;      /∗ pointer to HLS color values ∗/
                Phsv     ∗hsv;      /∗ pointer to HSV color values ∗/
                Pdata    ∗unsupp;   /∗ pointer to unsupported color
                                       values ∗/
            } Pcolr_rep_ptr;
                typedef struct {
                    Pfloat    red;     /∗ red intensity ∗/
                    Pfloat    green;   /∗ green intensity ∗/
                    Pfloat    blue;    /∗ blue intensity ∗/
                } Prgb;
                typedef struct {
                    Pfloat    cieluv_x;      /∗ x coefficient ∗/
                    Pfloat    cieluv_y;      /∗ y coefficient ∗/
                    Pfloat    cieluv_y_lum; /∗ y luminance ∗/
                } Pcieluv;
                typedef struct {
                    Pfloat    hue;         /∗ hue ∗/
                    Pfloat    lightness;   /∗ lightness ∗/
                    Pfloat    satur;       /∗ saturation ∗/
                } Phls;
                typedef struct {
                    Pfloat    hue;      /∗ hue ∗/
                    Pfloat    satur;    /∗ saturation ∗/
                    Pfloat    value;    /∗ value ∗/
                } Phsv;
                typedef struct {
                    size_t    size;     /∗ size of data ∗/
                    void     ∗data;     /∗ pointer to the data ∗/
                } Pdata;
    typedef struct {
        Pint           num_lists;   /∗ number of float lists ∗/
        Pfloat_list   ∗floats;      /∗ list of float lists ∗/
    } Pfloat_set;

Constants

Data Structure Constants    Constant                    Description
---------------------------------------------------------------------------
Color mapping method        PCOLR_MAP_METHOD_TRUE       Digital PHIGS
                                                        performs the
                                                        identity mapping.
                            PCOLR_MAP_METHOD_PSEUDO     Digital PHIGS
                                                        converts the colors
                                                        to a single integer
                                                        index.
                            PCOLR_MAP_METHOD_PSEUDO_N   Digital PHIGS
                                                        converts the colors
                                                        to a set of
                                                        indexes.
---------------------------------------------------------------------------

Description

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

Digital PHIGS Version 4.1 does not support this function.