PLPTEX3(3plplot)

✨ PLPTEX3 ✨

Okay bestie, welcome to PLPTEX3(3plplot) — the PLplot API page for the one and only plptex3. This is the 3D text-writing queen of the library. 💅

---

🌸 NAME 🌸

plptex3 — write text inside the viewport of a 3D plot. Yes, actual text, in actual 3D space. It's giving main character energy for your labels. ✨

---

🦋 SYNOPSIS 🦋

plptex3(wx, wy, wz, dx, dy, dz, sx, sy, sz, just, text)

---

💖 DESCRIPTION 💖

So here's the vibe: plptex3 writes text at a specified position, with a specified inclination, and with a specified shear, all within the viewport. And text is clipped at the viewport boundaries — so if your label tries to escape, it gets cut off. No cap. ✂️

The reference point of a string lies along a line that passes through the string at half the height of a capital letter. The position of that reference point along the line is determined by just, and then the reference point gets placed at world coordinates (wx, wy, wz) within the viewport. 🎯

The inclination and shear of the string are specified in terms of differences of world coordinates, which makes it easy to write text parallel to a line in a graph. Lowkey genius behavior. 🌈

Redacted form: plptex3(x, y, z, dx, dy, dz, sx, sy, sz, just, text)

This function is used in example 28. 🫶

---

🎀 ARGUMENTS 🎀

• wx (PLFLT(3plplot), input) — x world coordinate of the reference point of the string. 📍
• wy (PLFLT(3plplot), input) — y world coordinate of the reference point of the string. 📍
• wz (PLFLT(3plplot), input) — z world coordinate of the reference point of the string. 📍
• dx (PLFLT(3plplot), input) — together with dy and dz, this specifies the inclination of the string. The baseline of the string is parallel to a line joining (x, y, z) to (x+dx, y+dy, z+dz). 📐
• dy (PLFLT(3plplot), input) — together with dx and dz, this specifies the inclination of the string. 📐
• dz (PLFLT(3plplot), input) — together with dx and dy, this specifies the inclination of the string. 📐
• sx (PLFLT(3plplot), input) — together with sy and sz, this specifies the shear of the string. The string is sheared so that the characters are vertically parallel to a line joining (x, y, z) to (x+sx, y+sy, z+sz). If sx = sy = sz = 0. then the text is not sheared. 🌀
• sy (PLFLT(3plplot), input) — together with sx and sz, this specifies shear of the string. 🌀
• sz (PLFLT(3plplot), input) — together with sx and sy, this specifies shear of the string. 🌀
• just (PLFLT(3plplot), input) — specifies the position of the string relative to its reference point. If just=0., the reference point is at the left, and if just=1., it is at the right of the string. Other values of just give intermediate justifications. ⚖️
• text (PLCHAR_VECTOR(3plplot), input) — a UTF-8 character string to be written out. 🗒️

---

👑 AUTHORS 👑

Many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. Icons, all of them. 🫡

---

⭐ SEE ALSO ⭐

PLplot documentation at http://plplot.sourceforge.net/documentation.php. Go read it, iykyk. 📚

---

That's the whole page, bestie — go forth and annotate your 3D plots with impeccable placement and zero fear of the viewport boundary. Slay. 💖

PLplot API · PLPTEX3(3plplot) · August, 2026 🎀