1TDEZ3D(3NCARG) NCAR GRAPHICS TDEZ3D(3NCARG)
2
6 TDEZ3D - Provides a simplified interface to TDPACK for drawing
7 isosurfaces.
8
10 CALL TDEZ3D(NX,NY,NZ,X,Y,Z,U,VALUE,RMULT,THETA,PHI,IST)
11
13 #include <ncarg/ncargC.h>
14 void c_tdez3d (int nx, int ny, int nz, float *x, float *y,
16 float *z, float *u, float value, float rmult,
17 float theta, float phi, int ist)
18
20 The arguments of TDEZ3D are as follows:
21 NX (an input constant or variable of type INTEGER) - The size of
23 the input array X below.
24 NY (an input constant or variable of type INTEGER) - The size of
26 the input array Y below.
27 NZ (an input constant or variable of type INTEGER) - The size of
29 the input array Z below.
30 X (an input array variable of type REAL) - A 1-dimensional array
32 specifying X-coordinate values.
33 Y (an input array variable of type REAL) - A 1-dimensional array
35 specifying Y-coordinate values.
36 Z (an input array variable of type REAL) - A 1-dimensional array
38 specifying Z-coordinate values.
39 U (an input array variable of type REAL) - An array NX by NY by
41 NZ containing functional values; Z(I,J,K) is a functional value
42 at coordiante (X(I),Y(J),Z(K)) for I=1,NX, J=1,NY, and K=1,NZ.
43 VALUE (an input array variable of type REAL) - An isovalue.
45 RMULT (an input constant or variable of type REAL) - A multiplier of
47 the diagonal length (DL) of the box defined by the limits of
48 the X, Y, and Z arrays. Together with THETA and PHI (defined
49 below), RMULT is used to determine the eye position (see
50 USAGE).
51 THETA (an input constant or variable of type REAL) - An angle (in
53 degrees) in the XY plane measured positive counter-clockwise
54 from the X axis. Together with RMULT (defined above) and PHI
55 (defined below), THETA is used to determine the eye position
56 (see USAGE).
57 PHI (an input constant or variable of type REAL) - An angle (in
59 degrees) measured from the positive Z axis toward the XY plane.
60 Together with RMULT and THETA (defined above), PHI is used to
61 determine the eye position (see USAGE).
62 IST (an input constant or variable of type INTEGER) - A style index
64 defining the colors used to shade the isosurface as per:
65 1 - wire frame
67 2 - gray shades underneath; gray shades on top.
68 3 - gray shades underneath; red shades on top.
69 4 - gray shades underneath; green shades on top.
70 5 - gray shades underneath; blue shades on top.
71 6 - gray shades underneath; cyan shades on top.
72 7 - gray shades underneath; magenta shades on top.
73 8 - gray shades underneath; yellow shades on top.
74 IST is positive, then black is used for the background or and
77 white for the foreground color; if IST is negative of any of
78 the above values, then white used for the background color and
79 black for the eground color.
80 If the value for IST falls outside the legal range, it is
82 defaulted to 6.
83
85 The C-binding argument descriptions are the same as the FORTRAN
86 argument descriptions.
87
89 The coordinate (RMULT*DL,THETA,PHI) is the spherical coordinate for the
90 eye position. If RMULT = THETA = PHI = 0., a default eye position (
91 2.5,-55.,70.) is chosen. The point looked at is calculated to be the
92 center of the box defined by the limits of the X, Y, and Z arrays.
93 TDEZ3D does not call FRAME.
95 If the image is too small, decrease the size of RMULT; if the image is
97 too large, increase the size of RMULT.
98 When TDEZ3D is called, a color table is defined for all open
100 workstations that implements IST as described above. *This color table
101 will supersede any color table that has been previously defined.* The
102 color table that is defined is:
103 Color
106 index Colors
107 ------- ----------------------------------------------------
108 0 black if IST is positive; white if IST is negative
109 1 white if IST is positive; black if IST is negative
110 2 red
111 3 green
112 4 blue
113 5 cyan
114 6 magenta
115 7 yellow
116 8- 37 grayscale from white to black.
117 38- 67 shades of gray
118 68- 97 shades of red
119 98-127 shades of green
120 128-157 shades of blue
121 158-187 shades of cyan
122 188-217 shades of magenta
123 218-247 shades of yellow
124
127 To use TDEZ3D or c_tdez3d, load the NCAR Graphics libraries ncarg,
128 ncarg_gks, and ncarg_c, preferably in that order.
129
131 Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs,
132 tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack,
133 tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdsetr, tdsort,
134 tdstri, tdstrs, tdez2d
135
137 Copyright (C) 1987-2007
138 University Corporation for Atmospheric Research
139 This documentation is free software; you can redistribute it and/or
141 modify it under the terms of the GNU General Public License as
142 published by the Free Software Foundation; either version 2 of the
143 License, or (at your option) any later version.
144 This software is distributed in the hope that it will be useful, but
146 WITHOUT ANY WARRANTY; without even the implied warranty of
147 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
148 General Public License for more details.
149 You should have received a copy of the GNU General Public License along
151 with this software; if not, write to the Free Software Foundation,
152 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
153UNIX June 1998 TDEZ3D(3NCARG)