PLSPAGE(3plplot)

💅 PLSPAGE — like, the page-parameter setter, bestie

So this is a page out of the PLplot API manual (3plplot section, iykyk), and today's main character is plspage. Buckle up 🎀

---

✨ SYNOPSIS ✨

plspage(xp, yp, xleng, yleng, xoff, yoff)

That's the whole vibe check. Six little arguments, one big page glow-up. 🦋

---

🌸 DESCRIPTION 🌸

Okay so plspage sets your page configuration — and yes, it's optional, no pressure babe 🫶. Here's the tea: if any individual parameter is zero, that parameter value just does not get updated. Not zeroed out, not reset — not touched. Respect the boundaries.

Now, lowkey important: not all parameters are recognized by all drivers, and the interpretation is device-dependent. So like, your driver might read the assignment and your driver might not. It's giving "group project" 😭.

The X-window driver uses the length and offset parameters to work out the window size and location. And the length and offset values? Those are expressed in units that are specific to the current driver. For instance 👇

• screen drivers will usually interpret them as number of pixels
• printer drivers will usually use mm

So don't come in assuming units, bestie. Read the room (and the driver).

⚠️ Timing matters, no cap: this routine, if used, must be called before initializing PLplot. Past that point, it may still be called at later times for interactive drivers — but only to change just the dpi for subsequent redraws, which you can force via a call to plreplot(3plplot). That's the one narrow window, periodt.

And if you just... never call this function? Then the page size defaults to landscape A4 for drivers which use real world page sizes, and 744 pixels wide by 538 pixels high for raster drivers. The default value for dx and dy is 90 pixels per inch for raster drivers. So there's a whole default lewk already happening without you 💅.

Redacted form: plspage(xp, yp, xleng, yleng, xoff, yoff)

This function is used in examples 14 and 31. Iconic cameos, honestly 👑

---

💖 ARGUMENTS 💖

• xp (PLFLT(3plplot), input) — Number of pixels per inch (DPI), x. Used only by raster drivers, and straight-up ignored by drivers which use "real world" units (e.g. mm). She doesn't even show up to that party 🙈
• yp (PLFLT(3plplot), input) — Number of pixels per inch (DPI), y. Same deal: used only by raster drivers, ignored by drivers which use "real world" units (e.g. mm).
• xleng (PLINT(3plplot), input) — Page length, x. 📏
• yleng (PLINT(3plplot), input) — Page length, y. 📏
• xoff (PLINT(3plplot), input) — Page offset, x. 📍
• yoff (PLINT(3plplot), input) — Page offset, y. 📍

---

👑 AUTHORS 👑

Many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. A whole ensemble cast, main character energy all around 🌈💜

---

🦋 SEE ALSO 🦋

PLplot documentation at http://plplot.sourceforge.net/documentation.php — go read it, bestie, it's giving lore ✨

---

Okay that's the whole page, no notes, slay. 💅 This lil walkthrough came straight out of the PLplot API manual vibes, dated August, 2026 — so go forth and configure your pages with confidence 🎀🌸