pe_alt_text3(3g) — Subroutines

Name

pe_alt_text3 − Specifies text formats other than 8-bit formats.

Operating States: PHOP, ∗, STOP, ∗
Digital PHIGS extension function
Creates a structure element

Syntax

void pe_alt_text3 (
const Ppoint3    ∗text_pos,      /∗ (I) Text position, in modeling
                                          coordinate units ∗/
const Pvec3       text_dir[2],   /∗ (I) Array of text direction vectors
                                          of length 2, in modeling
                                          coordinate units ∗/
const Palt_text ∗alt_text       /∗ (I) Character string ∗/
)

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;
typedef struct {
    Pfloat     delta_x;    /∗ delta x value ∗/
    Pfloat     delta_y;    /∗ delta y value ∗/
    Pfloat     delta_z;    /∗ delta z value ∗/
} Pvec3;
typedef struct {
    Palt_text_type   text_type;   /∗ alternative text format type ∗/
    Palt_text_ptr    text_ptr;    /∗ pointer to alternative text string ∗/
} Palt_text;
    typedef enum {
        PALT_TEXT_8_BIT,               /∗ 8-bit text ∗/
        PALT_TEXT_16_BIT_LOW_FIRST,    /∗ 16-bit text with low byte
                                          first ∗/
        PALT_TEXT_16_BIT_HIGH_FIRST,   /∗ 16-bit text with high byte
                                          first ∗/
        PALT_TEXT_DEC_KANJI            /∗ DEC KANJI (not supported on PEX
                                          workstations) ∗/
    } Palt_text_type;
    typedef union {
        Puchar    ∗one_byte;
        Pushort   ∗two_bytes;
        Puchar    ∗kanji;
    } Palt_text_ptr;

Description

pe_alt_text3 allows you to specify text formats other than 8-bit formats. Digital PHIGS supports alternative text only in STROKE precision.

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new alternative text 3 element.

The pe_alt_text3 function specifies the three-dimensional (x, y, and z) form of the text primitive. A call to this function has the following effects during structure traversal:

•Digital PHIGS generates a character string in the text position on a text plane.

The text plane and the local coordinate system, in which all geometric text attributes are measured on that plane, are defined by a point and two vectors contained in the definition of the primitive. This point is the text position. The two vectors are the first direction vector and the second direction vector. To illustrate the use of the local coordinate system, assume the following:

•P is the text position.

•U and V are the first and second text direction vectors.

•T is a vector perpendicular to U and in the text plane.

The text plane is the plane that contains P and is perpendicular to UxV. The origin of the local coordinate system is at the point P. The positive x-axis of the local coordinate system is parallel to U. If the dot product of TxV is positive, the positive y-axis is parallel to T. Otherwise, the positive y-axis is opposite T.

•Digital PHIGS binds the current values of the text 3 attributes, as defined in the PHIGS traversal state list, to the text 3 primitive.

The text precision attribute affects text clipping.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element.

Museum

pe_alt_text3(3g) — Subroutines

Name

Syntax

Data Structures

Description

See Also