NAME

       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.