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

NAME

6       Tdpack - A set of routines allowing one to draw representations of
7       three-dimensional objects.
8

SYNOPSIS

10       TDPACK (which stands for "Three Dimensional PACKage") is a collection
11       of routines for projecting objects from a 3-dimensional coordinate
12       system having U, V, and W axes to a 2-dimensional projection plane
13       having X and Y axes and/or for drawing the projections of those
14       objects.  This can be referred to somewhat loosely as "drawing objects
15       in three dimensions".
16
17       Tdpack consists of the following routines:
18
19       Initialization Routines:
20
21         TDINIT - Define eye position, line of sight, up direction, and stereo
22                  flag.
23
24         TDPARA - Define the reference parallelogram.
25
26         TDCLRS - Define colors for TDPACK.
27
28       Parameter-Access Routines:
29
30         TDGETI - Get the integer value of an internal parameter.
31
32         TDGETR - Get the real value of an internal parameter.
33
34         TDGTRS - Get the definition of a specified rendering style.
35
36         TDSETI - Set the integer value of an internal parameter.
37
38         TDSETR - Set the real value of an internal parameter.
39
40         TDSTRS - Define a specified rendering style.
41
42       Point-Transforming Routines:
43
44         TDPRPT - Project from 3-space to the projection plane.
45
46         TDPRPA - Project from 3-space to the plane of the reference
47                  parallelogram.
48
49         TDPRPI - Project from the plane of the reference parallelogram to
50                  3-space.
51
52       Line-Drawing Routines:
53
54         TDLINE - Draw the projection of a line in 3-space.
55
56         TDLNPA - Draw the projection of a line in the plane of the reference
57                  parallelogram.
58
59       Grid-Drawing Routines:
60
61         TDGRDS - Draw the grids on all the faces of a box in 3-space.
62
63         TDGRID - Draw the grid on a particular face of a box in 3-space.
64
65       Label-Drawing Routines:
66
67         TDLBLS - Draw labels for all faces of a box in 3-space.
68
69         TDLBLA - Draw labels for a particular face of a box in 3-space.
70
71         TDPLCH - Draw characters in the plane of the reference parallelogram.
72
73       Surface-Drawing Routines:
74
75         TDDTRI - Draw triangles defined by a triangle list.
76
77         TDSTRI - Add triangles defining a simple surface to a triangle list.
78
79         TDITRI - Add triangles defining an isosurface to a triangle list.
80
81         TDMTRI - Add triangles defining a 3D marker to a triangle list.
82
83         TDCTRI - Order the triangles in a triangle list for proper rendering.
84
85         TDSORT - Cut triangles with a plane perpendicular to one of the axes.
86
87         TDOTRI - Generic sorting routine
88

C-BINDING SYNOPSIS

90       #include <ncarg/ncargC.h>
91
92       c_tdinit
93       c_tdpara
94       c_tdclrs
95       c_tdgeti
96       c_tdgetr
97       c_tdgtrs
98       c_tdseti
99       c_tdsetr
100       c_tdstrs
101       c_tdprpt
102       c_tdprpa
103       c_tdprpi
104       c_tdline
105       c_tdlnpa
106       c_tdgrds
107       c_tdgrid
108       c_tdlbls
109       c_tdlbla
110       c_tdplch
111       c_tddtri
112       c_tdstri
113       c_tditri
114       c_tdmtri
115       c_tdotri
116       c_tdctri
117       c_tdsort
118

ACCESS

120       To use Tdpack, load the NCAR Graphics libraries ncarg, ncarg_gks, and
121       ncarg_c, preferably in that order.
122

MESSAGES

124       When error conditions are detected, the support routine SETER is
125       called. By default, SETER writes a message to the standard error file
126       (as defined by I1MACH(4)) and then terminates execution.  It is
127       possible to put SETER into recovery mode and regain control after a
128       recoverable error (which includes all of the possible errors).
129
130       The possible error messages are listed below.  All errors are
131       recoverable in the sense that a user program which has called ENTSR to
132       set recovery mode will get control back after one of these errors
133       occurs.
134
135            TDGETI - UNCLEARED PRIOR ERROR
136            TDGETR - UNCLEARED PRIOR ERROR
137            TDGETR - UNRECOGNIZED PARAMETER NAME
138            TDINIT - UNCLEARED PRIOR ERROR
139            TDPARA - UNCLEARED PRIOR ERROR
140            TDPRPA - UNCLEARED PRIOR ERROR
141            TDPRPI - UNCLEARED PRIOR ERROR
142            TDPRPT - UNCLEARED PRIOR ERROR
143            TDSETI - UNCLEARED PRIOR ERROR
144            TDSETR - UNCLEARED PRIOR ERROR
145            TDSETR - UNRECOGNIZED PARAMETER NAME
146
147

SEE ALSO

149       Online: tdclrs, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit,
150       tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack_params,
151       tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri,
152       tdstrs
153

155       Copyright (C) 1987-2007
156       University Corporation for Atmospheric Research
157
158       This documentation is free software; you can redistribute it and/or
159       modify it under the terms of the GNU General Public License as
160       published by the Free Software Foundation; either version 2 of the
161       License, or (at your option) any later version.
162
163       This software is distributed in the hope that it will be useful, but
164       WITHOUT ANY WARRANTY; without even the implied warranty of
165       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
166       General Public License for more details.
167
168       You should have received a copy of the GNU General Public License along
169       with this software; if not, write to the Free Software Foundation,
170       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
171
172
173
174UNIX                               July 1997                    Tdpack(3NCARG)
Impressum