ncl_gschup man page

GSCHUP (Set character up vector) — specifies the angle at which subsequent text is to be drawn with GTX.

Synopsis

CALL GSCHUP (CHUX, CHUY)

C-Binding Synopsis

#include <ncarg/gks.h>

void gset_char_up_vec(const Gvec *char_up_vec);

Description

CHUX
(Real, Input) - Gives the X (horizontal) world coordinate of a vector.
CHUY
(Real, Input) - Gives the Y (vertical) world coordinate of a vector.

Usage

The coordinates (CHUX, CHUY) relative to the point (0.,0.) establish a vector direction. This direction specifies the up direction of individual characters. This direction also specifies the orientation of a text string in that the characters in a string are placed along a line perpendicular to the character up vector. By default the character up vector is (0.,1.) so that characters are drawn in their normal horizontal orientation. The magnitude of the up vector is not used so that (0.,23.) is the same as (0.,1.).

Examples

CALL GSCHUP(-1.,0.)

would specify the character up vector as (-1.,0.) and subsequent text written with GTX would be rotated 90 degrees from normal and would be appropriate for a Y-axis label.

CALL GSCHUP(1.,1.)

would specify the character up vector as (1.,1.) and subsequent text written with GTX would be rotated -45 degress from normal.

Access

To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

See Also

Online: gtx, gstxp, gstxal, gstxfp, gschh, gschsp, gschxp, gscr, gstxci, gqtxp, gqtxal, gqtxfp, gqchh, gqchsp, gqchup, gqchxp, plotchar, gset_char_up_vec

Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS