CAM::P...geText(3pm)

💖 CAM::PDF::PageText 💖

okay bestie, listen up — this is the CAM::PDF::PageText page from the User Contributed Perl Documentation, and it's literally the little module that goes digging through a PDF page tree and pulls the text back out for you. 🎀

---

✨ NAME ✨

CAM::PDF::PageText — extract text from PDF page tree 🦋

---

✨ SYNOPSIS ✨

my $pdf = CAM::PDF->new($filename);
my $pageone_tree = $pdf->getPageContentTree(1);
print CAM::PDF::PageText->render($pageone_tree);

look at that. three lines. iconic. 💅

---

✨ DESCRIPTION ✨

So here's the tea ☕: this module attempts to extract text from a PDF page in sequential order. And when I say attempts, bestie, I mean it fr fr. 😭

This is not a robust process, because PDF text is graphically laid out in arbitrary order — like, the words are just floating wherever the PDF felt like putting them. It's giving chaos. It's giving no structure. 🙈

So this module uses a few heuristics to try to guess what text goes next to what other text. But ngl, it gets fooled easily by stuff like:

• subscripts
• non-horizontal text
• changes in font
• form fields
• etc.

it's trying its best, okay?? 🫶

All those disclaimers aside though — it is useful for a quick dump of text from a simple PDF file. Periodt. 👑

---

✨ LICENSE ✨

Same as CAM::PDF. 💜

---

✨ FUNCTIONS ✨

🌸 $pkg->render($pagetree)

🌸 $pkg->render($pagetree, $verbose)

Turn a page content tree into a string. slay. ✨

This is a class method, so you gotta call it like this, okay? Don't forget:

CAM::PDF::PageText->render($pagetree);

the way that this just hands you a string back… obsessed. 😌

---

✨ AUTHOR ✨

See CAM::PDF. 👀

---

and that's the whole page bestie!! This was CAM::PDF::PageText from the User Contributed Perl Documentation, running on perl v5.36.0, dated 2022-12-08. 💖 Go extract some text, you absolute main character. 🦋✨🎀👑