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

NAME

6       PWRZT - Draws the projections of character strings that are positioned
7       in a plane parallel to one of the three coordinate planes.
8

SYNOPSIS

10       CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
16       int isize, int idir, int itop, int icen)
17

DESCRIPTION

19       U,V,W       (input expressions of type REAL) are the U, V, and W
20                   coordinates of a point, in the user's 3-space, relative to
21                   which the character string is to be positioned.
22
23       CHRS        (an input constant or variable of type CHARACTER) is the
24                   character string to be drawn.  It may contain uppercase
25                   alphabetic characters, the digits 0 through 9, and a small
26                   set of "special" characters (plus, minus, asterisk, slash,
27                   left and right parentheses, equals sign, blank, comma, and
28                   period).  Other characters are treated as blanks.  (Note
29                   especially that lowercase alphabetic characters are not
30                   available.)
31
32       LCHRS       (an input expression of type INTEGER) is the number of
33                   characters in CHRS.
34
35       ISIZE       (an input expression of type INTEGER) specifies the
36                   character width to be used, defined in terms of the width
37                   of the plotter frame.  Because projected characters vary in
38                   width depending on just where they are placed within the
39                   box being viewed and the position from which that box is
40                   viewed, ISIZE is interpreted as specifying the width of a
41                   character when that character is positioned and viewed in
42                   such a way as to make it as large as it could possibly be -
43                   when the character is on the near side of the box and in a
44                   plane perpendicular to the line of sight.  Specifically,
45
46                       If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a
47                       standard width equal to 1/128th of the screen width.
48
49                       If greater than 3, ISIZE is the character width in
50                       units of 1/1024th of the plotter frame.
51
52                   One third of the "width" referred to here is white space.
53                   What ISIZE really specifies is the distance between the
54                   centers of adjacent characters in a string.  Characters are
55                   digitized to be 7/6 * ISIZE units high and 4/6 * ISIZE
56                   units wide, excluding white space.
57
58       IDIR        (an input expression of type INTEGER) is the direction in
59                   which the character string is to be written, as follows:
60
61                       1 = +U    -1 = -U
62
63                       2 = +V    -2 = -V
64
65                       3 = +W    -3 = -W
66
67       ITOP        (an input expression of type INTEGER) is the direction from
68                   the center of the first character to the top of the first
69                   character; possible values of ITOP are the same as those of
70                   IDIR, above.  ABS(ITOP) must not be equal to ABS(IDIR).
71
72       ICEN        (an input expression of type INTEGER) is the centering
73                   option, specifying where (U,V,W) is relative to the string
74                   written, as follows:
75
76                   -1  (U,V,W) is the center of the left edge of the first
77                       character.
78
79                    0  (U,V,W) is the center of the entire string.
80
81                    1  (U,V,W) is the center of the right edge of the last
82                       character.
83
84       Because characters drawn by PWRZT are stroked using the GKS polyline
85       primitive (so that they can be projected from 3-D to 2-D), they are
86       drawn in the current polyline color, as determined by the last call to
87       the GKS routine GSPLCI; by default, color index 1 is used. Line width
88       is determined by the last call to the GKS routine GSLWSC; by default,
89       the line width scale factor is 1.
90

C-BINDING DESCRIPTION

92       The C-binding argument descriptions are the same as the FORTRAN
93       argument descriptions.
94

EXAMPLES

96       Use the ncargex command to see the following relevant examples: tpwrzt,
97       fthex01, fthex02, fthex03, fthex04, fthex05.
98

ACCESS

100       To use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg,
101       ncarg_gks, and ncarg_c, preferably in that order.
102

SEE ALSO

104       Online: threed, curve3, fence3, frst3, line3, perim3, point3, psym3,
105       pwrz, set3, threed, tick3, tick43, vect3, ncarg_cbind.
106
107       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
108
110       Copyright (C) 1987-2009
111       University Corporation for Atmospheric Research
112       The use of this Software is governed by a License Agreement.
113
114
115
116UNIX                              March 1993                     PWRZT(3NCARG)
Impressum