NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_tditri(float *u, int nu, float *v, int nv, float *w, int nw, float *f, int lf1d, int lf2d, float
       fiso, float *rtri, int mtri, int *ntri, int irst)

DESCRIPTION

       The arguments of TDITRI are as follows:

       U       (an  input  array, of type REAL, dimensioned NU) - values of an independent variable "u". It must
               be the case that U(1) < U(2) < ... U(NU-1) < U(NU).

       NU      (an input expression of type INTEGER) - the dimension of U.

       V       (an input array, of type REAL, dimensioned NV) - values of an independent variable "v".  It  must
               be the case that V(1) < V(2) < ... V(NV-1) < V(NV).

       NV      (an input expression of type INTEGER) - the dimension of V.

       W       (an  input  array, of type REAL, dimensioned NW) - values of an independent variable "w". It must
               be the case that W(1) < W(2) < ... W(NV-1) < W(NV).

       NW      (an input expression of type INTEGER) - the dimension of W.

       F       (an input array, of type REAL, dimensioned NU x NV x NW  and  having  FORTRAN  first  and  second
               dimensions LF1D and LF2D, respectively) - values of a dependent variable "f(u,v,w)".  F(I,J,K) is
               the  value  of  the  function  "f" at the position (U(I),V(J),W(K)); the equation "f(u,v,w)=FISO"
               defines a surface that one wishes to draw.

       LF1D and LF2D
               (input expressions of type INTEGER) - the FORTRAN first and second dimensions of the array F.  It
               must be the case that LF1D is greater than or equal to NU and that LF2D is greater than or  equal
               to NV.

       FISO    (an  input  expression  of type REAL) - the value of the function f defining the isosurface to be
               drawn.

       RTRI    (an input array, of type REAL, dimensioned 10 x MTRI) - a list of triangles, probably created  by
               means  of  calls  to  TDSTRI,  TDITRI,  and/or TDMTRI, and sorted, probably by means of a call to
               TDOTRI.

       MTRI    (an input expression of type INTEGER) - the second dimension of RTRI and thus the maximum  number
               of triangles the triangle list will hold.

       NTRI    (an  input/output variable of type INTEGER) - keeps track of the number of triangles currently in
               the list.  It is the user's responsibility to zero this initially and its value is  increased  by
               each  call  to  a  triangle-generating routine like TDITRI. If NTRI becomes equal to MTRI, TDITRI
               does not take an error exit; instead, it just stops generating triangles.  Therefore, it's a good
               idea, after calling TDITRI, to check the value of NTRI against the  dimension  MTRI;  if  they're
               equal,  it  probably means that the triangle list filled up and that the rendered surface will be
               incomplete.

       IRST    (an input expression of type INTEGER) - specifies the index of the rendering style to to be  used
               for the triangles added to the triangle list by this call.

C-BINDING DESCRIPTION

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

ACCESS

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

SEE ALSO

       Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tdlbla,  tdlbls,  tdline,
       tdlnpa,  tdmtri,  tdotri,  tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr,
       tdsort, tdstri, tdstrs

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.

UNIX                                                July 1997                                     TDITRI(3NCARG)