1PWRZS(3NCARG) NCAR GRAPHICS PWRZS(3NCARG)
2
3
4
6 PWRZS - A character-plotting routine for plotting characters in three-
7 space when using SRFACE.
8
10 CALL PWRZS (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)
11
13 #include <ncarg/ncargC.h>
14
15 void c_pwrzs (float x, float y, float z, char *id,
16 int n, int isize, int line, int itop, int icnt)
17
19 X,Y,Z Positioning coordinates for the characters to be drawn.
20 These are floating point numbers in the same three-space as
21 used in SRFACE.
22
23 ID Character string to be drawn. ID is of type CHARACTER.
24
25 N The number of characters in ID.
26
27 ISIZE Size of the character:
28
29 · If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a
30 standard width equal to 1/128th of the screen width.
31
32 · If greater than 3, ISIZE is the character width in
33 plotter address units.
34
35 LINE The direction in which the characters are to be written.
36
37 1 = +X -1 = -X
38 2 = +Y -2 = -Y
39 3 = +Z -3 = -Z
40
41 ITOP The direction from the center of the first character to the
42 top of the first character (the potential values for ITOP
43 are the same as those for LINE as given above). Note that
44 LINE cannot equal ITOP even in absolute value.
45
46 ICNT Centering option.
47
48 -1 (X,Y,Z) is the center of the left edge of the first
49 character.
50
51 0 (X,Y,Z) is the center of the entire string.
52
53 1 (X,Y,Z) is the center of the right edge of the last
54 character.
55
56 Note that the hidden character problem is solved correctly
57 for characters near, but not inside, the three-space
58 object.
59
61 The C-binding argument descriptions are the same as the FORTRAN
62 argument descriptions.
63
65 Call PWRZS after calling SRFACE and before calling FRAME.
66
68 Use the ncargex command to see the following relevant examples:
69 fsrpwrzs, tpwrzs.
70
72 To use PWRZS or c_pwrzs, load the NCAR Graphics libraries ncarg,
73 ncarg_gks, and ncarg_c, preferably in that order.
74
76 Online: surface, surface_params, ezsrfc, setr, srface. ncarg_cbind.
77
78 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
79
81 Copyright (C) 1987-2009
82 University Corporation for Atmospheric Research
83 The use of this Software is governed by a License Agreement.
84
85
86
87UNIX March 1993 PWRZS(3NCARG)