NAME

SET CHARACTER UP VECTOR − create a structure element to set the current character up vector attribute

SYNOPSIS

C Syntax

void
pset_char_up_vec ( up_vect )
Pvec∗up_vect;character up vector

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET CHARACTER UP VECTOR creates a structure element containing a value for the current character up vector attribute, which determines the orientation of individual characters.  This attribute applies to the following output primitives:

• TEXT

• TEXT 3

If the current edit mode is INSERT, then a SET CHARACTER UP VECTOR element is inserted into the currently open structure after the element pointed to by the current element pointer.  If the edit mode is REPLACE, then the new SET CHARACTER UP VECTOR element replaces the element pointed to by the element pointer.  In either case, the element pointer is updated to point to the new element. 

C Input Parameter

up_vect
A pointer to the character up vector containing TLC values, defined as follows:

typedef struct {
Pfloatdelta_x; x coordinate
Pfloatdelta_y; y coordinate
} Pvec;

Execution

When the SET CHARACTER UP VECTOR element is traversed, the current character up vector entry in the traversal state list is set to character up vector.  Characters in text output primitives that follow in the structure network will be oriented by the character up vector.  The character base vector is defined as a vector of arbitrary length set at a right angle to the character up vector in the clockwise direction. 

The default character up vector is (0,1); the default character base vector is (1,0).  If the character up vector is determined to be degenerate (in other words, has length 0), then the defaults are used. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

SEE ALSO

SET ANNOTATION TEXT CHARACTER UP VECTOR (3P)

September 02, 1992