PLADV(3plplot)

💅 NAME 💅

pladv — advance the (sub-)page, bestie. That's it, that's the whole vibe. It's giving "turn the page" but make it graphics ✨

---

🦋 SYNOPSIS 🦋

pladv(page)

---

🎀 DESCRIPTION 🎀

Okay so picture this: you're chilling on a subpage. If sub=0, pladv takes you to the next subpage — and lowkey, if there are no remaining subpages on the current page, it straight up performs a page advance. Iconic behavior, no notes 💅

If subpages aren't being used at all? Then pladv(3plplot)(0) will always advance the page. Every single time. That's the whole personality.

Now, if page>0, PLplot switches you to the specified subpage. And here's the thing — this lets you overwrite a plot on that specified subpage 😭 so if that is not what you intended, do yourself a favor and use pleop(3plplot) followed by plbop(3plplot) to first advance the page. Learn from my mistakes, bestie 🫶

Also important, fr fr: this routine gets called automatically (with page=0) by plenv(3plplot). But if you're not using plenv(3plplot), then you absolutely must call pladv(3plplot) after initializing PLplot but before defining the viewport. Non-negotiable. Do not skip this step 🙈

Redacted form: pladv(page)

This function is used in examples 1, 2, 4, 6-12, 14-18, 20, 21, 23-27, 29, and 31. She's everywhere. Main character energy 👑

---

🌸 ARGUMENTS 🌸

• page (PLINT(3plplot), input) — Specifies the subpage number (starting from 1 in the top left corner and increasing along the rows) to which to advance. Set it to zero to advance to the next subpage (or to the next page if subpages aren't being used). Zero = "next please 💅", positive number = "take me exactly there ✨"

---

👑 AUTHORS 👑

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

---

⭐ SEE ALSO ⭐

PLplot documentation at http://plplot.sourceforge.net/documentation.php. Go read it, it's giving knowledge 🌈

---

okay that's the whole page bestie, go forth and advance those subpages 🦋💜

August, 2026 — that's the date, and the source/version is the PLplot API itself, PLADV(3plplot), slay 🎀✨