pe_alt_anno_text_rel3(3g) — Subroutines

Name

pe_alt_anno_text_rel3 − Specifies a reference point for the alternative annotated text and defines an annotated offset.

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

Syntax

void pe_alt_anno_text_rel3 (
const Ppoint3    ∗ref_pt,     /∗ (I) Reference point, in modeling
                                       coordinate units ∗/
const Pvec3      ∗offset,     /∗ (I) Annotation offset, in normalized
                                       projection coordinate points ∗/
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_anno_text_rel3 specifies a reference point for the alternative annotated text (text that must appear parallel to the viewing surface) in world coordinate points, and then defines an annotated offset in normalized projection coordinates. The annotation point is the point at which Digital PHIGS places the text, which Digital PHIGS computes by adding the value of the annotation offset argument to the transformed reference point.

Depending on the text attribute source flag values, Digital PHIGS gathers the attributes -- text color, text precision, character expansion, character spacing, and text font -- from the current attribute text values or from the text bundle index attribute.

Depending on the 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 annotation text relative 3 element.

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

Museum

pe_alt_anno_text_rel3(3g) — Subroutines

Name

Syntax

Data Structures

Description

See Also