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

NAME

6       TDITRI - Add triangles defining a simple surface to the triangles in a
7       triangle list.
8

SYNOPSIS

10       CALL TDITRI (U, NU, V, NV, W, NW, F, LF1D, LF2D, FISO, RTRI, MTRI,
11       NTRI, IRST)
12

C-BINDING SYNOPSIS

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

DESCRIPTION

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

C-BINDING DESCRIPTION

82       The C-binding argument descriptions are the same as the FORTRAN
83       argument descriptions.
84

ACCESS

86       To use TDITRI or c_tditri, load the NCAR Graphics libraries ncarg,
87       ncarg_gks, and ncarg_c, preferably in that order.
88

SEE ALSO

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-2007
97       University Corporation for Atmospheric Research
98
99       This documentation is free software; you can redistribute it and/or
100       modify it under the terms of the GNU General Public License as
101       published by the Free Software Foundation; either version 2 of the
102       License, or (at your option) any later version.
103
104       This software is distributed in the hope that it will be useful, but
105       WITHOUT ANY WARRANTY; without even the implied warranty of
106       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
107       General Public License for more details.
108
109       You should have received a copy of the GNU General Public License along
110       with this software; if not, write to the Free Software Foundation,
111       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
112
113
114
115
116UNIX                               July 1997                    TDITRI(3NCARG)
Impressum