ncl_gset_char_up_vec - Man Page

#include <ncarg/gks.h>

void gset_char_up_vec(const Gvec *char_up_vec);

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.

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

      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.

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

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 (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.