NAME

SET ANNOTATION TEXT CHARACTER UP VECTOR − create structure element to set the current annotation text character up vector attribute

SYNOPSIS

C Syntax

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

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET ANNOTATION TEXT CHARACTER UP VECTOR creates a structure element containing a value for the current annotation text character up vector attribute that determines the orientation of individual characters.  This attribute applies to the output primitives:

• ANNOTATION TEXT RELATIVE

• ANNOTATION TEXT RELATIVE 3

If the current edit mode is INSERT, then a SET ANNOTATION TEXT CHARACTER UP VECTOR element is inserted in the currently open structure after the element pointed to by the current element pointer.  If the edit mode is REPLACE, then the new SET ANNOTATION TEXT 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 annotation text character up vector containing TLC values, defined as follows:

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

Execution

When the SET ANNOTATION TEXT CHARACTER UP VECTOR element is traversed, the current annotation text character up vector entry in the traversal state list is set to annotation text character up vector.  Characters in text output primitives that follow in the structure network are oriented by the annotation text character up vector.  The annotation text 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 annotation text character up vector is (0,1); the default annotation text character base vector is (1,0).  If the annotation text character up vector is determined to be degenerate (in other words, has length 0), then the default is used. 

ERRORS

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

SEE ALSO

ANNOTATION TEXT RELATIVE 3 (3P)
SET CHARACTER UP VECTOR (3P)

September 02, 1992