# ncl_tdstri man page

TDSTRI — Add triangles defining a simple surface to the triangles in a triangle list.

## Synopsis

CALL TDSTRI (U, NU, V, NV, W, LW1D, RTRI, MTRI, NTRI, IRST)

## C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_tdstri(float *u, int nu, float *v, int nv, float *w, int lw1d, float *rtri, int mtri, int *ntri, int irst)

## Description

The arguments of TDSTRI 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 NU x NV and having FORTRAN first dimension LW1D) - values of a dependent variable "w(u,v)". The points (((U(I),V(J),W(I,J)),I=1,NU),J=1,NV) define a surface that one wishes to draw.
- LW1D
- (an input expression of type INTEGER) - the FORTRAN first dimension of the array W. It must be the case that LW1D is greater than or equal to NU.
- 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 TDSTRI. If NTRI becomes equal to MTRI, TDSTRI does not take an error exit; instead, it just stops generating triangles. Therefore, it's a good idea, after calling TDSTRI, 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 TDSTRI or c_tdstri, 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, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstrs

## Copyright

Copyright (C) 1987-2009

University Corporation for Atmospheric Research

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