Name

pset_char_up_vec − Defines the character up vector in terms of x- and y-text local coordinates. 

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

Syntax

void pset_char_up_vec (
  const Pvec  ∗up_vec   /∗ (I) Character up vector in text local
                               coordinates, whose unit size is unscaled
                               from modeling coordinates.  The default
                               value is (0.0, 1.0). ∗/
)

Data Structures

typedef struct {
    Pfloat     delta_x;    /∗ delta x value ∗/
    Pfloat     delta_y;    /∗ delta y value ∗/
} Pvec;

Description

pset_char_up_vec uses a value composed of a set of x- and y-text local coordinate values to define the character up vector (upward direction) of characters in a text string.  For text primitives, the text local coordinate system has unit size unscaled from modeling coordinates. 

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 set character up vector element. 

During structure traversal, the set character up vector element sets the current character up vector entry in the PHIGS traversal state list to the specified value.  Digital PHIGS binds this value to subsequently traversed text and text 3 primitives.  Digital PHIGS sets the current character base vector entry to a vector of arbitrary length.  Digital PHIGS sets the vector at right angles (in the clockwise direction) to the value of the set character up vector entry. 

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

See Also

pinq_text_extent
pinq_text_facs
pset_anno_char_up_vec
ptext
ptext3