pset_marker_colr(3g) — Subroutines

Name

pset_marker_colr − Specifies the color of a polymarker.

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

Syntax

void pset_marker_colr (
const Pgcolr ∗colr /∗ Polymarker 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_marker_colr specifies the color of a polymarker. Depending on the edit mode, this function either inserts the new structure element, with the specified polymarker color, directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new set polymarker color element.

During structure traversal, Digital PHIGS sets the current polymarker color entry in the traversal state list to the value associated with the element. When the current polymarker color ASF entry in the traversal state list is INDIVIDUAL, Digital PHIGS displays subsequent polymarker output primitives using the specified value.

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