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-2007
70       University Corporation for Atmospheric Research
71
72       This documentation is free software; you  can  redistribute  it  and/or
73       modify  it  under  the  terms of the GNU General Public License as pub‐
74       lished by the  Free  Software  Foundation;  either  version  2  of  the
75       License, or (at your option) any later version.
76
77       This  software  is  distributed in the hope that it will be useful, but
78       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
79       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
80       Public License for more details.
81
82       You should have received a copy of the GNU General Public License along
83       with  this  software;  if  not,  write to the Free Software Foundation,
84       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
85
86
87
88UNIX                              March 1993          GSET_CHAR_UP_VEC(3NCARG)
Impressum