TDSTRS(3NCARG)

💖 TDSTRS — bestie edition 💖

okay so you're in the NCAR GRAPHICS section of the manual (that's the 3NCARG part, iykyk) and you've stumbled onto TDSTRS. welcome. it's giving triangle-glowup. ✨

---

🌸 NAME 🌸

TDSTRS — sets the values that define a selected rendering style, and that style is literally what decides how triangles look when they get drawn by a call to the routine TDDTRI. no cap.

---

🎀 SYNOPSIS 🎀

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

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_tdstrs(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 TDSTRS are as follows, and yes we're doing all of them, periodt:

• IRST — (an input expression of type INTEGER) the index of the particular rendering style which is to be retrieved. it's the vibe selector, bestie. 👑
• IFC1 and IFC2 — (output variables of type INTEGER) color indices specifying a range of colors to be used for the "bottom" side of a surface (where function values are less than the value on the surface). here's the tea:
  • if IFC1 is negative, filling of triangles seen from the "bottom" is turned off. 🚫
  • if IFC1 is zero or greater, but IFC2 is less than or equal to it, the color with index IFC1 is used. one color, no drama.
  • 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 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.
  • (normally, one should make triangles perpendicular to the line of sight lighter than those parallel to the line of sight.) 💅
• IFC3 and IFC4 — (output variables of type INTEGER) color indices specifying a range of colors to be used for the "top" side of a surface (where function values are greater than the value on the surface). same energy, different side:
  • 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.
  • (normally, one should make triangles perpendicular to the line of sight lighter than those parallel to the line of sight.) ✨
• ILC1 — (an output variable 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, the drawing of these lines is turned off. 🙈
• ILC2 — (an output variable 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, the drawing of these lines is turned off. 🙈
• ILTD — (an output variable of type INTEGER) a flag, which, if set non-zero, turns on the drawing of the edges of the individual triangles into which surfaces have been decomposed. triangle outlines?? we love to see it. 🔥
• USTP, VSTP, and WSTP — (output variables 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 whole rule. 🍓

---

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. same facts, different wrapper. 🫶

---

🌈 ACCESS 🌈

to use TDSTRS or c_tdstrs, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, don't be chaotic. 🧚

---

⭐ SEE ALSO ⭐

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

---

💖 COPYRIGHT 💖

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

fr fr that's the whole page. go forth and render those triangles, main character. 💅🌈

TDSTRS(3NCARG) · NCAR GRAPHICS · July 1997 · mwah, that's a wrap 🎀✨