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
9       NOTE: At one time, a Threed routine called PSYM3 was supported.  It has
10       long been considered obsolete.  If you call PSYM3, you will get an
11       error message telling you to use PWRZT instead and execution will be
12       terminated.
13
14       As nearly as we can determine, the statement
15
16             CALL PSYM3 (U,V,W,ICHAR,ISIZE,IDIR,ITOP,IUP)
17
18       may be replaced by the statements
19
20             IF (IUP.EQ.2) CALL VECT3 (U,V,W)
21             CALL PWRZT (U,V,W,ICHAR,1,ISIZE,IDIR,ITOP,0)
22
23       (Old manuals seem to indicate that the fifth argument in the call to
24       PSYM3 may have been a real called SIZE, rather than an integer called
25       ISIZE; it is not clear whether this was a misprint or not.)
26
27       The function of PSYM3 was to plot a symbol at the projection of a
28       particular point; this can now be done with PWRZT.  If the eighth
29       argument in the second and following of a series of calls to PSYM3 had
30       the value 2, straight-line segments were drawn connecting the
31       projections of the points; this is better done with a single call to
32       CURVE3, or by calling FRST3 for the first point and VECT3 for each of
33       the other points.
34

SYNOPSIS

36       CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)
37

C-BINDING SYNOPSIS

39       #include <ncarg/ncargC.h>
40
41       void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
42       int isize, int idir, int itop, int icen)
43

DESCRIPTION

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

C-BINDING DESCRIPTION

118       The C-binding argument descriptions are the same as the FORTRAN
119       argument descriptions.
120

EXAMPLES

122       Use the ncargex command to see the following relevant example: tpwrzt.
123

ACCESS

125       To use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg,
126       ncarg_gks, and ncarg_c, preferably in that order.
127

SEE ALSO

129       Online: threed, curve3, fence3, frst3, line3, perim3, point3, psym3,
130       pwrz, set3, threed, tick3, tick43, vect3, ncarg_cbind.
131
133       Copyright (C) 1987-2009
134       University Corporation for Atmospheric Research
135       The use of this Software is governed by a License Agreement.
136
137
138
139UNIX                              March 1993                     PWRZT(3NCARG)
Impressum