Font::TTF::Dumper(3pm)

Font::TTF::Dumper3pm

Debug dump of a font datastructure, avoiding recursion on ' parent'

Usage

    use Font::TTF::Dumper;
    
    # Print a table from the font structure:
    print ttfdump($font->{$tag});
    
    # Print font table with name
    print ttfdump($font->{'head'}, 'head');
    
    # Print font table with name and other options
    print ttfdump($font->{'head'}, 'head', %opts);
    # Print one glyph's data:
    print ttfdump($font->{'loca'}->read->{'glyphs'}[$gid], "glyph_$gid");

Overview

Font::TTF data structures are trees created from hashes and arrays. When trying to figure out how the structures work, sometimes it is helpful to use Data::Dumper on them. However, many of the object structures have ' PARENT' links that refer back to the object's parent, which means that Data::Dumper ends up dumping the whole font no matter what.

The main purpose of this module is to invoke Data::Dumper with a filter that skips over the ' PARENT' element of any hash.

To reduce output further, this module also skips over ' CACHE' elements and any hash element whose value is a Font::TTF::Glyph or Font::TTF::Font object. (Really should make this configurable.)

If $opts{'d'}, then set Deepcopy mode to minimize use of crossreferencing.

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.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 6 times.

  1. 5.0–6.0
  2. 7
  3. 8
  4. 9–10
  5. 11
  6. 12–13
  7. Arch

Author

Bob Hallissy <http://scripts.sil.org/FontUtils>.

From perl-font-ttf 1.06-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.