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

NAME

6       GSCHUP  (Set character up vector) - specifies the angle at which subse‐
7       quent text is to be drawn with GTX.
8

SYNOPSIS

10       CALL GSCHUP (CHUX, CHUY)
11

C-BINDING SYNOPSIS

13       #include <ncarg/gks.h>
14
15       void gset_char_up_vec(const Gvec *char_up_vec);
16

DESCRIPTION

18       CHUX        (Real, Input) - Gives the X (horizontal)  world  coordinate
19                   of a vector.
20
21       CHUY        (Real,  Input) - Gives the Y (vertical) world coordinate of
22                   a vector.
23

USAGE

25       The coordinates (CHUX, CHUY) relative to the point (0.,0.)  establish a
26       vector  direction.   This direction specifies the up direction of indi‐
27       vidual characters.  This direction also specifies the orientation of  a
28       text  string in that the characters in a string are placed along a line
29       perpendicular to the character up vector.  By default the character  up
30       vector is (0.,1.) so that characters are drawn in their normal horizon‐
31       tal orientation.  The magnitude of the up vector is not  used  so  that
32       (0.,23.) is the same as (0.,1.).
33

EXAMPLES

35             CALL GSCHUP(-1.,0.)
36
37       would  specify  the character up vector as (-1.,0.) and subsequent text
38       written with GTX would be rotated 90 degrees from normal and  would  be
39       appropriate for a Y-axis label.
40
41
42             CALL GSCHUP(1.,1.)
43
44       would  specify  the  character up vector as (1.,1.) and subsequent text
45       written with GTX would be rotated -45 degress from normal.
46

ACCESS

48       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
49

SEE ALSO

51       Online: gtx,  gstxp,  gstxal,  gstxfp,  gschh,  gschsp,  gschxp,  gscr,
52       gstxci, gqtxp, gqtxal, gqtxfp, gqchh, gqchsp, gqchup, gqchxp, plotchar,
53       gset_char_up_vec
54
55       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
56       mentals, UNIX Version
57

59       Copyright (C) 1987-2007
60       University Corporation for Atmospheric Research
61
62       This  documentation  is  free  software; you can redistribute it and/or
63       modify it under the terms of the GNU General  Public  License  as  pub‐
64       lished  by  the  Free  Software  Foundation;  either  version  2 of the
65       License, or (at your option) any later version.
66
67       This software is distributed in the hope that it will  be  useful,  but
68       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
69       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
70       Public License for more details.
71
72       You should have received a copy of the GNU General Public License along
73       with this software; if not, write  to  the  Free  Software  Foundation,
74       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
75
76
77
78UNIX                              March 1993                    GSCHUP(3NCARG)
Impressum