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 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

SYNOPSIS

15       CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)
16

C-BINDING SYNOPSIS

18       #include <ncarg/ncargC.h>
19
20       void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
21       int isize, int idir, int itop, int icen)
22

DESCRIPTION

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
28       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
37       LCHRS       (an input expression of type INTEGER) is the number of
38                   characters in CHRS.
39
40       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
51                       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
54                       If greater than 3, ISIZE is the character width in
55                       units of 1/1024th of the plotter frame.
56
57                   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
63       IDIR        (an input expression of type INTEGER) is the direction in
64                   which the character string is to be written, as follows:
65
66                       1 = +U    -1 = -U
67
68                       2 = +V    -2 = -V
69
70                       3 = +W    -3 = -W
71
72       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
77       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
81                   -1  (U,V,W) is the center of the left edge of the first
82                       character.
83
84                    0  (U,V,W) is the center of the entire string.
85
86                    1  (U,V,W) is the center of the right edge of the last
87                       character.
88
89       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

C-BINDING DESCRIPTION

97       The C-binding argument descriptions are the same as the FORTRAN
98       argument descriptions.
99

EXAMPLES

101       Use the ncargex command to see the following relevant example: tpwrzt.
102

ACCESS

104       To use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg,
105       ncarg_gks, and ncarg_c, preferably in that order.
106

SEE ALSO

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