Name

pinq_text_rep − Returns text representation information. 

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

Syntax

void pinq_text_rep (
  Pint            wsid,          /∗ (I) Workstation identifier ∗/
  Pint            index,         /∗ (I) Text index ∗/
  Pinq_type       return_type,   /∗ (I) Type of the returned values ∗/
  Pint           ∗error_ind,     /∗ (O) Error indicator ∗/
  Ptext_bundle   ∗rep            /∗ (O) Text representation ∗/
)

Data Structures

typedef enum {
    PINQ_SET,        /∗ Use the exact state list values. ∗/
    PINQ_REALIZED    /∗ Use the values approximated by the graphics
                        handler. ∗/
} Pinq_type;
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

pinq_text_rep queries the workstation state list and, for the specified text index, returns values for the following:

•Text font and precision values

•Character expansion factor

•Character spacing

•Text color index

If the specified text index is not in the text bundle table on the specified workstation, and the specified type of returned values is PINQ_REALIZED, Digital PHIGS returns the representation for text index 1.  (See the Device Specifics Reference Manual for DEC GKS and DEC PHIGS for workstation-specific information.) 

See Also

pinq_list_text_inds
pinq_pred_text_rep
pinq_pred_text_rep_plus
pinq_text_rep_plus
pset_text_ind
pset_text_rep
pset_text_rep_plus