TDGTRS(3NCARG)

💖 TDGTRS — the NCAR Graphics bestie that spills the tea on rendering styles 💖

okay so. this is a page from NCAR Graphics (the <pink>TDGTRS(3NCARG)</pink> one, hey girl hey 👋). it's all about getting the values that define a selected rendering style, which — and this is the important part — changes how triangles look when you draw them with a call to TDDTRI. so like, TDDTRI does the drawing, and TDGTRS is the one who tells you what settings are currently loaded. she's the gossip, not the artist. 💅

---

✨ SYNOPSIS ✨

CALL TDGTRS (IRST, IFC1, IFC2, IFC3, IFC4, ILC1, ILC2, ILTD, USTP, VSTP,
WSTP)

that's the whole squad right there, no cap 🫶

---

🌈 C-BINDING SYNOPSIS 🌈

for my C girlies:

#include <ncarg/ncargC.h>

void c_tdgtrs(int irst, int *ifc1, int *ifc2, int *ifc3, int *ifc4, int
*ilc1, int *ilc2, int *iltd, float *ustp, float *vstp, float *wstp)

---

👑 DESCRIPTION 👑

the arguments of TDGTRS are, one by one, iconic:

• IRST — (an input expression of type INTEGER) the index of the particular rendering style you wanna retrieve. like, which fit are we pulling out of the closet? 👗
• IFC1 and IFC2 — (input expressions of type INTEGER) color indices specifying a range of colors used for the "bottom" side of a surface (that's where function values are less than the value on the surface). here's the breakdown, bestie:
  • if IFC1 is negative, filling of triangles seen from the "bottom" gets turned off. no fill, no vibes.
  • if IFC1 is zero or greater, but IFC2 is less than or equal to it, then the color with index IFC1 is the one that gets used. simple. one color, one moment. ✨
  • if IFC1 is zero or greater and IFC2 is greater than IFC1, then a range of color indices is specified. colors near the beginning of that range go to triangles that are nearly perpendicular to the line of sight, while colors near the end of the range go to triangles that are more nearly parallel to the line of sight. (normally you'd wanna make triangles perpendicular to the line of sight lighter than the ones parallel to the line of sight. that's the aesthetic. don't fight it.) 🎨
• IFC3 and IFC4 — (input expressions of type INTEGER) color indices specifying a range of colors used for the "top" side of a surface (where function values are greater than the value on the surface). same energy as above, but for the top:
  • if IFC3 is negative, filling of triangles seen from the "top" is turned off.
  • if IFC3 is zero or greater, but IFC4 is less than or equal to it, the color with index IFC3 is used.
  • if IFC3 is zero or greater and IFC4 is greater than IFC3, then a range of color indices is specified; colors near the beginning of that range are used for triangles that are nearly perpendicular to the line of sight, while colors near the end of that range are used for triangles more nearly parallel to the line of sight. (and yes, again: normally one should make triangles perpendicular to the line of sight lighter than those parallel to the line of sight. consistency queen. 👑)
• ILC1 — (an input expression of type INTEGER) the color index specifying a color to be used for lines drawn on the "bottom" side of a surface. if ILC1 is negative, drawing of these lines is turned off. 🚫
• ILC2 — (an input expression of type INTEGER) the color index specifying a color to be used for lines drawn on the "top" side of a surface. if ILC2 is negative, drawing of these lines is turned off. 🚫
• ILTD — (an input expression of type INTEGER) a flag which, if set non-zero, turns on the drawing of the edges of the individual triangles that surfaces have been decomposed into. wireframe moment. 🔥
• USTP, VSTP, and WSTP — (input expressions of type REAL) the distances between slices in the U, V, and W directions, respectively. if a given value is zero, the associated slice lines are not drawn. zero means no slices, that's the rule. 🍰

---

🧚 C-BINDING DESCRIPTION 🧚

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same facts, different accent. periodt. 💜

---

🔑 ACCESS 🔑

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

---

👀 SEE ALSO 👀

online besties (go read them, iykyk):

• tdclrs
• tdctri
• tddtri
• tdgeti
• tdgetr
• tdgrds
• tdgrid
• tdinit
• tditri
• tdlbla
• tdlbls
• tdline
• tdlnpa
• tdmtri
• tdotri
• tdpack
• 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.

---

okay that's the whole page, bestie!! this one dropped back in July 1997 on UNIX, and it's still serving <rainbow>TDGTRS(3NCARG)</rainbow> realness to this very day. go get those rendering style values, you absolute main character. 💖✨🦋