pinq_text_rep_plus(3g) — Subroutines

Name

pinq_text_rep_plus − Returns extended text representation information.

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

Syntax

void pinq_text_rep_plus (
Pint                 wsid,          /∗ (I) Workstation identifier ∗/
Pint                 index,         /∗ (I) Text index ∗/
Pinq_type            return_type,   /∗ (I) Type of returned values ∗/
Pint                ∗error_ind,     /∗ (O) Error indicator ∗/
Ptext_bundle_plus   ∗rep            /∗ (O) Extended text represen-
                                             tation ∗/
)

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 ∗/
    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

pinq_text_rep_plus returns information on the extended text representation, including the text font and precision, character expansion factor, character spacing, and text color.