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

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_tdstri(float *u, int nu, float *v, int nv, float *w, int lw1d,
16       float *rtri, int mtri, int *ntri, int irst)
17

DESCRIPTION

19       The arguments of TDSTRI are as follows:
20
21       U       (an input array, of type REAL, dimensioned NU) - values of an
22               independent variable "u". It must be the case that U(1) < U(2)
23               < ... U(NU-1) < U(NU).
24
25       NU      (an input expression of type INTEGER) - the dimension of U.
26
27       V       (an input array, of type REAL, dimensioned NV) - values of an
28               independent variable "v". It must be the case that V(1) < V(2)
29               < ... V(NV-1) < V(NV).
30
31       NV      (an input expression of type INTEGER) - the dimension of V.
32
33       W       (an input array, of type REAL, dimensioned NU x NV and having
34               FORTRAN first dimension LW1D) - values of a dependent variable
35               "w(u,v)". The points (((U(I),V(J),W(I,J)),I=1,NU),J=1,NV)
36               define a surface that one wishes to draw.
37
38       LW1D    (an input expression of type INTEGER) - the FORTRAN first
39               dimension of the array W.  It must be the case that LW1D is
40               greater than or equal to NU.
41
42       RTRI    (an input array, of type REAL, dimensioned 10 x MTRI) - a list
43               of triangles, probably created by means of calls to TDSTRI,
44               TDITRI, and/or TDMTRI, and sorted, probably by means of a call
45               to TDOTRI.
46
47       MTRI    (an input expression of type INTEGER) - the second dimension of
48               RTRI and thus the maximum number of triangles the triangle list
49               will hold.
50
51       NTRI    (an input/output variable of type INTEGER) - keeps track of the
52               number of triangles currently in the list.  It is the user's
53               responsibility to zero this initially and its value is
54               increased by each call to a triangle-generating routine like
55               TDSTRI. If NTRI becomes equal to MTRI, TDSTRI does not take an
56               error exit; instead, it just stops generating triangles.
57               Therefore, it's a good idea, after calling TDSTRI, to check the
58               value of NTRI against the dimension MTRI; if they're equal, it
59               probably means that the triangle list filled up and that the
60               rendered surface will be incomplete.
61
62       IRST    (an input expression of type INTEGER) - specifies the index of
63               the rendering style to to be used for the triangles added to
64               the triangle list by this call.
65

C-BINDING DESCRIPTION

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

ACCESS

71       To use TDSTRI or c_tdstri, load the NCAR Graphics libraries ncarg,
72       ncarg_gks, and ncarg_c, preferably in that order.
73

SEE ALSO

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

81       Copyright (C) 1987-2009
82       University Corporation for Atmospheric Research
83
84       The use of this Software is governed by a License Agreement.
85
86
87
88UNIX                               July 1997                    TDSTRI(3NCARG)
Impressum