Name

pe_get_req_colrs − Returns the set of fixed colors used for the workstation. 

Operating States: PHOP, WSOP, ∗, ∗
Digital PHIGS extension function

Syntax

void pe_get_req_colrs (
  Pint        wsid,           /∗ (I) Workstation identifier ∗/
  Pint        length,         /∗ (I) Minimum length of arrays ∗/
  Pint       ∗actual_length,  /∗ (O) Actual number of fixed colors ∗/
  Pcolr_rep  ∗colours,        /∗ (O) Array for fixed colors ∗/
  Pint       ∗pixels          /∗ (O) Array for pixel values ∗/
)

Data Structures

typedef union {
    Prgb        rgb;       /∗ red, green, and blue color specification ∗/
    Pcieluv     cieluv;    /∗ CIELUV color specification ∗/
    Phls        hls;       /∗ hue, lightness, and saturation color
                              specification ∗/
    Phsv        hsv;       /∗ hue, saturation, and value color
                              specification ∗/
    Pdata       unsupp;    /∗ color in an unsupported color
                              model ∗/
    int         impl_dep;  /∗ implementation-defined ∗/
} Pcolr_rep;
    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;

Description

pe_get_req_colrs returns the set of fixed colors used by Digital PHIGS for a specified workstation.  You must allocate the arrays colors and pixels prior to calling this function and must have a minimum of length elements.