ncl_tdpack (3) Linux Manual Page
Tdpack – A set of routines allowing one to draw representations of three-dimensional objects.
Synopsis
TDPACK (which stands for "Three Dimensional PACKage") is a collection of routines for projecting objects from a 3-dimensional coordinate system having U, V, and W axes to a 2-dimensional projection plane having X and Y axes and/or for drawing the projections of those objects. This can be referred to somewhat loosely as "drawing objects in three dimensions".
Tdpack consists of the following routines:
- Initialization Routines:
- TDINIT –
- Define eye position, line of sight, up direction, and stereo flag.
- TDPARA –
- Define the reference parallelogram.
- TDCLRS –
- Define colors for TDPACK.
- Parameter-Access Routines:
- TDGETI –
- Get the integer value of an internal parameter.
- TDGETR –
- Get the real value of an internal parameter.
- TDGTRS –
- Get the definition of a specified rendering style.
- TDSETI –
- Set the integer value of an internal parameter.
- TDSETR –
- Set the real value of an internal parameter.
- TDSTRS –
- Define a specified rendering style.
- Point-Transforming Routines:
- TDPRPT –
- Project from 3-space to the projection plane.
- TDPRPA –
- Project from 3-space to the plane of the reference parallelogram.
- TDPRPI –
- Project from the plane of the reference parallelogram to 3-space.
- Line-Drawing Routines:
- TDLINE –
- Draw the projection of a line in 3-space.
- TDLNPA –
- Draw the projection of a line in the plane of the reference parallelogram.
- Grid-Drawing Routines:
- TDGRDS –
- Draw the grids on all the faces of a box in 3-space.
- TDGRID –
- Draw the grid on a particular face of a box in 3-space.
- Label-Drawing Routines:
- TDLBLS –
- Draw labels for all faces of a box in 3-space.
- TDLBLA –
- Draw labels for a particular face of a box in 3-space.
- TDPLCH –
- Draw characters in the plane of the reference parallelogram.
- Surface-Drawing Routines:
- TDDTRI –
- Draw triangles defined by a triangle list.
- TDSTRI –
- Add triangles defining a simple surface to a triangle list.
- TDITRI –
- Add triangles defining an isosurface to a triangle list.
- TDMTRI –
- Add triangles defining a 3D marker to a triangle list.
- TDCTRI –
- Order the triangles in a triangle list for proper rendering.
- TDSORT –
- Cut triangles with a plane perpendicular to one of the axes.
- TDOTRI –
- Generic sorting routine
C-Binding Synopsis
#include <ncarg/ncargC.h>
c_tdinit
c_tdpara
c_tdclrs
c_tdgeti
c_tdgetr
c_tdgtrs
c_tdseti
c_tdsetr
c_tdstrs
c_tdprpt
c_tdprpa
c_tdprpi
c_tdline
c_tdlnpa
c_tdgrds
c_tdgrid
c_tdlbls
c_tdlbla
c_tdplch
c_tddtri
c_tdstri
c_tditri
c_tdmtri
c_tdotri
c_tdctri
c_tdsort
Access
To use Tdpack, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
Messages
When error conditions are detected, the support routine SETER is called. By default, SETER writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. It is possible to put SETER into recovery mode and regain control after a recoverable error (which includes all of the possible errors).
The possible error messages are listed below. All errors are recoverable in the sense that a user program which has called ENTSR to set recovery mode will get control back after one of these errors occurs.
TDGETI – UNCLEARED PRIOR ERROR
TDGETR – UNCLEARED PRIOR ERROR
TDGETR – UNRECOGNIZED PARAMETER NAME
TDINIT – UNCLEARED PRIOR ERROR
TDPARA – UNCLEARED PRIOR ERROR
TDPRPA – UNCLEARED PRIOR ERROR
TDPRPI – UNCLEARED PRIOR ERROR
TDPRPT – UNCLEARED PRIOR ERROR
TDSETI – UNCLEARED PRIOR ERROR
TDSETR – UNCLEARED PRIOR ERROR
TDSETR – UNRECOGNIZED PARAMETER NAME
See Also
Online: tdclrs, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs
Copyright
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.