Purpose
Use Set Character Up Vector to insert a Set Character Up Vector structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Set Character Up Vector structure element, depending on the current edit mode.
During structure traversal, this structure element sets the current character up vector in the graPHIGS traversal state list to the specified value. The base vector entry is reset to the vector that is obtained by rotating the up vector 90 degrees clockwise.
The character up vector specifies the direction of the font coordinate y-axis within the text reference coordinate system. The character base vector specifies the direction of the font coordinate x-axis within the text reference coordinate system.
At structure traversal time, this structure element specifies the y-axis direction of the text coordinate system for characters in a text string that the graPHIGS API uses to render all subsequent geometric text primitives. The character up vector is a two-dimensional vector on the text plane specified by the text primitive. When rendering text primitives, the graPHIGS API uses the character up value along with a default annotation base vector set at right angles in the clockwise direction to the character up value.
The traversal default value for character up vector is 0.0, 1.0 and the traversal default value for character base vector is 1.0, 0.0.
If the character up vector is invalid, then the up vector value defaults to 0.0, 1.0 and the base vector value defaults to 1.0, 0.0.
The graPHIGS API normalizes the specified vector. If the application later inquires the content of this structure element, then the graPHIGS API returns the normalized vector, not the original vector specified by this subroutine.
Language Bindings
| pset_char_up_vec (char_up_vec) |
| PSCHUP (chux, chuy) |
Errors
Related Subroutines