pset_text_colr(3g) — Subroutines

Name

pset_text_colr − Sets the color used to draw text and annotation text primitives.

Operating States: PHOP, ∗, STOP, ∗
PHIGS PLUS function
Creates a structure element

Syntax

void pset_text_colr (
const Pgcolr ∗colr /∗ (I) Text color ∗/
)

Data Structures

typedef struct {
    Pint     colr_type;   /∗ color type ∗/
    Pcolrv   colr_value; /∗ color value ∗/
} Pgcolr;
    typedef union {
        Pint         colr_ind;    /∗ color index ∗/
        Pcolr_rep    colr_rep;    /∗ color representation ∗/
    } Pcolrv;
        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;

Constants

Data Structure Constants     Constant         Description
---------------------------------------------------------------------------
Color types                  PCOLR_INDIRECT   Indirect (indexed) color
                             PCOLR_RGB        Direct specification of red,
                                              green, and blue
                             PCOLR_CIELUV     Direct specification in the
                                              format of the Commission
                                              Internationale de l’Eclairage
                             PCOLR_HSV        Direct specification of hue,
                                              saturation, and value
                             PCOLR_HLS        Direct specification of hue,
                                              lightness, and saturation
---------------------------------------------------------------------------

Description

pset_text_colr sets the text color Digital PHIGS uses to draw text and annotation text primitives by setting the text color attribute to be either an indexed color or a direct color value, depending on the color type attribute value. Depending on the edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new set text color element.

During structure traversal, Digital PHIGS sets the current text color entry in the traversal state list to the value associated with the element. When the current text color ASF entry in the traversal state list is INDIVIDUAL, Digital PHIGS uses the current text color value to display subsequent text and annotation text output primitives.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element.