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

NAME

6       TDEZ2D - Provides a simplified interface to TDPACK for drawing
7       surfaces.
8

SYNOPSIS

10       CALL TDEZ2D(NX,NY,X,Y,Z,RMULT,THETA,PHI,IST)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       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

DESCRIPTION

20       The arguments of TDEZ2D are as follows:
21
22       NX      (an input constant or variable of type INTEGER) - The size of
23               the input array X below.
24
25       NY      (an input constant or variable of type INTEGER) - The size of
26               the input array Y below.
27
28       X       (an input array variable of type REAL) - A 1-dimensional array
29               specifying X-coordinate values.
30
31       Y       (an input array variable of type REAL) - A 1-dimensional array
32               specifying Y-coordinate values.
33
34       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
38       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
44       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
50       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
55       IST     (an input constant or variable of type INTEGER) - A style index
56               defining the colors used to shade the surface as per:
57
58               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
67
68               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
73               If the value for IST falls outside the legal range, it is
74               defaulted to 6.
75

C-BINDING DESCRIPTION

77       The C-binding argument descriptions are the same as the FORTRAN
78       argument descriptions.
79

USAGE

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
86       TDEZ2D does not call FRAME.
87
88       If the image is too small, decrease the size of RMULT; if the image is
89       too large, increase the size of RMULT.
90
91       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
96
97             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
117

ACCESS

119       To use TDEZ2D or c_tdez2d, load the NCAR Graphics libraries ncarg,
120       ncarg_gks, and ncarg_c, preferably in that order.
121

SEE ALSO

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

COPYRIGHT

129       Copyright (C) 1987-2009
130       University Corporation for Atmospheric Research
131       The use of this Software is governed by a License Agreement.
132
133
134
135UNIX                               June 1998                    TDEZ2D(3NCARG)