pset_text_rep(3g) — Subroutines

Name

pset_text_rep − Defines text attributes for a text index.

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

Syntax

void pset_text_rep (
Pint                  wsid,    /∗ (I) Workstation identifier ∗/
Pint                  index,   /∗ (I) Text index ∗/
const Ptext_bundle   ∗rep      /∗ (I) 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 ∗/
    Pint        colr_ind;       /∗ text color index ∗/
} Ptext_bundle;
    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;

Description

pset_text_rep associates the value of the text index with the text font, text precision, character expansion factor, character spacing, and text color index values in the text bundle table. This table is in the workstation state list for the workstation specified by the workstation identifier.

This function allows you to define or redefine a set of text attributes for a specified text index. (You can also set these attributes individually; see the individual SET functions.) The following table describes the attributes specified in this function:

Text Attribute       Description
--------------------------------------------------------------------------
Text font            Selects the specified font on the workstation.
Text precision       Controls how closely the displayed characters adhere
                     to the other specified text attributes. In order of
                     increasing fidelity, the possible values are STRING,
                     CHAR, and STROKE. A STRING value evaluates character
                     height and width attributes only; this is the default
                     precision value. A CHAR value evaluates each character
                     for compliance with all other specified text
                     attributes. A STROKE value looks for exact compliance
                     with all specified text attributes.
Character expansion Controls the width of the character by specifying the
factor               deviation of the nominal width-to-height ratio, as
                     defined in the font design.
Character spacing    Specifies how much space will appear between two
                     adjacent characters. Digital PHIGS specifies character
                     spacing as a fraction of the font’s nominal character
                     height.
Character color      Provides an index into the color table of the
index                workstation.
--------------------------------------------------------------------------

Digital PHIGS provides predefined entries for the text bundle tables for every OUTPUT and OUTIN category workstation. Digital PHIGS maintains entry values in the workstation state list.

When Digital PHIGS displays text or annotation text, the current text index entry in the PHIGS traversal state list refers to an entry in the text bundle table, if it is present. If the entry is not present in the table, Digital PHIGS uses the default index. The setting of the corresponding ASF (BUNDLED or INDIVIDUAL) determines which attributes are bound to the primitive for display at traversal time.

Not all workstations can recognize all text attribute values; Digital PHIGS provides default values. See the appropriate workstation-specific chapters in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS for more information.

Museum

pset_text_rep(3g) — Subroutines

Name

Syntax

Data Structures

Description

See Also