1TDMTRI(3NCARG) NCAR GRAPHICS TDMTRI(3NCARG)
2
6 TDMTRI - Add triangles defining a 3D marker to the triangles in a
7 triangle list.
8
10 CALL TDMTRI (IMRK, UMRK, VMRK, WMRK, SMRK, RTRI, MTRI, NTRI, IRST,
11 UMIN, VMIN, WMIN, UMAX, VMAX, WMAX)
12
14 #include <ncarg/ncargC.h>
15 void c_tdmtri(int imrk, float umrk, float vmrk, float wmrk, float smrk,
17 float *rtri, int mtri, int *ntri, int irst, float umin, float vmin,
18 float wmin, float umax, float vmax, float wmax)
19
21 The arguments of TDMTRI are as follows:
22 IMRK (an input expression of type INTEGER) - has an absolute value
24 between 1 and 5, inclusive, specifying the type of marker to be
25 generated. If the value of IMRK is less than zero, the
26 triangles will not be clipped against the sides of the data
27 box, otherwise, they will.
28 UMRK, VMRK, and WMRK
30 (input expressions of type REAL) - the 3-space coordinates of
31 the center point of the marker.
32 SMRK (an input expression of type REAL) - the radius of the marker
34 in 3-space.
35 RTRI (an input array, of type REAL, dimensioned 10 x MTRI) - a list
37 of triangles, probably created by means of calls to TDSTRI,
38 TDITRI, and/or TDMTRI, and sorted, probably by means of a call
39 to TDOTRI.
40 MTRI (an input expression of type INTEGER) - the second dimension of
42 RTRI and thus the maximum number of triangles the triangle list
43 will hold.
44 NTRI (an input/output variable of type INTEGER) - keeps track of the
46 number of triangles currently in the list. It is the user's
47 responsibility to zero this initially and its value is
48 increased by each call to a triangle-generating routine like
49 TDMTRI. If NTRI becomes equal to MTRI, TDMTRI does not take an
50 error exit; instead, it just stops generating triangles.
51 Therefore, it's a good idea, after calling TDMTRI, to check the
52 value of NTRI against the dimension MTRI; if they're equal, it
53 probably means that the triangle list filled up and that the
54 rendered surface will be incomplete.
55 IRST (an input expression of type INTEGER) - specifies the index of
57 the rendering style to to be used for the triangles added to
58 the triangle list by this call.
59 UMIN, VMIN, WMIN, UMAX, VMAX, and WMAX
61 (input expressions of type REAL) - each of these specifies one
62 of the coordinate values defining the data box in 3-space. The
63 names of these should make it clear what they are.
64
66 The C-binding argument descriptions are the same as the FORTRAN
67 argument descriptions.
68
70 To use TDMTRI or c_tdmtri, load the NCAR Graphics libraries ncarg,
71 ncarg_gks, and ncarg_c, preferably in that order.
72
74 Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs,
75 tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdotri, tdpack,
76 tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr,
77 tdsort, tdstri, tdstrs
78
80 Copyright (C) 1987-2007
81 University Corporation for Atmospheric Research
82 This documentation is free software; you can redistribute it and/or
84 modify it under the terms of the GNU General Public License as
85 published by the Free Software Foundation; either version 2 of the
86 License, or (at your option) any later version.
87 This software is distributed in the hope that it will be useful, but
89 WITHOUT ANY WARRANTY; without even the implied warranty of
90 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
91 General Public License for more details.
92 You should have received a copy of the GNU General Public License along
94 with this software; if not, write to the Free Software Foundation,
95 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
96UNIX July 1997 TDMTRI(3NCARG)