TDMTRI(3NCARG)

✨ TDMTRI ✨ (the NCAR Graphics one, bestie 💖)

okay so literally welcome to TDMTRI from the NCAR Graphics family — she lives in the 3NCARG section of the manual and she is the girl for adding triangles that make up a 3D marker. 🎀

---

🌸 NAME 🌸

TDMTRI — adds triangles that define a 3D marker into a triangle list. that's it, that's the whole vibe. 💅

---

🦋 SYNOPSIS 🦋

CALL TDMTRI (IMRK, UMRK, VMRK, WMRK, SMRK, RTRI, MTRI, NTRI, IRST, UMIN,
VMIN, WMIN, UMAX, VMAX, WMAX)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_tdmtri(int imrk, float umrk, float vmrk, float wmrk, float smrk,
float *rtri, int mtri, int *ntri, int irst, float umin, float vmin,
float wmin, float umax, float vmax, float wmax)

---

👑 DESCRIPTION 👑

so the arguments of TDMTRI are giving, in order:

• IMRK — an input expression of type INTEGER, no cap. her absolute value sits between 1 and 5, inclusive, and she picks the type of marker that gets generated. 🎀 now here's the tea: if IMRK is less than zero, the triangles will not be clipped against the sides of the data box. otherwise, they will. so the sign literally matters, bestie.
• UMRK, VMRK, and WMRK — input expressions of type REAL. these are the 3-space coordinates of the center point of the marker. the marker's lil home base. 📍
• SMRK — an input expression of type REAL. this is the radius of the marker in 3-space. how big she's serving, basically. 🌈
• RTRI — an input array, of type REAL, dimensioned 10 x MTRI. it's a list of triangles, probably created by means of calls to TDSTRI, TDITRI, and/or TDMTRI, and sorted, probably by means of a call to TDOTRI. yes she's a whole ecosystem. ✨
• MTRI — an input expression of type INTEGER. this is the second dimension of RTRI and thus the maximum number of triangles the triangle list will hold. the capacity, the limit, the ceiling. 🫶
• NTRI — an input/output variable of type INTEGER. she keeps track of the number of triangles currently in the list. and listen: it is the user's responsibility to zero this initially, okay?? and its value gets increased by each call to a triangle-generating routine like TDMTRI. 🙈 also super important — if NTRI becomes equal to MTRI, TDMTRI does not take an error exit; instead, it just stops generating triangles. so it's a good idea, after calling TDMTRI, to check the value of NTRI against the dimension MTRI. if they're equal, it probably means the triangle list filled up and the rendered surface will be incomplete. 😭 lowkey devastating honestly.
• IRST — an input expression of type INTEGER. specifies the index of the rendering style to to be used for the triangles added to the triangle list by this call. (yes the original says "to to", iconic, we respect her.) 💜
• UMIN, VMIN, WMIN, UMAX, VMAX, and WMAX — input expressions of type REAL. each of these specifies one of the coordinate values defining the data box in 3-space. the names of these should make it clear what they are. 🎯

💫 C-BINDING DESCRIPTION 💫

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. periodt. no notes. 💅

---

🌟 ACCESS 🌟

to use TDMTRI or c_tdmtri, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. the order is not a suggestion bestie, she has opinions. 👑

---

🔥 SEE ALSO 🔥

online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs

the whole friend group honestly, iykyk 🫶

---

🎀 COPYRIGHT 🎀

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

the use of this Software is governed by a License Agreement.

---

💀 real talk: don't forget to zero NTRI at the start and check it against MTRI when you're done, or your surface is gonna come out looking incomplete and you'll be sobbing. 🥲

okay that's the whole page, mwah. 💖 this was TDMTRI(3NCARG) from the NCAR Graphics manual, and the original footer said it was from UNIX, dated July 1997. slay, bye bestie! 🌸✨