PLMTEX3(3plplot)

💖 PLMTEX3 (3plplot) — the PLplot API's own lil text-placer for 3D plots 💖

okay bestie, welcome to plmtex3 from the PLplot API — yes the whole manual page header said PLMTEX3(3plplot) and honestly? iconic. it's the 3D sibling of the text-placing girls and she is serving.

---

✨ NAME ✨

plmtex3 — write text relative to viewport boundaries in 3D plots 🎀

---

🦋 SYNOPSIS 🦋

plmtex3(side, disp, pos, just, text)

---

🌸 DESCRIPTION 🌸

so what she does is: she writes text at a specified position relative to the viewport boundaries. that's it, that's the gig. 💅

the text can go inside or outside the viewport — no judgment — but heads up: it's clipped at the subpage boundaries. so if you're trying to be extra and your label runs off the subpage, it gets cut. sad but true.

here's the lore on the reference point, because this is the part everyone gets confused about: the reference point of a string lies along a line that passes through the string at half the height of a capital letter. ngl that's a very specific little guy but okay. the position of the reference point along that line is decided by just, and where the reference point sits relative to the viewport is decided by disp and pos. two different axes of decision-making, she contains multitudes.

Redacted form: plmtex3(side, disp, pos, just, text)

also she's famous — this function is used in example 28. ✨ main character energy fr.

---

👑 ARGUMENTS 👑

• side (PLCHAR_VECTOR(3plplot), input) — an ascii character string that says which side of the viewport the text gets written along. it should contain one or more of these characters: [xyz][ps][v]. and listen: only one label is drawn at a time, like xyp will only label the X axis, not both the X and Y axes. one at a time, she's monogamous with your axes. the letters mean:
  • x: label the X axis.
  • y: label the Y axis.
  • z: label the Z axis.
  • p: label the primary axis. for Z this is the leftmost Z axis. for X it is the axis that starts at y-min. for Y it is the axis that starts at x-min.
  • s: label the secondary axis.
  • v: draw the text perpendicular to the axis.
• disp (PLFLT(3plplot), input) — position of the reference point of the string, measured outwards from the specified viewport edge, in units of the current character height. and here's the trick 🫶: use a negative disp to write within the viewport. yes, negative means inside. write that down.
• pos (PLFLT(3plplot), input) — position of the reference point of the string along the specified edge, expressed as a fraction of the length of that edge. fraction of the edge, not pixels, not vibes. 🍓
• just (PLFLT(3plplot), input) — specifies where the string sits relative to its reference point. if just=0. the reference point is at the left of the string, and if just=1. it's at the right of the string. other values of just give you the intermediate justifications in between — yes, she interpolates, she's flexible like that. 💜
• text (PLCHAR_VECTOR(3plplot), input) — a UTF-8 character string to be written out. unicode girlies rise 🌈

---

🧚 AUTHORS 🧚

many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. so many legends, honestly the group chat has been going for decades. no cap.

---

⭐ SEE ALSO ⭐

PLplot documentation at http://plplot.sourceforge.net/documentation.php. go read it, iykyk. 🔥

---

lowkey a reminder: text gets clipped at the subpage boundaries. that's not a bug, that's just how she is. plan your labels accordingly bestie. 💀

---

and that's the whole page!! 🌸 source/version: PLplot API, dated August, 2026 — PLMTEX3(3plplot) forever and always. mwah 💋✨🎀