NAME

       TDCTRI - Cut triangles defined by a triangle list.

SYNOPSIS

       CALL TDCTRI (RTRI, MTRI, NTRI, IAXS, RCUT)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_tdctri(float *rtri, int mtri, int *ntri, int iaxs, float rcut)

DESCRIPTION

       This routine, given a list of NTRI triangles in the array RTRI, an axis identifier IAXS (1 => U axis, 2
       => V axis, 3 => W axis), and a value RCUT along that axis, cuts all the triangles that intersect the
       plane perpendicular to the identified axis at the specified value into two pieces, one on either side of
       the plane.  This is useful when one is rendering the triangles in colors that depend on their position in
       U, V, or W.  (See the example "tdex04".)

       The arguments of TDCTRI are as follows:

       RTRI    (an  input/output  array,  of  type  REAL, dimensioned 10 x MTRI) - a list of triangles, probably
               created by means of calls to TDSTRI, TDITRI, and/or TDMTRI.  The number of triangles in the  list
               may increase as a result of calling TDCTRI.

       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) - specifies the number of triangles currently  in  the
               list.   It  is  the  user's responsibility to zero this initially; its value is increased by each
               call to a triangle-generating routine like TDSTRI or TDITRI and may be increased  by  a  call  to
               TDCTRI.

       IAXS    (an  input variable of type INTEGER) - specifies the axis to which the cut plane is perpendicular
               (1 => U axis, 2 => V axis, 3 => W axis).

       RCUT    (an input variable of type REAL) - specifies that value of U, V, or W  at  which  the  cut  plane
               intersects the axis.

C-BINDING DESCRIPTION

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

ACCESS

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

SEE ALSO

       Online: tdclrs, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla,  tdlbls,  tdline,
       tdlnpa,  tdmtri,  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                                     TDCTRI(3NCARG)