TDLBLA(3NCARG)

✨ TDLBLA — bestie, let's label a box edge 💅

okay so this is TDLBLA, a lil routine from the NCAR GRAPHICS collection (that's the manual it lives in, 3NCARG), and its whole entire job is putting labels on one particular edge of a box. that's it. that's the gig. and honestly? she ate. 👑

🌸 SYNOPSIS 🌸

CALL TDLBLA (IAXS, ILBL, NLBL, XAT0, XAT1, YAT0, YAT1, ANGD)

🎀 C-BINDING SYNOPSIS 🎀

#include <ncarg/ncargC.h>

void c_tdlbla(int iaxs, char* ilbl, char* nlbl, float xat0, float xat1,
float yat0, float yat1, float angd)

🦋 DESCRIPTION 🦋

so here's the vibe check first, because the setup matters, bestie. before you call this, it's assumed that TDPARA has already been called to define the reference parallelogram as a rectangle in 3-space, sitting in one corner of one face of the box you're labelling. and the sides of that rectangle? assumed to be vectors of length 1. yep — the rectangle defines a unit square within that face of the box. very demure, very mindful, very unit-y. ✨

it's ALSO assumed that the internal parameter 'CS2' has been set the same way TDLBLS would reset it, using a code sequence like this:

CALL TDGETR ('CS1',CSM1)
CSM2=CSM1*MIN(UMAX-UMIN,VMAX-VMIN,WMAX-WMIN)
CALL TDSETR ('CS2',CSM2)

(where UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX are as defined for a call to TDLBLS — no cap, go check that page if you need them.) 🫶

and now, the moment you've all been waiting for — the arguments of TDLBLA are as follows:

• IAXS — (an input expression of type INTEGER) tells you which edge of the face is getting labelled: 1 => left, 2 => right, 3 => bottom, and 4 => top. and the meanings of "left", "right", "bottom", and "top" are defined by the orientation of the reference parallelogram. so like, don't @ me, it's all relative. 💫
• ILBL — (input, of type CHARACTER) a string used as an informational label. if the string is blank, no informational label gets written. that's it, that's the deal. 🙈
• NLBL — (input, of type CHARACTER) a string containing numeric labels. the labels don't need to be in any particular order, but they DO have to be separated by blanks, and each one has to be readable using a FORTRAN format of the form "En.0", where "n" is the length of the label. if the string is blank, no informational label is written. (yes, the manpage says "informational" there too — iconic typo energy, we keep it exactly as-is. 💀)
• XAT0 and XAT1 — (input expressions of type REAL) the values of "X" associated with the left and right edges of the face being labelled, where "left" and "right" are defined in terms of the current reference parallelogram.
• YAT0 and YAT1 — (input expressions of type REAL) the values of "Y" associated with the bottom and top edges of the face being labelled, where "bottom" and "top" are defined in terms of the current reference parallelogram.
• ANGD — (an input expression of type REAL) specifies the angle, in degrees, at which the labels are to be written. this angle is defined with reference to the current reference parallelogram. tilt her, queen. 📐✨

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. copy-paste sisterhood. no notes. 🎀

🌈 ACCESS 🌈

to use TDLBLA or c_tdlbla, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. (in that order!! don't get cute with it, bestie.) ⭐

👑 SEE ALSO 👑

Online, your girl recommends a little reading list: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs. iykyk. go click around. 🔥

🍓 COPYRIGHT 🍓

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

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

📜 real talk, bestie: that license thing isn't decoration, it's the law. read it before you ship. periodt.

and that's the whole page, babe 💖 this one's from the UNIX manual, dated July 1997, and yes — TDLBLA(3NCARG) is the name on her birth certificate. stan a 1997 queen who's still labeling box edges in 3-space. 🧚💜