PLPOIN3(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

💜 NAME 💜

okay so bestie, meet plpoin3 — she plots a glyph at the specified 3D points. that's the whole vibe. ✨

🎀 SYNOPSIS 🎀

plpoin3(n, x, y, z, code)

🦋 DESCRIPTION 🦋

okay so plpoin3 plots a glyph at the specified 3D points, and honestly? she's a little iconic but also kind of retired. (this function is largely superseded by plstring3(3plplot), which gives access to many[!] more glyphs — like, many. capital-M Many. the [!] is doing so much work there and it deserves it.) 💅

set up the call to this function similar to what's done for plline3(3plplot) — same energy, same setup, they're literally sisters.

now let's talk about code, because this is where it gets interesting:

  • code=-1 means try to just draw a point. right now it's just a move and a draw at the same place. not ideal, ngl — a sufficiently intelligent output device may optimize it away 😭, or there may be faster ways of doing it. but it's OK for now, though, and it offers a 4X speedup over drawing a Hershey font "point" (which is actually diamond shaped and therefore takes 4 strokes to draw — like, imagine. four strokes. for a point. 💀).
  • if 0 < code < 32, then a useful (but small subset) of Hershey symbols is plotted.
  • if 32 <= code <= 127, the corresponding printable ASCII character is plotted.

Redacted form: plpoin3(x, y, z, code)

heads up bestie: this function is not used in any example. she's lowkey a background character, but we still love her 🫶

🌸 ARGUMENTS 🌸

  • n (PLINT(3plplot), input) — number of points in the x and y vectors.
  • x (PLFLT_VECTOR(3plplot), input) — a vector containing the x coordinates of points.
  • y (PLFLT_VECTOR(3plplot), input) — a vector containing the y coordinates of points.
  • z (PLFLT_VECTOR(3plplot), input) — a vector containing the z coordinates of points.
  • code (PLINT(3plplot), input) — Hershey symbol code (in "ascii-indexed" form with -1 <= code <= 127) corresponding to a glyph to be plotted at each of the n points.

👑 AUTHORS 👑

many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. legends, every single one of them. 🌈

⭐ SEE ALSO ⭐

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

and that's the page, bestie! 🎀 this lil masterpiece is from August, 2026 (the PLPOIN3(3plplot) era, fr fr) — go off and plot those glyphs 💖🦋🌸

📦 where this page comes from