TDPLCH(3NCARG)

💖 TDPLCH — the NCAR Graphics girlie's guide 💖

okay so bestie, welcome to the TDPLCH(3NCARG) page from the NCAR GRAPHICS manual, and honestly? this one is a whole mood. it draws a character string at a specified position in the plane of the reference parallelogram. that's it. that's the function. and we're gonna stan it responsibly. ✨

---

✨ NAME ✨

TDPLCH — draw a character string at a specified position in the plane of the reference parallelogram. yes, literally just that, and she does it beautifully. 💅

---

✨ SYNOPSIS ✨

CALL TDPLCH (XPOS, YPOS, CHRS, SIZE, ANGD, CNTR)

---

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_tdplch(float xpos, float ypos, char *chrs, float size, float
angd, float cntr)

(not the line break in the middle of the signature being kinda dramatic 😭 that's just how she's written, we keep it exactly as-is, no cap)

---

🌸 DESCRIPTION 🌸

so the arguments of TDPLCH are, like, the whole personality of this routine, and here they are one by one:

• XPOS and YPOS — (input expressions of type REAL) these are the parallelogram coordinates of a point relative to which the character string is to be positioned. think of it as where the string is gonna hang out, in parallelogram-space. 🦋
• CHRS — (input, of type CHARACTER) a string suitable for input to the PLOTCHAR routine PLCHHQ. so like, if PLCHHQ can eat it, TDPLCH can serve it. 🍓
• SIZE — (an input expression of type REAL) this one specifies the width of the characters to be used as a multiple of the "X" dimension of the reference parallelogram. and here's the tea: if the reference parallelogram is not a square, distortion of the characters is to be expected — for example, if the reference parallelogram is twice as wide as it is high, then the same will be true of characters drawn by TDPLCH. so she's gonna stretch right along with your parallelogram, and that's on purpose, not a bug. 💀
• ANGD — (an input expression of type REAL) specifies the angle, in degrees, at which the character string is to be drawn relative to the reference parallelogram. the mapping is:
  • 0 => in the direction of positive X
  • 90 => in the direction of positive Y
  • 180 => in the direction of negative X
  • and so on. 🔥
• CNTR — (an input expression of type REAL) specifies how the character string is to be centered relative to the point (XPOS,YPOS) within the reference parallelogram. so:
  • if CNTR = -1, the leading edge of the character string will be placed at (XPOS,YPOS)
  • if CNTR = 0, the center of the character string will be placed at (XPOS,YPOS)
  • if CNTR = +1, the trailing edge of the character string will be placed at (XPOS,YPOS)
  • other values may be used, with the logical results — for example, if CNTR = -.5, the point halfway between the leading edge and the center of the character string will be placed at (XPOS,YPOS) 👑

---

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. like, identical. no plot twist. 🫶

---

🌈 ACCESS 🌈

to use TDPLCH or c_tdplch, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, do not freestyle this one. ⭐

---

🎀 SEE ALSO 🎀

online, the whole friend group is: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs. the group chat is poppin. 🧚

---

👑 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, every flag, every value, every library, every cousin routine — nothing skipped, nothing invented, periodt. 💖

and for the cute sign-off: this page comes from the UNIX manual, dated July 1997, filed under TDPLCH(3NCARG). old page, still slaying. bye bestie, go draw some strings. 🎀✨