GSCHUP

GDDM-GKS V1R1 Programming Guide and Reference

GSCHUP

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GSCHUP	(chux, chuy)

APL code	1332
GKS RCP code	X'38002000' (939532288)

Function: To set character up vector.

Attribute function. Establishes an up direction for text string primitive output.

Parameters

chux (specified by user) (short floating point)

chuy (specified by user) (short floating point)
The x and y values for the character up vector in world coordinates.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set text font and precision (GSTXFP), Inquire character up vector (GQCHUP), Inquire character base vector (GQCHB)

Description

This function defines the up direction for text string primitive output by a vector from the origin (0,0) to the point (chux, chuy). The "current character up vector" entry in the GKS state list is set to the value specified. The entry "current character base vector" is set to a vector at right angles, in the clockwise direction, to the character up vector.

If you do not set the character up vector in your program before calling the Text (GTXS) function, a default (0,1) is used.

The operation of this function depends on the text mode (string, character, or stroke precision). For string precision, the character up vector is not used. For character precision, the vector is used to determine the position of each character but the characters themselves are drawn without rotation. For stroke precision, the attribute is evaluated exactly and the characters are rotated so as to be normal to the character base vector, as in the following illustration, where the string is displayed with four different character up vectors.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
79: Length of character up vector is zero

Notices | Terms of use | Support | Contact z/OS