1TDSTRI(3NCARG) NCAR GRAPHICS TDSTRI(3NCARG)
2
6 TDSTRI - Add triangles defining a simple surface to the triangles in a
7 triangle list.
8
10 CALL TDSTRI (U, NU, V, NV, W, LW1D, RTRI, MTRI, NTRI, IRST)
11
13 #include <ncarg/ncargC.h>
14 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
19 The arguments of TDSTRI are as follows:
20 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 NU (an input expression of type INTEGER) - the dimension of U.
26 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 NV (an input expression of type INTEGER) - the dimension of V.
32 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 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 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 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 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 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
67 The C-binding argument descriptions are the same as the FORTRAN
68 argument descriptions.
69
71 To use TDSTRI or c_tdstri, load the NCAR Graphics libraries ncarg,
72 ncarg_gks, and ncarg_c, preferably in that order.
73
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-2007
82 University Corporation for Atmospheric Research
83 This documentation is free software; you can redistribute it and/or
85 modify it under the terms of the GNU General Public License as
86 published by the Free Software Foundation; either version 2 of the
87 License, or (at your option) any later version.
88 This software is distributed in the hope that it will be useful, but
90 WITHOUT ANY WARRANTY; without even the implied warranty of
91 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
92 General Public License for more details.
93 You should have received a copy of the GNU General Public License along
95 with this software; if not, write to the Free Software Foundation,
96 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
97UNIX July 1997 TDSTRI(3NCARG)