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