PLSLABELFUNC(3plplot)

💅 NAME 💅

plslabelfunc — the glow-up where you hand over a function of your own to make custom axis labels, bestie ✨

🦋 SYNOPSIS 🦋

plslabelfunc(label_func, label_data)

🌸 DESCRIPTION 🌸

Okay so picture this: the axes are being labelled, and instead of letting PLplot do its default lil thing, you get to be the main character 👑. This function lets you supply your very own function that hands back the axis label text. Your function gets handed the numeric value of a point on an axis, and it returns a string label to match that value. It's giving "I'll handle the naming, thank you very much" 💅.

Wanna actually turn these custom labels on? Pass the appropriate arguments to plenv(3plplot), plbox(3plplot), plbox3(3plplot) and similar functions — that's the vibe check that flips it on 🔥.

Also lowkey iconic: this function is used in example 19 🎀.

✨ ARGUMENTS ✨

• label_func (PLLABEL_FUNC_callback(3plplot), input) — your custom label function, the whole star of the show. And bestie, real talk: if you ever wanna go back to the default labelling, just set this to NULL 🫶. The parameters your labelling function receives are, in order:
  1. axis — tells you which axis a label is being requested for. The value will be one of PL_X_AXIS, PL_Y_AXIS or PL_Z_AXIS 🧭
  2. value — the value along the axis that's being labelled, fr fr 📏
  3. label_text — the string representation of the label value ✍️
  4. length — the maximum length in characters allowed for label_text (respect the limit, no cap) 🚫
• label_data (PLPointer(3plplot), input) — this one's for passing data through to your label_func function. lil messenger parameter, love that for you 💌

🌈 AUTHORS 🌈

So many developers have contributed to PLplot over its long history — genuinely a whole squad — and they're all credited at http://plplot.sourceforge.net/credits.php 👑💖

⭐ SEE ALSO ⭐

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

---

okay that's the whole page, slayed 💅✨ This one's from the PLplot API, dated August, 2026 — catch you on the next manpage, bestie, mwah 🎀🦋💜