TDEZ2D(3NCARG)

✨ TDEZ2D ✨

okay so bestie, pull up a chair 🫶 we're looking at TDEZ2D, page 3NCARG of the NCAR GRAPHICS manual, and honestly it's a whole vibe.

---

🌸 NAME 🌸

TDEZ2D — the way that it provides a simplified interface to TDPACK for drawing surfaces?? it's giving "shortcut era" and we are obsessed. 💅

---

🎀 SYNOPSIS 🎀

CALL TDEZ2D(NX,NY,X,Y,Z,RMULT,THETA,PHI,IST)

---

🦋 C-BINDING SYNOPSIS 🦋

literally copy this exactly, no cap:

#include <ncarg/ncargC.h>

void c_tdez3d (int nx, int ny, int nz, float *x, float *y,
               float *z, float *u, float value, float rmult,
               float theta, float phi, int ist)

---

💜 DESCRIPTION 💜

so the arguments of TDEZ2D are, in order, bestie:

• NX — (an input constant or variable of type INTEGER) the size of the input array X down below. 👑
• NY — (an input constant or variable of type INTEGER) the size of the input array Y down below.
• X — (an input array variable of type REAL) a 1-dimensional array specifying X-coordinate values. ✨
• Y — (an input array variable of type REAL) a 1-dimensional array specifying Y-coordinate values. ✨
• Z — (an input array variable of type REAL) an array NX by NY containing the surface to be drawn. Z(I,J) is a functional value at coordinate (X(I),Y(J)) for I=1,NX and J=1,NY. 🌈
• RMULT — (an input constant or variable of type REAL) a multiplier of the diagonal length (DL) of the smallest box containing the surface to be drawn. Together with THETA and PHI (defined below), RMULT is used to determine the eye position (see USAGE). 👀
• THETA — (an input constant or variable of type REAL) an angle (in degrees) in the XY plane measured positive counter-clockwise from the X axis. Together with RMULT (defined above) and PHI (defined below), THETA is used to determine the eye position (see USAGE). 🔄
• PHI — (an input constant or variable of type REAL) an angle (in degrees) measured from the positive Z axis toward the XY plane. Together with RMULT and THETA (defined above), PHI is used to determine the eye position (see USAGE). 🔄
• IST — (an input constant or variable of type INTEGER) a style index defining the colors used to shade the surface, as per this whole menu right here:
  • 1 — wire frame 💀
  • 2 — gray shades underneath; gray shades on top.
  • 3 — gray shades underneath; red shades on top.
  • 4 — gray shades underneath; green shades on top.
  • 5 — gray shades underneath; blue shades on top.
  • 6 — gray shades underneath; cyan shades on top.
  • 7 — gray shades underneath; magenta shades on top.
  • 8 — gray shades underneath; yellow shades on top.

if IST is positive, then black is used for the background color and white for the foreground color; if IST is the negative of any of the above values, then white is used for the background color and black for the foreground color. 🖤🤍

not me about to say the important part: if the value for IST falls outside the legal range, it is defaulted to 6. periodt.

---

🧚 C-BINDING DESCRIPTION 🧚

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different font. 💖

---

🔥 USAGE 🔥

the coordinate (RMULT*DL,THETA,PHI) is the spherical coordinate for the eye position. if RMULT = THETA = PHI = 0., a default eye position ( 2.5,-55.,70.) is chosen. the point looked at is calculated to be the center of the surface. 👁️✨

TDEZ2D does not call FRAME.

if the image is too small, decrease the size of RMULT; if the image is too large, increase the size of RMULT. lowkey simple, highkey useful.

when TDEZ2D is called, a color table is defined for all open workstations that implements IST as described above.

This color table will supersede any color table that has been previously defined. 🚨 like, gone, replaced, no takebacks.

the color table that is defined is:

      Color
      index   Colors
    -------   ----------------------------------------------------
          0   black if IST is positive; white if IST is negative
          1   white if IST is positive; black if IST is negative
          2   red
          3   green
          4   blue
          5   cyan
          6   magenta
          7   yellow
      8- 37   grayscale from white to black.
     38- 67   shades of gray
     68- 97   shades of red
     98-127   shades of green
    128-157   shades of blue
    158-187   shades of cyan
    188-217   shades of magenta
    218-247   shades of yellow

---

👑 ACCESS 👑

to use TDEZ2D or c_tdez2d, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes, in that order. trust. 🫶

---

💀 SEE ALSO 💀

online, aka the group chat: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdsetr, tdsort, tdstri, tdstrs, tdez3d 🌈

---

📜 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 💖 this one's from UNIX, dated June 1998, and it lives at TDEZ2D(3NCARG). go draw some surfaces, you main character. ✨👑🦋