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

NAME

6       TDMTRI - Add triangles defining a 3D marker to the triangles in a
7       triangle list.
8

SYNOPSIS

10       CALL TDMTRI (IMRK, UMRK, VMRK, WMRK, SMRK, RTRI, MTRI, NTRI, IRST,
11       UMIN, VMIN, WMIN, UMAX, VMAX, WMAX)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       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

DESCRIPTION

21       The arguments of TDMTRI are as follows:
22
23       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
29       UMRK, VMRK, and WMRK
30               (input expressions of type REAL) - the 3-space coordinates of
31               the center point of the marker.
32
33       SMRK    (an input expression of type REAL) - the radius of the marker
34               in 3-space.
35
36       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
41       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
45       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
56       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
60       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

C-BINDING DESCRIPTION

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

ACCESS

70       To use TDMTRI or c_tdmtri, load the NCAR Graphics libraries ncarg,
71       ncarg_gks, and ncarg_c, preferably in that order.
72

SEE ALSO

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-2009
81       University Corporation for Atmospheric Research
82
83       The use of this Software is governed by a License Agreement.
84
85
86
87UNIX                               July 1997                    TDMTRI(3NCARG)
Impressum