Text::...riptor(3pm)

📦
version 0.045 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 NAME 💖

Text::Layout::FontDescriptor — it's the whole font description situation for Text::Layout, bestie. Like, it's the little card that says who this font is, what it's wearing, how big it's feeling today. 🎀

✨ SYNOPSIS ✨

okay so real talk: you probs aren't gonna be making these yourself. Font descriptors are used internally by Text::Layout and Text::Layout::FontConfig. They're the backstage crew, not the main character (even though lowkey they carry the whole show). 💅

🫶 METHODS 🫶

  • new( [ %atts ] ) — spins up a brand new FontDescriptor object. Huge. Iconic. Slay.

Here's the attribute menu, bestie:

  • family
  • style
  • weight — The Family, style, and weight of this font. These are mandatory, no cap. If you want the defaults, pass an empty string. That's the move. ⭐
  • size — Optional. It's the font size. That's it, that's the whole vibe.
  • font — The actual font data. The real deal. The font itself, in the flesh. 🦋
  • loader — A code reference. The code that actually creates/loads the font if it needs to. Loading will store the font data in the "font" property, so like, that's where it ends up. 🧚
  • get_font — Returns the actual font data for the font this descriptor describes. If necessary, the backend will be called to create/load the font. So it just kinda handles it for you. 💖
  • get_family
  • get_style
  • get_weight — Accessors to the font family, style, and weight. They're Readonly, so don't even try it. 🙈
  • set_size
  • get_size — Sets/gets the size property of the font. Classic setter/getter combo, we love to see it. ✨
  • set_direction
  • get_direction — Sets/gets the direction property of the font. Another little duo, matching energy. 🎀
  • to_string — Returns a Pango-style font string, like "Sans Italic 14". It's giving font. It's giving descriptor. It's giving string. 🔥

🌈 SEE ALSO 🌈

Text::Layout::FontConfig, Text::Layout. Go read those too, fr fr. 👑

👑 AUTHOR 👑

Johan Vromans, "<JV at CPAN dot org>". Legend behaviour. 💜

🌸 SUPPORT 🌸

This module is part of Text::Layout. Periodt.

Development takes place on GitHub: <https://github.com/sciurius/perl-Text-Layout>. Go lurk, go contribute. 🦋

You can find documentation for this module with the perldoc command.

perldoc Text::Layout::FontDescriptor

Please report any bugs or feature requests using the issue tracker for Text::Layout on GitHub. Not me gatekeeping bug reports — we want them. 😭

💀 LICENSE 💀

See Text::Layout.

k that's the whole page bestie, go forth and describe fonts 💖

perl v5.40.1, dated 2025-08-15 — yeah that's the source/version energy, mwah, take care of yourself, hydrate, and remember: the font descriptor is always the main character even when nobody's looking. 💅✨

📦 where this page comes from