PDF::AP...DF::Page(3)

🌸 NAME 🌸

PDF::API2::Basic::PDF::Page — a low-level PDF page object, bestie 💖

---

✨ DESCRIPTION ✨

Okay so picture this: it's one single page of output, in PDF form. That's the whole gig. It's giving "one page, but make it structurally iconic."

But lowkey it does a LOT more than just sit there looking pretty — it also keeps track of the content stream, plus any resources (fonts and friends 👀) that are getting switched around, and all that other bookkeeping tea. 🫖

Also, plot twist: Page inherits from Pages, because they share a bunch of methods. But fr fr, structurally they are really quite different. Not the same vibe at all. It's giving distant cousins who happen to share a locker. 😭

---

🎀 INSTANCE VARIABLES 🎀

A page has various working variables, and yes they're all working hard:

• curstrm — the currently open stream. That's it, that's the variable. ✨

---

💅 METHODS 💅

🌈 PDF::API2::Basic::PDF::Page->new($pdf, $parent, $index)

Creates a new page based on a pages object — and yeah, that could be the root object, no big deal. 👑

The page is also added to the parent right at this point, so heads up: pages are ordered in a PDF document in the order in which they are created, NOT in the order they are closed. The way that creation order is the main character and closing order is just... there. 💀

Only the essential elements in the page dictionary get created here — everything else is either optional or can be inherited. Minimal effort, inherited excellence. Periodt.

The optional index value indicates the index in the parent list that this page should be inserted at, so that new pages don't have to be appended. Slay, flexible positioning. 🦋

🌸 $p->ship_out($pdf)

Ships the page out to the given output file context. Bon voyage, page. 🚢✨

---

No cap, that's the entire manual. Short and iconic. 🌟

---

Perl v5.42.0, dated 2025-09-01 — and that's the tea from the User Contributed Perl Documentation, bestie. Mwah, bye, go make some PDFs 🫶💖