PDF::Bu...age::GIF(3)

💖 PDF::Builder::Resource::XObject::Image::GIF(3) 💖

okay bestie, sit down, hydrate, because we're about to talk about the GIF image library support routines from PDF::Builder. This is PDF::Builder::Resource::XObject::Image::GIF and it inherits from PDF::Builder::Resource::XObject::Image. That's the family tree, no cap. 🌸

---

✨ NAME ✨

PDF::Builder::Resource::XObject::Image::GIF — support routines for the GIF image library, fr fr. 🎀

---

📜 History 📜

• The GIF89a Specification lives at https://www.w3.org/Graphics/GIF/spec-gif89a.txt — go read it if you're feeling academic, queen. 👑
• A pretty thorough description of the GIF format? That's at <http://giflib.sourceforge.net/whatsinagif/bits_and_bytes.html>. Literally everything, bits and bytes, the whole vibe. 🦋
• The code originally came from PDF::Create, PDF::Image::GIFImage — GIF image support. Author: Michael Gross <mdgrosse@sboxtugraz.at>. Giving credit where credit is due, always. 💅

---

🌈 Supported Formats 🌈

So here's what this thing actually eats for breakfast:

• GIF87a and GIF89a headers? Supported. 💚
• The Image block (x2C)? Supported. ✅
• The Graphic Control Extension block (x21 + xF9)? Supported — that's your transparency control, bestie. 👀
• Animation? Not supported. Sorry babe, no moving pictures here. 😭
• The Comment Extension block (x21 + xFE), the Plain Text Extension block (x21 + x01), and the Application Extension block (x21 + xFF) are read but ignored. They show up, we see them, we move on. 💀
• Any other block or Extension block? > 🚨 That gets flagged as an error. Don't try it.

And if Local Color Tables are given, they're read and used — which supposedly lets you use more than 256 colors overall in the image, even despite the 8-bit color table depth. Iconic loophole honestly. ✨

---

🎀 Options 🎀

One bullet per option, just how you like it:

• notrans — when it's defined and it's not 0, notrans suppresses the use of transparency if such a thing is defined in the GIF file. So the transparency is there, but we're politely pretending we didn't see it. 🙈
• name => 'string' — this is the name you can give your GIF image object. The default is Gxnnnn. Name your child. 🍼
• multi — when it's defined and it's not 0, multi keeps processing past the end of the first Image Block. The old behavior — which is now the default — is to stop at the end of the first Image Block. So by default we're one-and-done, and multi is the "keep going bestie" switch. 🔥

---

💅 METHODS 💅

🌟 new 🌟

PDF::Builder::Resource::XObject::Image::GIF->new()

Create an image object from a GIF input file. That's it, that's the whole job. 🫶

⚠️ But remember, and I mean remember: this should be invoked via the Builder.pm method! Don't be out here calling it directly like a menace. 😤

---

okay that's the whole page, you ate it, I'm obsessed, periodt. 💖✨🎀🦋🌸💅🫶

this was served fresh from perl v5.42.0, dated 2026-01-17, and yes the header really does abbreviate it as PDF::Bu...age::GIF(3) because even the manual page had to fit in the margins. slay. 👑🌈⭐