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 PWRZ was supported. PWRZ
10 has been superseded by PWRZT and is therefore considered obsolete. If
11 you call PWRZ, you will get an error message telling you to use PWRZT
12 instead and execution will be terminated.
13
15 CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)
16
18 #include <ncarg/ncargC.h>
19 void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
21 int isize, int idir, int itop, int icen)
22
24 U,V,W (input expressions of type REAL) are the U, V, and W
25 coordinates of a point, in the user's 3-space, relative to
26 which the character string is to be positioned.
27 CHRS (an input constant or variable of type CHARACTER) is the
29 character string to be drawn. It may contain uppercase
30 alphabetic characters, the digits 0 through 9, and a small
31 set of "special" characters (plus, minus, asterisk, slash,
32 left and right parentheses, equals sign, blank, comma, and
33 period). Other characters are treated as blanks. (Note
34 especially that lowercase alphabetic characters are not
35 available.)
36 LCHRS (an input expression of type INTEGER) is the number of
38 characters in CHRS.
39 ISIZE (an input expression of type INTEGER) specifies the
41 character width to be used, defined in terms of the width
42 of the plotter frame. Because projected characters vary in
43 width depending on just where they are placed within the
44 box being viewed and the position from which that box is
45 viewed, ISIZE is interpreted as specifying the width of a
46 character when that character is positioned and viewed in
47 such a way as to make it as large as it could possibly be -
48 when the character is on the near side of the box and in a
49 plane perpendicular to the line of sight. Specifically,
50 If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a
52 standard width equal to 1/128th of the screen width.
53 If greater than 3, ISIZE is the character width in
55 units of 1/1024th of the plotter frame.
56 One third of the "width" referred to here is white space.
58 What ISIZE really specifies is the distance between the
59 centers of adjacent characters in a string. Characters are
60 digitized to be 7/6 * ISIZE units high and 4/6 * ISIZE
61 units wide, excluding white space.
62 IDIR (an input expression of type INTEGER) is the direction in
64 which the character string is to be written, as follows:
65 1 = +U -1 = -U
67 2 = +V -2 = -V
69 3 = +W -3 = -W
71 ITOP (an input expression of type INTEGER) is the direction from
73 the center of the first character to the top of the first
74 character; possible values of ITOP are the same as those of
75 IDIR, above. ABS(ITOP) must not be equal to ABS(IDIR).
76 ICEN (an input expression of type INTEGER) is the centering
78 option, specifying where (U,V,W) is relative to the string
79 written, as follows:
80 -1 (U,V,W) is the center of the left edge of the first
82 character.
83 0 (U,V,W) is the center of the entire string.
85 1 (U,V,W) is the center of the right edge of the last
87 character.
88 Because characters drawn by PWRZT are stroked using the GKS polyline
90 primitive (so that they can be projected from 3-D to 2-D), they are
91 drawn in the current polyline color, as determined by the last call to
92 the GKS routine GSPLCI; by default, color index 1 is used. Line width
93 is determined by the last call to the GKS routine GSLWSC; by default,
94 the line width scale factor is 1.
95
97 The C-binding argument descriptions are the same as the FORTRAN
98 argument descriptions.
99
101 Use the ncargex command to see the following relevant example: tpwrzt.
102
104 To use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg,
105 ncarg_gks, and ncarg_c, preferably in that order.
106
108 Online: threed, curve3, fence3, frst3, line3, perim3, point3, psym3,
109 pwrz, set3, threed, tick3, tick43, vect3, ncarg_cbind.
110
112 Copyright (C) 1987-2007
113 University Corporation for Atmospheric Research
114 This documentation is free software; you can redistribute it and/or
116 modify it under the terms of the GNU General Public License as
117 published by the Free Software Foundation; either version 2 of the
118 License, or (at your option) any later version.
119 This software is distributed in the hope that it will be useful, but
121 WITHOUT ANY WARRANTY; without even the implied warranty of
122 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
123 General Public License for more details.
124 You should have received a copy of the GNU General Public License along
126 with this software; if not, write to the Free Software Foundation,
127 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
128UNIX March 1993 PWRZT(3NCARG)