TDGETI(3NCARG)

💖 TDGETI — bestie, we're getting a parameter 💖

okay so this is a page from the NCAR GRAPHICS manual, and it's all about TDGETI(3NCARG) — a little routine that reaches into Tdpack and pulls out an integer for you. it's giving "personal assistant for parameter values" honestly. 🫶

---

✨ NAME ✨

TDGETI — retrieves the integer value of a Tdpack parameter. that's it. that's the whole job. iconic behavior. 💅

---

✨ SYNOPSIS ✨

CALL TDGETI (PNAM,IVAL)

that's the FORTRAN girlies' way in. ✨

---

✨ C-BINDING SYNOPSIS ✨

for the C girlies, you gotta include this first:

#include <ncarg/ncargC.h>

and then the call itself looks like:

void c_tdgeti (char *pnam, int *ival)

---

✨ DESCRIPTION ✨

so the arguments of TDGETI are literally just these two, and here's the tea on each of them:

• PNAM — an input constant or variable of type CHARACTER. this is the name of the parameter you want to retrieve. bestie, listen: the character string can be any length, but only the first three characters of it will be examined. so like… don't get cute with the extra letters, she's not reading them. 🙈
• IVAL — an output variable of type INTEGER. this is the integer variable that receives the desired parameter value. now here's how the handoff works: if the internal parameter is of type INTEGER and has the value "i", then IVAL will be given the value "i". but if the internal parameter is of type REAL and has the value "r", then IVAL will be given the value INT(r). she converts for you, no cap. 💖

---

✨ C-BINDING DESCRIPTION ✨

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. same energy, different syntax. 🦋

---

✨ USAGE ✨

this routine lets you retrieve the current value of Tdpack parameters. that's the whole vibe check. and for a complete list of parameters available in this utility, go look at the "tdpack_params" man page — she has the full menu. 👑

---

✨ ACCESS ✨

to use TDGETI or c_tdgeti, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. yes bestie, order matters, don't do your own thing here. 🌈

---

✨ MESSAGES ✨

see the "tdpack" man page for a description of all Tdpack error messages and/or informational messages. everything she has to say lives over there. 🎀

---

✨ SEE ALSO ✨

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

like… the whole friend group showed up. we love a supportive squad. 🫶✨

---

✨ 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 was TDGETI(3NCARG) from the NCAR GRAPHICS manual, dated July 1997 on UNIX — and yes, she's still serving after all these years. periodt. 💅🌸✨