# ncl_tdpack - Man Page

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.