TDGRDS(3NCARG)

💖 TDGRDS — bestie edition 💖

okay so real quick, the vibe: this is a page from the NCAR GRAPHICS manual, section 3NCARG, and it's literally about drawing boxes that look cute. let's get into it 🎀

---

✨ NAME ✨

TDGRDS — draws perimeters on the six sides of a box, and if you want, it'll throw in ticks or grid lines too. lowkey the most important thing tho: this routine calls TDPARA, which means it will change the definition of the reference parallelogram. so like, heads up. 🫶

---

🌸 SYNOPSIS 🌸

CALL TDGRDS (UMIN, VMIN, WMIN, UMAX, VMAX, WMAX, USTP, VSTP, WSTP, IGRT,
IHID)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_tdgrds(float umin, float vmin, float wmin, float umax, float
vmax, float wmax, float ustp, float vstp, float wstp, int igrt, int
ihid)

---

👑 DESCRIPTION 👑

the arguments of TDGRDS are, in order, bestie:

• UMIN, VMIN, WMIN, UMAX, VMAX, WMAX — (input expressions of type REAL) these are the coordinate values that define the box in 3-space. and honestly? the names say it all. they're giving exactly what they need to give. 💅
• USTP, VSTP, and WSTP — (input expressions of type REAL) these specify the step sizes between the ticks or grid lines in the U direction, the V direction, and the W direction, respectively. ⭐ and here's the tea: if one of these values is less than or equal to zero, the ticks or grid lines in the associated direction are omitted. gone. not invited. 🚫
• IGRT — (an input expression of type INTEGER) and it's built like 10*IGRN+IGRF, where IGRN says what to draw on the near sides of the box and IGRF says what to draw on the far sides of the box. and "near" and "far" here are defined by the current line of sight, iykyk. 👀

each of IGRN and IGRF can be one of these:

• 0 — draw nothing
• 1 — draw just a perimeter
• 2 — draw a perimeter with inward-pointing ticks
• 3 — draw a perimeter with a grid

for example, to draw grids on the far side of the box and just perimeters on the near sides of the box, you use IGRT = 13. no cap. 🔥

• IHID — (an input expression of type INTEGER) set it to 0 to draw only those sides of the box that cannot be hidden by something inside the box, or to 1 to draw only those sides of the box that can be hidden by something inside the box. 🙈

and here's the standard operating procedure, bestie, write it down: call TDGRDS before drawing surfaces inside a box, with IHID set to 1, and then call it again after drawing surfaces inside a box, with IHID set to 0. that's the ritual. that's the move. 🧚

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different syntax. periodt. 💜

---

🍓 ACCESS 🍓

to use TDGRDS or c_tdgrds, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. the order matters bestie, don't be chaotic about it. 🌸

---

💅 SEE ALSO 💅

Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs. the whole friend group, basically. squad goals. 👑

---

🎀 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!! 💖 this one's from the UNIX era, dated July 1997, straight out of the NCAR GRAPHICS manual — so if you ever wondered what the girlies were drawing boxes with in '97, now you know. slay, go draw ur box. 🦋✨🎀