gset_char_up_vec (Set character up vector) - specifies the angle at which subsequent text is to be drawn
Contents
Access
To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.
Copyright
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX March 1993 GSET_CHAR_UP_VEC(3NCARG)
Description
char_up_vec.delta_x
(Gfloat, Input) - Gives the X (horizontal) world coordinate of a vector.
char_up_vec.delta_y
(Gfloat, Input) - Gives the Y (vertical) world coordinate of a vector.
Examples
char_up_vec.delta_x = -1.
char_up_vec.delta_y = 0.
gset_char_up_vec(&char_up_vec);
would specify the character up vector as (-1.,0.) and subsequent text written with gtext would be rotated
90 degrees from normal and would be appropriate for a Y-axis label.
char_up_vec.delta_x = 1.
char_up_vec.delta_y = 1..
gset_char_up_vec(&char_up_vec);
would specify the character up vector as (1.,1.) and subsequent text written with gtext would be rotated
-45 degress from normal.
Name
gset_char_up_vec (Set character up vector) - specifies the angle at which subsequent text is to be drawn
with gtext.
See Also
Online: gtext(3NCARG),gset_text_path(3NCARG),gset_text_align(3NCARG),gset_text_font_prec(3NCARG),gset_char_ht(3NCARG),gset_char_space(3NCARG),gset_char_expan(3NCARG),gset_colr_rep(3NCARG),gset_text_colr_ind(3NCARG),ginq_text_path(3NCARG),ginq_text_align(3NCARG),ginq_text_font_prec(3NCARG),ginq_char_ht(3NCARG),ginq_char_space(3NCARG),ginq_char_up_vec(3NCARG),ginq_char_expan(3NCARG),plotchar(3NCARG),gks(3NCARG),ncarg_gks_cbind(3NCARG)
Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version
Synopsis
#include <ncarg/gks.h>
void gset_char_up_vec(const Gvec *char_up_vec);
Usage
The coordinates (char_up_vec.delta_x, char_up_vec.delta_y) 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.).
