pe_set_highl_rep(3g) — Subroutines

Name

pe_set_highl_rep − Associates a highlight index with various highlighting information.

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

Syntax

void pe_set_highl_rep (
Pint             wsid,         /∗ (I) Workstation identifier ∗/
Pint             index,        /∗ (I) Highlight index to modify ∗/
Phigh_method     high_meth,    /∗ (I) Highlight method ∗/
Phighl_rec      ∗high_val      /∗ (I) Data record for the highlight
                                        method ∗/
)

Data Structures

typedef enum {
    PHIGH_METHOD_DEFAULT,      /∗ Highlight with workstation-dependent
                                  default method. ∗/
    PHIGH_METHOD_INTENSITY,    /∗ Highlight with varying intensity. ∗/
    PHIGH_METHOD_BLINK,        /∗ Highlight with blinking. ∗/
    PHIGH_METHOD_COLOUR,       /∗ Highlight with changing color. This does
                                  not override interior and back interior
                                  color specifications. ∗/
    PHIGH_METHOD_FCOLOUR,     /∗ Highlight with forced color. This
                                  overrides interior and back interior
                                  color specifications. ∗/
    PHIGH_METHOD_COMP,         /∗ Highlight with complement mode. ∗/
    PHIGH_METHOD_LINE,         /∗ Highlight with extent line box. ∗/
    PHIGH_METHOD_FILL,         /∗ Highlight with extent fill area. ∗/
    PHIGH_METHOD_DUAL          /∗ Highlight with extent line box and fill
                                  area. ∗/
} Phigh_method;
typedef union {
    Pint               color_index;
    Pfloat             intensity_scale_factor;
    Pfloat             blink_rate;
    Phigh_rec_line     high_rec_line;
    Phigh_rec_fill     high_rec_fill;
    Phigh_rec_dual     high_rec_dual;
} Phighl_rec;
    typedef struct {
        Pint        line_type;
        Pfloat      line_width;
        Pfloat      expan_extent;
    } Phigh_rec_line;
    typedef struct {
        Pint_style int_style;
        Pint        int_style_index;
        Pfloat      expan_extent;
    } Phigh_rec_fill;
        typedef enum {
            PSTYLE_HOLLOW,     /∗ Hollow interior. This is the default
                                  value. ∗/
            PSTYLE_SOLID,      /∗ Solid interior. ∗/
            PSTYLE_PAT,        /∗ Patterned interior .∗/
            PSTYLE_HATCH,      /∗ Hatched interior. ∗/
            PSTYLE_EMPTY       /∗ Empty interior. ∗/
        } Pint_style;
    typedef struct {
        Pint         line_type;
        Pfloat       line_width;
        Pint_style   int_style;
        Pint         int_style_index;
        Pfloat       expan_extent;
    } Phigh_rec_dual;

Constants

Data Structure Constants    Constant         Description
---------------------------------------------------------------------------
Line types                  PLN_SOLID        Solid line. This is the
                                             default value.
                            PLN_DASH         Dashed line.
                            PLN_DOT          Dotted line.
                            PLN_DOTDASH      Dotted-dashed line.
---------------------------------------------------------------------------

Other, nonstandard line types are available. See Constants.

Description

pe_set_highl_rep associates a highlight index with the following related highlighting criteria, and sets the representation in the workstation state list:

•Highlight method

•Highlight record

•Highlight size

Digital PHIGS associates each highlight index in the table of defined highlight representations entry with the parameters specified for that index.

During structure traversal, the current highlight index in the PHIGS traversal state list refers to an entry in the table of defined highlight representations.

If the specified highlight method is not available on a workstation, Digital PHIGS uses highlight method 0.