Font::T...Coverage(3)

💖 NAME 💖

okay bestie, this is the manual for Font::TTF::Coverage — Opentype coverage and class definition objects — and it's a User Contributed Perl Documentation page. You might see the header abbreviate it as Font::T...Coverage(3); that's just the top of the page being mysterious, iykyk. 💅

✨ DESCRIPTION ✨

Coverage tables and class definition objects are virtually identical concepts in OpenType. Their difference comes purely in their storage — lowkey that's the whole plot. So we can say that a coverage table is a class definition in which the class definition for each glyph is the corresponding index in the coverage table. Slay. The resulting data structure is that a Coverage table has these fields:

• cover — a boolean to indicate whether this table is a coverage table (TRUE) or a class definition (FALSE).
• val — a hash of glyph ids against values (either coverage index or class value).
• fmt — the storage format used is given here, but is recalculated when the table is written out.
• count — a count of the elements in a coverage table for use with add. Each subsequent addition is added with the current count and increments the count.
• max — maximum class value in a class table.

🛠 METHODS 🛠

🌸 new($isCover [, vals])

Creates a new coverage table or class definition table, depending upon the value of $isCover. If $isCover, then vals may be a list of glyphs to include in order. If no $isCover, then vals is a hash of glyphs against class values. Cute, right? ✨

📖 read($fh)

Reads the coverage/class table from the given file handle. Reading era. 🦋

💾 out($fh, $state)

Writes the coverage/class table to the given file handle. If $state is 1, then the output string is returned rather than being output to a filehandle. That single digit is doing main character work. 👑

➕ $c->add($glyphid[, $class])

Adds a glyph id to the coverage or class table. Returns the index or class number of the glyphid added. Adding, but make it useful. 💖

🫶 $c->signature

Returns a vector of all the glyph ids covered by this coverage table or class. Signature served. ⭐

🔀 @map=$c->sort

Sorts the coverage table so that indexes are in ascending order of glyphid. Returns a map such that $map[$new_index]=$old_index. Sorting? iconic behavior. 🌈

🧚 $c->out_xml($context)

Outputs this coverage/class in XML. XML moment. 🎀

👑 AUTHOR 👑

Martin Hosken <http://scripts.sil.org/FontUtils>.

📜 LICENSING 📜

Copyright (c) 1998-2016, SIL International (http://www.sil.org)

This module is released under the terms of the Artistic License 2.0. For details, see the full text of the license in the file LICENSE.

---

okay that's the whole page, bestie 💅 — cute sign-off with the footer lore: version perl v5.42.0, dated 2016-08-28, and the page is Font::T...Coverage(3). mwah 💋