pset_marker_rep_plus(3g) — Subroutines

Name

pset_marker_rep_plus − Modifies the entries in the extended polymarker bundle table.

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

Syntax

void pset_marker_rep_plus (
Pint                         wsid,   /∗ (I) Workstation identifier ∗/
Pint                         index, /∗ (I) Polymarker index ∗/
const Pmarker_bundle_plus   ∗rep     /∗ (I) Extended polymarker
                                              representation ∗/
)

Data Structures

typedef struct {
    Pint        type;   /∗ marker type ∗/
    Pfloat      size;   /∗ marker size scale factor ∗/
    Pgcolr      colr;   /∗ polymarker color ∗/
} Pmarker_bundle_plus;
    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
---------------------------------------------------------------------------
Marker types               PMARKER_DOT        Dot marker.
                           PMARKER_PLUS       Plus marker.
                           PMARKER_ASTERISK   Asterisk marker. This is the
                                              default value.
                           PMARKER_CIRCLE     Circle marker.
                           PMARKER_CROSS      Diagonal cross marker.
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.
---------------------------------------------------------------------------

Other, nonstandard marker types are available. See Constants.

Description

pset_marker_rep_plus allows you to modify the entries in the llows you to modify the entries in the extended polymarker bundle table in the workstation state list by defining a new index. There are three entries in the table: marker type, marker size scale factor, and polymarker color.

The extended polymarker bundle table in the workstation state list has predefined entries taken from the workstation description table. A number of these entries are predefined for every workstation of category OUTPUT and OUTIN. You can redefine any table entry using this function, including predefined entries.

When Digital PHIGS displays polymarkers during structure traversal, the current polymarker index entry in the PHIGS PLUS traversal state list refers to an entry in the extended polymarker bundle table. If the current polymarker index is not present in the extended polymarker bundle table, Digital PHIGS uses polymarker index 1. The setting of the corresponding ASF determines which of the aspects in an entry Digital PHIGS uses.

During structure traversal, if the current polymarker index does not exist in the extended table, Digital PHIGS uses polymarker index 1.