Tdpack(3NCARG)

👑 Tdpack — the NCAR Graphics three-dee glow-up 💅

✨ NAME ✨

Tdpack — a whole set of routines that lets you draw representations of three-dimensional objects. Yes bestie, actual 3D. In NCAR Graphics. We're so back. 🦋

---

🌸 SYNOPSIS 🌸

Okay so, TDPACK — which literally stands for "Three Dimensional PACKage", the acronym ate and left no crumbs — is a collection of routines for projecting objects from a 3-dimensional coordinate system having U, V, and W axes over to a 2-dimensional projection plane having X and Y axes, and/or for drawing the projections of those objects. Loosely speaking you can call all of this "drawing objects in three dimensions". 🫶

Tdpack consists of the following routines, and no we are not skipping any of them, every single one is a main character:

💖 Initialization Routines

• TDINIT — Define eye position, line of sight, up direction, and the stereo flag. Basically you're telling it where the camera lives and which way is up. 🌈
• TDPARA — Define the reference parallelogram. Your whole coordinate vibe check revolves around this one.
• TDCLRS — Define colors for TDPACK. Slay, but make it chromatic. 🎀

💜 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. All of them. Every face. No crumbs.
• TDGRID — Draw the grid on a particular face of a box in 3-space. Pick your fave.

🎀 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. (The organizer. The one who keeps the group chat on topic. 😭)
• TDSORT — Cut triangles with a plane perpendicular to one of the axes.
• TDOTRI — Generic sorting routine.

---

💻 C-BINDING SYNOPSIS 💻

Not me about to hand you the C glow-up. Include this:

#include <ncarg/ncargC.h>

And here's the whole c_ roster, in order, exactly as it comes:

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, bestie, the order is not a suggestion. 🫶

---

💀 MESSAGES 💀

When error conditions get detected, the support routine SETER gets called. By default, SETER writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution — like, it does not play, it just ends you. 😭

Good news though: it's possible to put SETER into recovery mode and regain control after a recoverable error, and yes, that includes all of the possible errors. So everything here is 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. Iconic of it honestly.

The possible error messages are listed below, verbatim, no edits:

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, go read these next, they're all linked up like a friend group:

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.

---

And that's the whole page, bestie — the NCAR Graphics Tdpack(3NCARG) man page, originally from the UNIX manual, dated July 1997. Go draw some boxes in three dimensions, you've got this. 💖✨🦋