SET CHARACTER UP VECTOR(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetcharup ( up_vect )
Pvector∗up_vect;character up vector

FORTRAN Syntax

SUBROUTINE pschup ( CHUX, CHUY )
REALCHUX, CHUYcharacter up vector (TLC)

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, 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, 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 {
Pfloat x;/∗ x coordinate ∗/
Pfloat y;/∗ y coordinate ∗/
} Pvector;

FORTRAN Parameters

CHUXThe character up vector x component.

CHUYThe character up vector y component.

Execution

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

ERRORS

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

Museum