1PWRZS(3NCARG)                    NCAR GRAPHICS                   PWRZS(3NCARG)
2
3
4

NAME

6       PWRZS - A character-plotting routine for plotting characters in three-
7       space when using SRFACE.
8

SYNOPSIS

10       CALL PWRZS (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)
11

C-BINDING SYNOPSIS

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

DESCRIPTION

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

C-BINDING DESCRIPTION

61       The C-binding argument descriptions are the same as the FORTRAN
62       argument descriptions.
63

USAGE

65       Call PWRZS after calling SRFACE and before calling FRAME.
66

EXAMPLES

68       Use the ncargex command to see the following relevant examples:
69       fsrpwrzs, tpwrzs.
70

ACCESS

72       To use PWRZS or c_pwrzs, load the NCAR Graphics libraries ncarg,
73       ncarg_gks, and ncarg_c, preferably in that order.
74

SEE ALSO

76       Online: surface, surface_params, ezsrfc, setr, srface.  ncarg_cbind.
77
78       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
79

81       Copyright (C) 1987-2007
82       University Corporation for Atmospheric Research
83
84       This documentation is free software; you can redistribute it and/or
85       modify it under the terms of the GNU General Public License as
86       published by the Free Software Foundation; either version 2 of the
87       License, or (at your option) any later version.
88
89       This software is distributed in the hope that it will be useful, but
90       WITHOUT ANY WARRANTY; without even the implied warranty of
91       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
92       General Public License for more details.
93
94       You should have received a copy of the GNU General Public License along
95       with this software; if not, write to the Free Software Foundation,
96       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
97
98
99
100UNIX                              March 1993                     PWRZS(3NCARG)
Impressum