PDF::Bu...:BdFont(3)

PDF::Builder::Resource::Font::BdFont 💖

okay bestie, welcome to the User Contributed Perl Documentation corner of the internet, pls pull up a chair 🎀

---

✨ NAME ✨

PDF::Builder::Resource::Font::BdFont — the module for using bitmapped Fonts 🖼️

Also, lowkey important: it inherits from PDF::Builder::Resource::Font 💅

---

🌸 SYNOPSIS 🌸

#
use PDF::Builder;
#
$pdf = PDF::Builder->new();
$sft = $pdf->bdfont($file);
#

---

🦋 DESCRIPTION 🦋

So what's the vibe here? This bad boy creates a bitmapped font from a .bdf file — that's a bitmap distribution font file, iykyk 📼

By default it uses square elements, but you can switch the style to use filled dots instead, which is giving very much dot-matrix printer energy. Either way, the font gets embedded in the PDF file ✨

⚠️ now real talk bestie: bitmapped fonts are quite rough, low resolution, and difficult to read. So unless you're a sadist who wants to force readers back to the good old days of dot-matrix printers and bitmapped X terminals, try to limit the use of such a font to decorative or novelty effects, such as chapter titles and major headings. Have mercy on your readers and use a real font (TrueType, etc.) for body text! 😭🙏

---

👑 METHODS 👑

💅 new

$font = PDF::Builder::Resource::Font::BdFont->new($pdf, $font, %opts)

Returns a BmpFont object 🫶

Valid options (%opts) are:

• style — a value of 'block' (the default) assembles a character from contiguous square blocks ⬛⬛⬛. A value of 'dot' assembles a character from overlapping filled circles, in the style of a dot matrix printer 🔴🔴🔴

---

🌈 AUTHOR 🌈

Alfred Reibenschuh, extensively rewritten by Phil Perry 👑

---

perl v5.42.0 · 2026-01-17 — that's the source/version + date tea bestie, mwah, go forth and be kind to your readers' eyeballs 💜🧚⭐