pset_text_rep_plus(3g) — Subroutines

Name

pset_text_rep_plus − Modifies the entries in the extended text bundle table.

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

Syntax

void pset_text_rep_plus (
Pint                       wsid,   /∗ (I) Workstation identifier ∗/
Pint                       index, /∗ (I) Text index ∗/
const Ptext_bundle_plus   ∗rep     /∗ (I) Extended text representation ∗/
)

Data Structures

typedef struct {
    Pint        font;           /∗ text font ∗/
    Ptext_prec prec;           /∗ text precision ∗/
    Pfloat      char_expan;     /∗ character factor ∗/
    Pfloat      char_space;     /∗ character spacing ∗/
    Pgcolr      colr;           /∗ text color ∗/
} Ptext_bundle_plus;
    typedef enum {
        PPREC_STRING,   /∗ String precision. Digital PHIGS evaluates
                           character height and width attributes. ∗/
        PPREC_CHAR,     /∗ Character precision. Digital PHIGS evaluates
                           each character for compliance with all other
                           specified text attributes. ∗/
        PPREC_STROKE    /∗ Stroke precision. Digital PHIGS looks for exact
                           compliance with all specified text
                           attributes. ∗/
    } Ptext_prec;
    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_rep_plus allows you to modify the entries in the extended text bundle table in the workstation state list by defining a new index. There are five entries in the table: text font, text precision, character expansion factor, character spacing, and text color.

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

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