1TDITRI(3NCARG) NCAR GRAPHICS TDITRI(3NCARG)
2
3
4
6 TDITRI - Add triangles defining a simple surface to the triangles in a
7 triangle list.
8
10 CALL TDITRI (U, NU, V, NV, W, NW, F, LF1D, LF2D, FISO, RTRI, MTRI,
11 NTRI, IRST)
12
14 #include <ncarg/ncargC.h>
15
16 void c_tditri(float *u, int nu, float *v, int nv, float *w, int nw,
17 float *f, int lf1d, int lf2d, float fiso, float *rtri, int mtri, int
18 *ntri, int irst)
19
21 The arguments of TDITRI are as follows:
22
23 U (an input array, of type REAL, dimensioned NU) - values of an
24 independent variable "u". It must be the case that U(1) < U(2)
25 < ... U(NU-1) < U(NU).
26
27 NU (an input expression of type INTEGER) - the dimension of U.
28
29 V (an input array, of type REAL, dimensioned NV) - values of an
30 independent variable "v". It must be the case that V(1) < V(2)
31 < ... V(NV-1) < V(NV).
32
33 NV (an input expression of type INTEGER) - the dimension of V.
34
35 W (an input array, of type REAL, dimensioned NW) - values of an
36 independent variable "w". It must be the case that W(1) < W(2)
37 < ... W(NV-1) < W(NV).
38
39 NW (an input expression of type INTEGER) - the dimension of W.
40
41 F (an input array, of type REAL, dimensioned NU x NV x NW and
42 having FORTRAN first and second dimensions LF1D and LF2D,
43 respectively) - values of a dependent variable "f(u,v,w)".
44 F(I,J,K) is the value of the function "f" at the position
45 (U(I),V(J),W(K)); the equation "f(u,v,w)=FISO" defines a
46 surface that one wishes to draw.
47
48 LF1D and LF2D
49 (input expressions of type INTEGER) - the FORTRAN first and
50 second dimensions of the array F. It must be the case that
51 LF1D is greater than or equal to NU and that LF2D is greater
52 than or equal to NV.
53
54 FISO (an input expression of type REAL) - the value of the function
55 f defining the isosurface to be drawn.
56
57 RTRI (an input array, of type REAL, dimensioned 10 x MTRI) - a list
58 of triangles, probably created by means of calls to TDSTRI,
59 TDITRI, and/or TDMTRI, and sorted, probably by means of a call
60 to TDOTRI.
61
62 MTRI (an input expression of type INTEGER) - the second dimension of
63 RTRI and thus the maximum number of triangles the triangle list
64 will hold.
65
66 NTRI (an input/output variable of type INTEGER) - keeps track of the
67 number of triangles currently in the list. It is the user's
68 responsibility to zero this initially and its value is
69 increased by each call to a triangle-generating routine like
70 TDITRI. If NTRI becomes equal to MTRI, TDITRI does not take an
71 error exit; instead, it just stops generating triangles.
72 Therefore, it's a good idea, after calling TDITRI, to check the
73 value of NTRI against the dimension MTRI; if they're equal, it
74 probably means that the triangle list filled up and that the
75 rendered surface will be incomplete.
76
77 IRST (an input expression of type INTEGER) - specifies the index of
78 the rendering style to to be used for the triangles added to
79 the triangle list by this call.
80
82 The C-binding argument descriptions are the same as the FORTRAN
83 argument descriptions.
84
86 To use TDITRI or c_tditri, load the NCAR Graphics libraries ncarg,
87 ncarg_gks, and ncarg_c, preferably in that order.
88
90 Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs,
91 tdinit, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack,
92 tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr,
93 tdsort, tdstri, tdstrs
94
96 Copyright (C) 1987-2009
97 University Corporation for Atmospheric Research
98
99 The use of this Software is governed by a License Agreement.
100
101
102
103UNIX July 1997 TDITRI(3NCARG)