1PWRZT(3NCARG) NCAR GRAPHICS PWRZT(3NCARG)
2
6 PWRZT - Draws the projections of character strings that are positioned
7 in a plane parallel to one of the three coordinate planes.
8 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 As nearly as we can determine, the statement
15 CALL PSYM3 (U,V,W,ICHAR,ISIZE,IDIR,ITOP,IUP)
17 may be replaced by the statements
19 IF (IUP.EQ.2) CALL VECT3 (U,V,W)
21 CALL PWRZT (U,V,W,ICHAR,1,ISIZE,IDIR,ITOP,0)
22 (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 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
36 CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)
37
39 #include <ncarg/ncargC.h>
40 void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
42 int isize, int idir, int itop, int icen)
43
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 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 LCHRS (an input expression of type INTEGER) is the number of
59 characters in CHRS.
60 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 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 If greater than 3, ISIZE is the character width in
76 units of 1/1024th of the plotter frame.
77 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 IDIR (an input expression of type INTEGER) is the direction in
85 which the character string is to be written, as follows:
86 1 = +U -1 = -U
88 2 = +V -2 = -V
90 3 = +W -3 = -W
92 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 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 -1 (U,V,W) is the center of the left edge of the first
103 character.
104 0 (U,V,W) is the center of the entire string.
106 1 (U,V,W) is the center of the right edge of the last
108 character.
109 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
118 The C-binding argument descriptions are the same as the FORTRAN
119 argument descriptions.
120
122 Use the ncargex command to see the following relevant example: tpwrzt.
123
125 To use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg,
126 ncarg_gks, and ncarg_c, preferably in that order.
127
129 Online: threed, curve3, fence3, frst3, line3, perim3, point3, psym3,
130 pwrz, set3, threed, tick3, tick43, vect3, ncarg_cbind.
131
133 Copyright (C) 1987-2007
134 University Corporation for Atmospheric Research
135 This documentation is free software; you can redistribute it and/or
137 modify it under the terms of the GNU General Public License as
138 published by the Free Software Foundation; either version 2 of the
139 License, or (at your option) any later version.
140 This software is distributed in the hope that it will be useful, but
142 WITHOUT ANY WARRANTY; without even the implied warranty of
143 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
144 General Public License for more details.
145 You should have received a copy of the GNU General Public License along
147 with this software; if not, write to the Free Software Foundation,
148 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
149UNIX March 1993 PWRZT(3NCARG)