TDCTRI(3NCARG)

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.