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

NAME

6       PWRZI - A character-plotting routine for plotting characters in three-
7       space when using Isosurface.  For a large class of possible positions,
8       the hidden character problem is solved.
9

SYNOPSIS

11       SUBROUTINE PWRZI (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       void c_pwrzi (float x, float y, float z, char *id, int n,
17       int isize, int line, int itop, int icnt)
18

DESCRIPTION

20       X,Y,Z       (input expressions of type REAL) are positioning
21                   coordinates for the characters to be drawn.  These are
22                   floating point numbers in the same three-space coordinate
23                   system as that used in Isosurface.
24
25       ID          (an input expression of type CHARACTER) is the character
26                   string to be drawn.
27
28       N           (an input expression of type INTEGER) is the number of
29                   characters in ID.
30
31       ISIZE       (an input expression of type INTEGER) specifies the size of
32                   the characters to be used:
33
34                   · If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a
35                     standard width equal to 1/128th of the screen width.
36
37                   · If greater than 3, ISIZE is the character width in
38                     plotter address units (by default, 1/1024th of the screen
39                     width).
40
41       LINE        (an input expression of type INTEGER) specifies the
42                   direction in which the characters are to be written.
43
44                   +1 = +X
45                   -1 = -X
46                   +2 = +Y
47                   -2 = -Y
48                   +3 = +Z
49                   -3 = -Z
50
51       ITOP        (an input expression of type INTEGER) specifies the
52                   direction from the center of the first character to the top
53                   of the first character (the potential values for ITOP are
54                   the same as those for LINE as given above). Note that LINE
55                   cannot equal ITOP even in absolute value.
56
57       ICNT        (an input expression of type INTEGER) is the centering
58                   option:
59
60                   -1  (X,Y,Z) is the center of the left edge of the first
61                       character.
62
63                   +0  (X,Y,Z) is the center of the entire string.
64
65                   +1  (X,Y,Z) is the center of the right edge of the last
66                       character.
67

C-BINDING DESCRIPTION

69       The C-binding argument descriptions are the same as the FORTRAN
70       argument descriptions.
71

USAGE

73       Call PWRZI after calling ISOSRF and before calling FRAME.
74

EXAMPLES

76       Use the ncargex command to see the following relevant examples: tpwrzi,
77       fsrpwrzs.
78

ACCESS

80       To use PWRZI or c_pwrzi, load the NCAR Graphics libraries ncarg,
81       ncarg_gks, and ncarg_c, preferably in that order.
82

SEE ALSO

84       Online: isosurface, isosurface_params, ezisos, isgeti, isgetr, isosrf,
85       isseti, issetr, ncarg_cbind
86
87       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
88

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