1GSET_CHAR_UP_VEC(3NCARG)         NCAR GRAPHICS        GSET_CHAR_UP_VEC(3NCARG)
2
3
4

NAME

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

SYNOPSIS

10       #include <ncarg/gks.h>
11
12       void gset_char_up_vec(const Gvec *char_up_vec);
13

DESCRIPTION

15       char_up_vec.delta_x
16                   (Gfloat, Input) - Gives the X (horizontal) world coordinate
17                   of a vector.
18
19       char_up_vec.delta_y
20                   (Gfloat,  Input)  - Gives the Y (vertical) world coordinate
21                   of a vector.
22

USAGE

24       The coordinates (char_up_vec.delta_x, char_up_vec.delta_y) relative  to
25       the point (0.,0.)  establish a vector direction.  This direction speci‐
26       fies the up direction of individual characters.   This  direction  also
27       specifies  the orientation of a text string in that the characters in a
28       string are placed along a line perpendicular to the character  up  vec‐
29       tor.   By default the character up vector is (0.,1.) so that characters
30       are drawn in their normal horizontal orientation.  The magnitude of the
31       up vector is not used so that (0.,23.) is the same as (0.,1.).
32

EXAMPLES

34             char_up_vec.delta_x = -1.
35             char_up_vec.delta_y = 0.
36             gset_char_up_vec(&char_up_vec);
37
38       would  specify  the character up vector as (-1.,0.) and subsequent text
39       written with gtext would be rotated 90 degrees from normal and would be
40       appropriate for a Y-axis label.
41
42
43             char_up_vec.delta_x = 1.
44             char_up_vec.delta_y = 1..
45             gset_char_up_vec(&char_up_vec);
46
47       would  specify  the  character up vector as (1.,1.) and subsequent text
48       written with gtext would be rotated -45 degress from normal.
49

ACCESS

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

SEE ALSO

55       Online: gtext(3NCARG), gset_text_path(3NCARG), gset_text_align(3NCARG),
56       gset_text_font_prec(3NCARG),                      gset_char_ht(3NCARG),
57       gset_char_space(3NCARG),                       gset_char_expan(3NCARG),
58       gset_colr_rep(3NCARG),                      gset_text_colr_ind(3NCARG),
59       ginq_text_path(3NCARG),                        ginq_text_align(3NCARG),
60       ginq_text_font_prec(3NCARG),                      ginq_char_ht(3NCARG),
61       ginq_char_space(3NCARG),                      ginq_char_up_vec(3NCARG),
62       ginq_char_expan(3NCARG),         plotchar(3NCARG),         gks(3NCARG),
63       ncarg_gks_cbind(3NCARG)
64
65       Hardcopy:  User's  Guide for NCAR GKS-0A Graphics; NCAR Graphics Funda‐
66       mentals, UNIX Version
67

69       Copyright (C) 1987-2009
70       University Corporation for Atmospheric Research
71       The use of this Software is governed by a License Agreement.
72
73
74
75UNIX                              March 1993          GSET_CHAR_UP_VEC(3NCARG)
Impressum