pset_pat_rep_plus(3g) — Subroutines

Name

pset_pat_rep_plus − Defines a pattern table index.

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

Syntax

void pset_pat_rep_plus (
Pint                   wsid,      /∗ (I) Workstation identifier ∗/
Pint                   pat_ind,   /∗ (I) Pattern index ∗/
const Ppat_rep_plus   ∗rep        /∗ (I) Pattern representation ∗/
)

Data Structures

typedef struct {
    Pint            colr_type;     /∗ color type ∗/
    Pcolrv_array    colrs;         /∗ array of color values ∗/
} Ppat_rep_plus;
    typedef struct {
        Pint_size     dims;    /∗ color value array dimensions ∗/
        Pcolrv_ptr    colrs;   /∗ array of color values ∗/
    } Pcolrv_array;
        typedef struct {
            Pint     size_x;    /∗ x size ∗/
            Pint     size_y;    /∗ y size ∗/
        } Pint_size;
        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;

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_pat_rep_plus allows you to redefine an existing pattern table index or define a new pattern table index. This is accomplished by specifying the number of cells high, the number of cells wide, and an array containing each cell’s color index fill area, associated with the specified bundle index.

If the workstation supports the pattern interior style, the pattern table in the workstation state list predefines entries taken from the workstation description table. You can redefine any table entry using this function.

When fill areas or fill area sets are displayed during structure traversal and the interior style is PATTERN, the current interior style index in the PHIGS traversal state list refers to an entry in the pattern table. If the current interior style index is unavailable in the pattern table, PHIGS uses interior style index 1. If interior style index 1 is unavailable (interior style pattern is unsupported), the result is workstation-dependent.

If the pattern color index specified in the pattern color index array is unavailable on the workstation, PHIGS uses color index 1.

Attribute values passed to this function must be valid for the specified workstation. For information, see the appropriate device-specific chapter in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS.

Digital PHIGS Version 4.1 does not support this function.