Text::...:TTFont(3pm)

✨ NAME ✨

okay so bestie, meet Text::PDF::TTFont 💖 — she inherits from Text::PDF::Dict, and she represents a TrueType font inside a PDF file. that's it, that's the girl. 👑

---

🌸 DESCRIPTION 🌸

fr fr, a font in a PDF is made of two primary parts: the header and the font descriptor. and here's the tea ☕ — two different fonts can totally share the same font descriptors, but they each get their own header dictionaries. those header dicts are where the encoding and width info lives. sharing is caring, but headers are personal. 💅

---

🦋 INSTANCE VARIABLES 🦋

literally nothing extra here, bestie. there are no instance variables beyond the ones that directly correspond to entries in the appropriate PDF dictionaries. that's the whole vibe. ✨

---

💖 METHODS 💖

Text::PDF::TTFont->new($parent, $fontfname, $pdfname, %opts)

makes a whole new font resource for the given fontfile 🎀 — and when I say whole, I mean it: this includes the font descriptor and the font stream. the $pdfname is the name this font resource will be known by throughout one particular PDF file. like, her government name. 🫶

heads up: all font resources are full PDF objects. no halfsies. ⭐

$t->width($text)

measures the width of the given text, using the widths stored in the font. it's giving ruler energy. 📏

$t->trim($text, $len)

trims the given text down to the given length (in per mille em) and hands you back the trimmed text. ✂️

$t->out_text($text)

tells the font that this text is about to be output, and returns the text to be output. it's a heads-up text, basically. 🔥

$f->copy

copies the font object — but excluding the name, widths and encoding, etc. so like, the aesthetic, not the identity. 🙈

---

👑 TITLE 👑

okay so this part is about Text::PDF::TTIOString — an internal IO type handle for string output for font embedding 🧚. and ngl, this code is ripped out of IO::Scalar, literally just to save the direct dependence for so little. so if you want the details, go see IO::Scalar. iykyk. 💜

---

and that's the whole page, bestie!! 🌈 this was Text::PDF::TTFont(3pm) from the User Contributed Perl Documentation, running on perl v5.36.0, dated 2022-10-22. slay, go forth and embed some fonts 💖✨🎀