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-2009
91       University Corporation for Atmospheric Research
92       The use of this Software is governed by a License Agreement.
93
94
95
96UNIX                              March 1993                     PWRZI(3NCARG)
Impressum