NAME

       gset_char_up_vec  (Set character up vector) - specifies the angle at which subsequent text is to be drawn
       with gtext.

SYNOPSIS

       #include <ncarg/gks.h>

       void gset_char_up_vec(const Gvec *char_up_vec);

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.

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.).

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.

ACCESS

       To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.

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

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.