SET ANNOTATION TEXT CHARACTER UP VECTOR(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetannotationcharup ( up_vect )
Pvector∗up_vect;annotation text character up vector

FORTRAN Syntax

SUBROUTINE psatcu ( ATCHUX, ATCHUY )
REALATCHUX, ATCHUY annotation text character up vector (TLC)

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, which 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, a SET ANNOTATION TEXT 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, 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 {
Pfloatx;/∗ x coordinate ∗/
Pfloaty;/∗ y coordinate ∗/
} Pvector;

FORTRAN Input Parameters

ATCHUX
The annotation text character up vector x component.

ATCHUY
The annotation text character up vector y component.

Execution

When the SET ANNOTATION TEXT CHARACTER UP VECTOR element is traversed, the current annotation text character up vector entry in the PHIGS traversal state list is set to annotation text character up vector. Characters in text output primitives which follow in the structure network will be 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 (i.e. has length 0), the defaults will be used.

ERRORS

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

Museum