Font::TTF::Kern(3)

🦋 Font::TTF::Kern(3) — Kerning tables 🦋

okay so bestie, welcome to Font::TTF::Kern(3) from the User Contributed Perl Documentation 🌈 this page has main character energy and it’s literally all about kerning tables. no cap, it’s giving “someone who actually knows Unix explaining it to their bestie” 💖

🌸 NAME 🌸

Font::TTF::Kern - Kerning tables ✨

✨ DESCRIPTION ✨

okay so the way that kerning tables are held? it’s as an ordered collection of subtables, and each subtable gives incremental info about the kerning of various pairs of glyphs. fr fr, that’s the vibe.

The basic structure of the kerning data structure is:

$kern = $f->{'kern'}{'tables'}[$tnum]{'kerns'}{$leftnum}{$rightnum};

Due to the possible complexity of some kerning tables, that info above is not enough, bestie 😭 ngl you also need to reference the type of the table and the coverage field. iykyk.

💅 INSTANCE VARIABLES 💅

The instance variables for a kerning table are relatively straightforward. not me saying that, but slay periodt.

💖 Version 💖

Version number of the kerning table.

💖 Num 💖

Number of subtables in the kerning table.

💖 tables 💖

Array of subtables in the kerning table.

Each subtable has a number of instance variables.

🎀 kern 🎀

A two level hash array containing kerning values. The indexing goes via left class and right class. It may seem using hashes is strange, but most tables are not type 2 and this method saves empty array values.

🎀 type 🎀

Stores the table type. Only type 0 and type 2 tables are specified for TrueType so far.

🎀 coverage 🎀

A bit field of coverage information regarding the kerning value. See the TrueType specification for details.

🎀 Version 🎀

Contains the version number of the table.

🎀 Num 🎀

Number of kerning pairs in this type 0 table.

🎀 left 🎀

An array indexed by glyph - left_first which returns a class number for the glyph in type 2 tables.

🎀 right 🎀

An array indexed by glyph - right_first which returns a class number for the glyph in type 2 tables.

🎀 left_first 🎀

The glyph number of the first element in the left array for type 2 tables.

🎀 right_first 🎀

The glyph number of the first element in the right array for type 2 tables.

🎀 num_left 🎀

Number of left classes.

🎀 num_right 🎀

Number of right classes.

🛠 METHODS 🛠

🔥 $t->read 🔥

Reads the whole kerning table into structures.

🔥 $t->out($fh) 🔥

Outputs the kerning tables to the given file.

🔥 $t->XML_element($context, $depth, $key, $value) 🔥

Handles outputting the kern hash into XML a little more tidily.

🔥 $t->minsize() 🔥

Returns the minimum size this table can be. If it is smaller than this, then the table must be bad and should be deleted or whatever.

💀 BUGS 💀

• Only supports kerning table types 0 & 2.
• No real support functions to do anything with the kerning tables yet.

👑 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.

---

mwah 💋 cute sign-off time: perl v5.42.0 · 2016-08-28 · Font::TTF::Kern(3) — bye bestie, go kern those pairs 🫶