Introduce src dir.
[librarian.git] / librarian / font-optimizer / ext / Font-TTF / lib / Font / TTF / Font.pm
diff --git a/librarian/font-optimizer/ext/Font-TTF/lib/Font/TTF/Font.pm b/librarian/font-optimizer/ext/Font-TTF/lib/Font/TTF/Font.pm
deleted file mode 100644 (file)
index 8f5cc50..0000000
+++ /dev/null
@@ -1,767 +0,0 @@
-package Font::TTF::Font;
-
-=head1 NAME
-
-Font::TTF::Font - Memory representation of a font
-
-=head1 SYNOPSIS
-
-Here is the regression test (you provide your own font). Run it once and then
-again on the output of the first run. There should be no differences between
-the outputs of the two runs.
-
-    $f = Font::TTF::Font->open($ARGV[0]);
-
-    # force a read of all the tables
-    $f->tables_do(sub { $_[0]->read; });
-
-    # force read of all glyphs (use read_dat to use lots of memory!)
-    # $f->{'loca'}->glyphs_do(sub { $_[0]->read; });
-    $f->{'loca'}->glyphs_do(sub { $_[0]->read_dat; });
-    # NB. no need to $g->update since $f->{'glyf'}->out will do it for us
-
-    $f->out($ARGV[1]);
-    $f->release;            # clear up memory forcefully!
-
-=head1 DESCRIPTION
-
-A Truetype font consists of a header containing a directory of tables which
-constitute the rest of the file. This class holds that header and directory and
-also creates objects of the appropriate type for each table within the font.
-Note that it does not read each table into memory, but creates a short reference
-which can be read using the form:
-
-    $f->{$tablename}->read;
-
-Classes are included that support many of the different TrueType tables. For
-those for which no special code exists, the table type C<table> is used, which
-defaults to L<Font::TTF::Table>. The current tables which are supported are:
-
-    table       Font::TTF::Table      - for unknown tables
-    EBDT        Font::TTF::EBDT
-    EBLC        Font::TTF::EBLC
-    Feat        Font::TTF::GrFeat
-    GDEF        Font::TTF::GDEF
-    GPOS        Font::TTF::GPOS
-    GSUB        Font::TTF::GSUB
-    LTSH        Font::TTF::LTSH
-    OS/2        Font::TTF::OS_2
-    PCLT        Font::TTF::PCLT
-    Sill        Font::TTF::Sill
-    bsln        Font::TTF::Bsln
-    cmap        Font::TTF::Cmap       - see also Font::TTF::OldCmap
-    cvt         Font::TTF::Cvt_
-    fdsc        Font::TTF::Fdsc
-    feat        Font::TTF::Feat
-    fmtx        Font::TTF::Fmtx
-    fpgm        Font::TTF::Fpgm
-    glyf        Font::TTF::Glyf       - see also Font::TTF::Glyph
-    hdmx        Font::TTF::Hdmx
-    head        Font::TTF::Head
-    hhea        Font::TTF::Hhea
-    hmtx        Font::TTF::Hmtx
-    kern        Font::TTF::Kern       - see alternative Font::TTF::AATKern
-    loca        Font::TTF::Loca
-    maxp        Font::TTF::Maxp
-    mort        Font::TTF::Mort       - see also Font::TTF::OldMort
-    name        Font::TTF::Name
-    post        Font::TTF::Post
-    prep        Font::TTF::Prep
-    prop        Font::TTF::Prop
-    vhea        Font::TTF::Vhea
-    vmtx        Font::TTF::Vmtx
-
-Links are:
-
-L<Font::TTF::Table> 
-L<Font::TTF::EBDT> L<Font::TTF::EBLC> L<Font::TTF::GrFeat>
-L<Font::TTF::GDEF> L<Font::TTF::GPOS> L<Font::TTF::GSUB> L<Font::TTF::LTSH>
-L<Font::TTF::OS_2> L<Font::TTF::PCLT> L<Font::TTF::Sill> L<Font::TTF::Bsln> L<Font::TTF::Cmap> L<Font::TTF::Cvt_>
-L<Font::TTF::Fdsc> L<Font::TTF::Feat> L<Font::TTF::Fmtx> L<Font::TTF::Fpgm> L<Font::TTF::Glyf>
-L<Font::TTF::Hdmx> L<Font::TTF::Head> L<Font::TTF::Hhea> L<Font::TTF::Hmtx> L<Font::TTF::Kern>
-L<Font::TTF::Loca> L<Font::TTF::Maxp> L<Font::TTF::Mort> L<Font::TTF::Name> L<Font::TTF::Post>
-L<Font::TTF::Prep> L<Font::TTF::Prop> L<Font::TTF::Vhea> L<Font::TTF::Vmtx> L<Font::TTF::OldCmap>
-L<Font::TTF::Glyph> L<Font::TTF::AATKern> L<Font::TTF::OldMort>
-
-
-=head1 INSTANCE VARIABLES
-
-Instance variables begin with a space (and have lengths greater than the 4
-characters which make up table names).
-
-=over
-
-=item nocsum
-
-This is used during output to disable the creation of the file checksum in the
-head table. For example, during DSIG table creation, this flag will be set to
-ensure that the file checksum is left at zero.
-
-=item noharmony
-
-If set, do not harmonize the script and lang trees of GPOS and GSUB tables. See L<Font::TTF::Ttopen> for more info.
-
-=item fname (R)
-
-Contains the filename of the font which this object was read from.
-
-=item INFILE (P)
-
-The file handle which reflects the source file for this font.
-
-=item OFFSET (P)
-
-Contains the offset from the beginning of the read file of this particular
-font directory, thus providing support for TrueType Collections.
-
-=back
-
-=head1 METHODS
-
-=cut
-
-use IO::File;
-
-use strict;
-use vars qw(%tables $VERSION $dumper);
-use Symbol();
-
-require 5.004;
-
-$VERSION = 0.38;    # MJPH       2-FEB-2008     Add Sill table
-# $VERSION = 0.37;    # MJPH       7-OCT-2005     Force hhea update if dirty, give more OS/2 stuff in update
-# $VERSION = 0.36;    # MJPH      19-AUG-2005     Change cmap::reverse api to be opts based
-# $VERSION = 0.35;    # MJPH       4-MAY-2004     Various fixes to OpenType stuff, separate off scripts
-# $VERSION = 0.34;    # MJPH      22-MAY-2003     Update PSNames to latest AGL
-# $VERSION = 0.33;    # MJPH       9-OCT-2002     Support CFF OpenType (just by version=='OTTO'?!)
-# $VERSION = 0.32;    # MJPH       2-OCT-2002     Bug fixes to TTFBuilder, new methods and some
-#                                                 extension table support in Ttopen and Coverage
-# $VERSION = 0.31;    # MJPH       1-JUL-2002     fix read format 12 cmap (bart@cs.pdx.edu) 
-#                                                 improve surrogate support in ttfremap
-#                                                 fix return warn to return warn,undef
-#                                                 ensure correct indexToLocFormat
-# $VERSION = 0.30;    # MJPH      28-MAY-2002     add updated release
-# $VERSION = 0.29;    # MJPH       9-APR-2002     update ttfbuilder, sort out surrogates
-# $VERSION = 0.28;    # MJPH      13-MAR-2002     update ttfbuilder, add Font::TTF::Cmap::ms_enc()
-# $VERSION = 0.27;    # MJPH       6-FEB-2002     update ttfbuilder, support no fpgm, no more __DATA__
-# $VERSION = 0.26;    # MJPH      19-SEP-2001     Update ttfbuilder
-# $VERSION = 0.25;    # MJPH      18-SEP-2001     problems in update of head
-# $VERSION = 0.24;    # MJPH       1-AUG-2001     Sort out update
-# $VERSION = 0.23;    # GST       30-MAY-2001     Memory leak fixed
-# $VERSION = 0.22;    # MJPH      09-APR-2001     Ensure all of AAT stuff included
-# $VERSION = 0.21;    # MJPH      23-MAR-2001     Improve Opentype support
-# $VERSION = 0.20;    # MJPH      13-JAN-2001     Add XML output and some of XML input, AAT & OT tables
-# $VERSION = 0.19;    # MJPH      29-SEP-2000     Add cmap::is_unicode, debug makefile.pl
-# $VERSION = 0.18;    # MJPH      21-JUL-2000     Debug Utils::TTF_bininfo
-# $VERSION = 0.17;    # MJPH      16-JUN-2000     Add utf8 support to names
-# $VERSION = 0.16;    # MJPH      26-APR-2000     Mark read tables as read, tidy up POD
-# $VERSION = 0.15;    # MJPH       5-FEB-2000     Ensure right versions released
-# $VERSION = 0.14;    # MJPH      11-SEP-1999     Sort out Unixisms, agian!
-# $VERSION = 0.13;    # MJPH       9-SEP-1999     Add empty, debug update_bbox
-# $VERSION = 0.12;    # MJPH      22-JUL-1999     Add update_bbox
-# $VERSION = 0.11;    # MJPH       7-JUL-1999     Don't store empties in cmaps
-# $VERSION = 0.10;    # MJPH      21-JUN-1999     Use IO::File
-# $VERSION = 0.09;    # MJPH       9-JUN-1999     Add 5.004 require, minor tweeks in cmap
-# $VERSION = 0.08;    # MJPH      19-MAY-1999     Sort out line endings for Unix
-# $VERSION = 0.07;    # MJPH      28-APR-1999     Get the regression tests to work
-# $VERSION = 0.06;    # MJPH      26-APR-1999     Start to add to CVS, correct MANIFEST.SKIP
-# $VERSION = 0.05;    # MJPH      13-APR-1999     See changes for 0.05
-# $VERSION = 0.04;    # MJPH      13-MAR-1999     Tidy up Tarball
-# $VERSION = 0.03;    # MJPH       9-MAR-1999     Move to Font::TTF for CPAN
-# $VERSION = 0.02;    # MJPH      12-FEB-1999     Add support for ' nocsum' for DSIGS
-# $VERSION = 0.0001;
-
-%tables = (
-        'table' => 'Font::TTF::Table',
-        'EBDT' => 'Font::TTF::EBDT',
-        'EBLC' => 'Font::TTF::EBLC',
-        'Feat' => 'Font::TTF::GrFeat',
-        'GDEF' => 'Font::TTF::GDEF',
-        'GPOS' => 'Font::TTF::GPOS',
-        'GSUB' => 'Font::TTF::GSUB',
-        'LTSH' => 'Font::TTF::LTSH',
-        'OS/2' => 'Font::TTF::OS_2',
-        'PCLT' => 'Font::TTF::PCLT',
-        'Sill' => 'Font::TTF::Sill',
-        'bsln' => 'Font::TTF::Bsln',
-        'cmap' => 'Font::TTF::Cmap',
-        'cvt ' => 'Font::TTF::Cvt_',
-        'fdsc' => 'Font::TTF::Fdsc',
-        'feat' => 'Font::TTF::Feat',
-        'fmtx' => 'Font::TTF::Fmtx',
-        'fpgm' => 'Font::TTF::Fpgm',
-        'glyf' => 'Font::TTF::Glyf',
-        'hdmx' => 'Font::TTF::Hdmx',
-        'head' => 'Font::TTF::Head',
-        'hhea' => 'Font::TTF::Hhea',
-        'hmtx' => 'Font::TTF::Hmtx',
-        'kern' => 'Font::TTF::Kern',
-        'loca' => 'Font::TTF::Loca',
-        'maxp' => 'Font::TTF::Maxp',
-        'mort' => 'Font::TTF::Mort',
-        'name' => 'Font::TTF::Name',
-        'post' => 'Font::TTF::Post',
-        'prep' => 'Font::TTF::Prep',
-        'prop' => 'Font::TTF::Prop',
-        'vhea' => 'Font::TTF::Vhea',
-        'vmtx' => 'Font::TTF::Vmtx',
-          );
-
-# This is special code because I am fed up of every time I x a table in the debugger
-# I get the whole font printed. Thus substitutes my 3 line change to dumpvar into
-# the debugger. Clunky, but nice. You are welcome to a copy if you want one.
-          
-BEGIN {
-    my ($p);
-
-    foreach $p (@INC)
-    {
-        if (-f "$p/mydumpvar.pl")
-        {
-            $dumper = 'mydumpvar.pl';
-            last;
-        }
-    }
-    $dumper ||= 'dumpvar.pl';
-}
-
-sub main::dumpValue
-{ do $dumper; &main::dumpValue; }
-    
-
-=head2 Font::TTF::Font->AddTable($tablename, $class)
-
-Adds the given class to be used when representing the given table name. It also
-'requires' the class for you.
-
-=cut
-
-sub AddTable
-{
-    my ($class, $table, $useclass) = @_;
-
-    $tables{$table} = $useclass;
-#    $useclass =~ s|::|/|oig;
-#    require "$useclass.pm";
-}
-
-
-=head2 Font::TTF::Font->Init
-
-For those people who like making fonts without reading them. This subroutine
-will require all the table code for the various table types for you. Not
-needed if using Font::TTF::Font::read before using a table.
-
-=cut
-
-sub Init
-{
-    my ($class) = @_;
-    my ($t);
-
-    foreach $t (values %tables)
-    {
-        $t =~ s|::|/|oig;
-        require "$t.pm";
-    }
-}
-
-=head2 Font::TTF::Font->new(%props)
-
-Creates a new font object and initialises with the given properties. This is
-primarily for use when a TTF is embedded somewhere. Notice that the properties
-are automatically preceded by a space when inserted into the object. This is in
-order that fields do not clash with tables.
-
-=cut
-
-sub new
-{
-    my ($class, %props) = @_;
-    my ($self) = {};
-
-    bless $self, $class;
-
-    foreach (keys %props)
-    { $self->{" $_"} = $props{$_}; }
-    $self;
-}
-
-
-=head2 Font::TTF::Font->open($fname)
-
-Reads the header and directory for the given font file and creates appropriate
-objects for each table in the font.
-
-=cut
-
-sub open
-{
-    my ($class, $fname) = @_;
-    my ($fh);
-    my ($self) = {};
-    
-    unless (ref($fname))
-    {
-        $fh = IO::File->new($fname) or return undef;
-        binmode $fh;
-    } else
-    { $fh = $fname; }
-
-    $self->{' INFILE'} = $fh;
-    $self->{' fname'} = $fname;
-    $self->{' OFFSET'} = 0;
-    bless $self, $class;
-    
-    $self->read;
-}
-
-=head2 $f->read
-
-Reads a Truetype font directory starting from the current location in the file.
-This has been separated from the C<open> function to allow support for embedded
-TTFs for example in TTCs. Also reads the C<head> and C<maxp> tables immediately.
-
-=cut
-
-sub read
-{
-    my ($self) = @_;
-    my ($fh) = $self->{' INFILE'};
-    my ($dat, $i, $ver, $dir_num, $type, $name, $check, $off, $len, $t);
-
-    $fh->seek($self->{' OFFSET'}, 0);
-    $fh->read($dat, 12);
-    ($ver, $dir_num) = unpack("Nn", $dat);
-    $ver == 1 << 16 || $ver == unpack('N', 'OTTO') || $ver == 0x74727565 or return undef;  # support Mac sfnts
-    
-    for ($i = 0; $i < $dir_num; $i++)
-    {
-        $fh->read($dat, 16) || die "Reading table entry";
-        ($name, $check, $off, $len) = unpack("a4NNN", $dat);
-        $self->{$name} = $self->{' PARENT'}->find($self, $name, $check, $off, $len) && next
-                if (defined $self->{' PARENT'});
-        $type = $tables{$name} || 'Font::TTF::Table';
-        $t = $type;
-        if ($^O eq "MacOS")
-        { $t =~ s/^|::/:/oig; }
-        else
-        { $t =~ s|::|/|oig; }
-        require "$t.pm";
-        $self->{$name} = $type->new(PARENT  => $self,
-                                    NAME    => $name,
-                                    INFILE  => $fh,
-                                    OFFSET  => $off,
-                                    LENGTH  => $len,
-                                    CSUM    => $check);
-    }
-    
-    foreach $t ('head', 'maxp')
-    { $self->{$t}->read if defined $self->{$t}; }
-
-    $self;
-}
-
-
-=head2 $f->out($fname [, @tablelist])
-
-Writes a TTF file consisting of the tables in tablelist. The list is checked to
-ensure that only tables that exist are output. (This means that you can't have
-non table information stored in the font object with key length of exactly 4)
-
-In many cases the user simply wants to output all the tables in alphabetical order.
-This can be done by not including a @tablelist, in which case the subroutine will
-output all the defined tables in the font in alphabetical order.
-
-Returns $f on success and undef on failure, including warnings.
-
-All output files must include the C<head> table.
-
-=cut
-
-sub out
-{
-    my ($self, $fname, @tlist) = @_;
-    my ($fh);
-    my ($dat, $numTables, $sRange, $eSel);
-    my (%dir, $k, $mloc, $count);
-    my ($csum, $lsum, $msum, $loc, $oldloc, $len, $shift);
-
-    unless (ref($fname))
-    {
-        $fh = IO::File->new("+>$fname") || return warn("Unable to open $fname for writing"), undef;
-        binmode $fh;
-    } else
-    { $fh = $fname; }
-    
-    $self->{' oname'} = $fname;
-    $self->{' outfile'} = $fh;
-
-    if ($self->{' wantsig'})
-    {
-        $self->{' nocsum'} = 1;
-#        $self->{'head'}{'checkSumAdjustment'} = 0;
-        $self->{' tempDSIG'} = $self->{'DSIG'};
-        $self->{' tempcsum'} = $self->{'head'}{' CSUM'};
-        delete $self->{'DSIG'};
-        @tlist = sort {$self->{$a}{' OFFSET'} <=> $self->{$b}{' OFFSET'}}
-            grep (length($_) == 4 && defined $self->{$_}, keys %$self) if ($#tlist < 0);
-    }
-    elsif ($#tlist < 0)
-    { @tlist = sort keys %$self; }
-    
-    @tlist = grep(length($_) == 4 && defined $self->{$_}, @tlist);
-    $numTables = $#tlist + 1;
-    $numTables++ if ($self->{' wantsig'});
-    
-    ($numTables, $sRange, $eSel, $shift) = Font::TTF::Utils::TTF_bininfo($numTables, 16);
-    $dat = pack("Nnnnn", 1 << 16, $numTables, $sRange, $eSel, $shift);
-    $fh->print($dat);
-    $msum = unpack("%32N*", $dat);
-
-# reserve place holders for each directory entry
-    foreach $k (@tlist)
-    {
-        $dir{$k} = pack("A4NNN", $k, 0, 0, 0);
-        $fh->print($dir{$k});
-    }
-
-    $fh->print(pack('A4NNN', '', 0, 0, 0)) if ($self->{' wantsig'});
-
-    $loc = $fh->tell();
-    if ($loc & 3)
-    {
-        $fh->print(substr("\000" x 4, $loc & 3));
-        $loc += 4 - ($loc & 3);
-    }
-
-    foreach $k (@tlist)
-    {
-        $oldloc = $loc;
-        $self->{$k}->out($fh);
-        $loc = $fh->tell();
-        $len = $loc - $oldloc;
-        if ($loc & 3)
-        {
-            $fh->print(substr("\000" x 4, $loc & 3));
-            $loc += 4 - ($loc & 3);
-        }
-        $fh->seek($oldloc, 0);
-        $csum = 0; $mloc = $loc;
-        while ($mloc > $oldloc)
-        {
-            $count = ($mloc - $oldloc > 4096) ? 4096 : $mloc - $oldloc;
-            $fh->read($dat, $count);
-            $csum += unpack("%32N*", $dat);
-# this line ensures $csum stays within 32 bit bounds, clipping as necessary
-            if ($csum > 0xffffffff) { $csum -= 0xffffffff; $csum--; }
-            $mloc -= $count;
-        }
-        $dir{$k} = pack("A4NNN", $k, $csum, $oldloc, $len);
-        $msum += $csum + unpack("%32N*", $dir{$k});
-        while ($msum > 0xffffffff) { $msum -= 0xffffffff; $msum--; }
-        $fh->seek($loc, 0);
-    }
-
-    unless ($self->{' nocsum'})             # assuming we want a file checksum
-    {
-# Now we need to sort out the head table's checksum
-        if (!defined $dir{'head'})
-        {                                   # you have to have a head table
-            $fh->close();
-            return warn("No 'head' table to output in $fname"), undef;
-        }
-        ($csum, $loc, $len) = unpack("x4NNN", $dir{'head'});
-        $fh->seek($loc + 8, 0);
-        $fh->read($dat, 4);
-        $lsum = unpack("N", $dat);
-        if ($lsum != 0)
-        {
-            $csum -= $lsum;
-            if ($csum < 0) { $csum += 0xffffffff; $csum++; }
-            $msum -= $lsum * 2;                     # twice (in head and in csum)
-            while ($msum < 0) { $msum += 0xffffffff; $msum++; }
-        }
-        $lsum = 0xB1B0AFBA - $msum;
-        $fh->seek($loc + 8, 0);
-        $fh->print(pack("N", $lsum));
-        $dir{'head'} = pack("A4NNN", 'head', $csum, $loc, $len);
-    } elsif ($self->{' wantsig'})
-    {
-        if (!defined $dir{'head'})
-        {                                   # you have to have a head table
-            $fh->close();
-            return warn("No 'head' table to output in $fname"), undef;
-        }
-        ($csum, $loc, $len) = unpack("x4NNN", $dir{'head'});
-        $fh->seek($loc + 8, 0);
-        $fh->print(pack("N", 0));
-#        $dir{'head'} = pack("A4NNN", 'head', $self->{' tempcsum'}, $loc, $len);
-    }
-
-# Now we can output the directory again
-    if ($self->{' wantsig'})
-    { @tlist = sort @tlist; }
-    $fh->seek(12, 0);
-    foreach $k (@tlist)
-    { $fh->print($dir{$k}); }
-    $fh->print(pack('A4NNN', '', 0, 0, 0)) if ($self->{' wantsig'});
-    $fh->close();
-    $self;
-}
-
-
-=head2 $f->out_xml($filename [, @tables])
-
-Outputs the font in XML format
-
-=cut
-
-sub out_xml
-{
-    my ($self, $fname, @tlist) = @_;
-    my ($fh, $context, $numTables, $k);
-
-    $context->{'indent'} = ' ' x 4;
-
-    unless (ref($fname))
-    {
-        $fh = IO::File->new("+>$fname") || return warn("Unable to open $fname"), undef;
-        binmode $fh;
-    } else
-    { $fh = $fname; }
-
-    unless (scalar @tlist > 0)
-    {
-        @tlist = sort keys %$self;
-        @tlist = grep(length($_) == 4 && defined $self->{$_}, @tlist);
-    }
-    $numTables = $#tlist + 1;
-
-    $context->{'fh'} = $fh;
-    $fh->print("<?xml version='1.0' encoding='UTF-8'?>\n");
-    $fh->print("<font tables='$numTables'>\n\n");
-    
-    foreach $k (@tlist)
-    {
-        $fh->print("<table name='$k'>\n");
-        $self->{$k}->out_xml($context, $context->{'indent'});
-        $fh->print("</table>\n");
-    }
-
-    $fh->print("</font>\n");
-    $fh->close;
-    $self;
-}
-
-
-=head2 $f->XML_start($context, $tag, %attrs)
-
-Handles start messages from the XML parser. Of particular interest to us are <font> and
-<table>.
-
-=cut
-
-sub XML_start
-{
-    my ($self, $context, $tag, %attrs) = @_;
-    my ($name, $type, $t);
-
-    if ($tag eq 'font')
-    { $context->{'tree'}[-1] = $self; }
-    elsif ($tag eq 'table')
-    {
-        $name = $attrs{'name'};
-        unless (defined $self->{$name})
-        {
-            $type = $tables{$name} || 'Font::TTF::Table';
-            $t = $type;
-            if ($^O eq "MacOS")
-            { $t =~ s/^|::/:/oig; }
-            else
-            { $t =~ s|::|/|oig; }
-            require "$t.pm";
-            $self->{$name} = $type->new('PARENT' => $self, 'NAME' => $name, 'read' => 1);
-        }
-        $context->{'receiver'} = ($context->{'tree'}[-1] = $self->{$name});
-    }
-    $context;
-}
-
-
-sub XML_end
-{
-    my ($self) = @_;
-    my ($context, $tag, %attrs) = @_;
-    my ($i);
-
-    return undef unless ($tag eq 'table' && $attrs{'name'} eq 'loca');
-    if (defined $context->{'glyphs'} && $context->{'glyphs'} ne $self->{'loca'}{'glyphs'})
-    {
-        for ($i = 0; $i <= $#{$context->{'glyphs'}}; $i++)
-        { $self->{'loca'}{'glyphs'}[$i] = $context->{'glyphs'}[$i] if defined $context->{'glyphs'}[$i]; }
-        $context->{'glyphs'} = $self->{'loca'}{'glyphs'};
-    }
-    return undef;
-}
-
-=head2 $f->update
-
-Sends update to all the tables in the font and then resets all the isDirty
-flags on each table. The data structure in now consistent as a font (we hope).
-
-=cut
-
-sub update
-{
-    my ($self) = @_;
-    
-    $self->tables_do(sub { $_[0]->update; });
-
-    $self;
-}
-
-=head2 $f->dirty
-
-Dirties all the tables in the font
-
-=cut
-
-sub dirty
-{ $_[0]->tables_do(sub { $_[0]->dirty; }); $_[0]; }
-
-=head2 $f->tables_do(&func [, tables])
-
-Calls &func for each table in the font. Calls the table in alphabetical sort
-order as per the order in the directory:
-
-    &func($table, $name);
-
-May optionally take a list of table names in which case func is called
-for each of them in the given order.
-=cut
-
-sub tables_do
-{
-    my ($self, $func, @tables) = @_;
-    my ($t);
-
-    foreach $t (@tables ? @tables : sort grep {length($_) == 4} keys %$self)
-    { &$func($self->{$t}, $t); }
-    $self;
-}
-
-
-=head2 $f->release
-
-Releases ALL of the memory used by the TTF font and all of its component
-objects.  After calling this method, do B<NOT> expect to have anything left in
-the C<Font::TTF::Font> object.
-
-B<NOTE>, that it is important that you call this method on any
-C<Font::TTF::Font> object when you wish to destruct it and free up its memory.
-Internally, we track things in a structure that can result in circular
-references, and without calling 'C<release()>' these will not properly get
-cleaned up by Perl.  Once you've called this method, though, don't expect to be
-able to do anything else with the C<Font::TTF::Font> object; it'll have B<no>
-internal state whatsoever.
-
-B<Developer note:> As part of the brute-force cleanup done here, this method
-will throw a warning message whenever unexpected key values are found within
-the C<Font::TTF::Font> object.  This is done to help ensure that any unexpected
-and unfreed values are brought to your attention so that you can bug us to keep
-the module updated properly; otherwise the potential for memory leaks due to
-dangling circular references will exist.  
-
-=cut
-
-sub release
-{
-    my ($self) = @_;
-
-# delete stuff that we know we can, here
-
-    my @tofree = map { delete $self->{$_} } keys %{$self};
-
-    while (my $item = shift @tofree)
-    {
-        my $ref = ref($item);
-        if (UNIVERSAL::can($item, 'release'))
-        { $item->release(); }
-        elsif ($ref eq 'ARRAY')
-        { push( @tofree, @{$item} ); }
-        elsif (UNIVERSAL::isa($ref, 'HASH'))
-        { release($item); }
-    }
-
-# check that everything has gone - it better had!
-    foreach my $key (keys %{$self})
-    { warn ref($self) . " still has '$key' key left after release.\n"; }
-}
-
-1;
-
-=head1 BUGS
-
-Bugs abound aplenty I am sure. There is a lot of code here and plenty of scope.
-The parts of the code which haven't been implemented yet are:
-
-=over 4
-
-=item Post
-
-Version 4 format types are not supported yet.
-
-=item Cmap
-
-Format type 2 (MBCS) has not been implemented yet and therefore may cause
-somewhat spurious results for this table type.
-
-=item Kern
-
-Only type 0 & type 2 tables are supported (type 1 & type 3 yet to come).
-
-=item TTC
-
-The current Font::TTF::Font::out method does not support the writing of TrueType
-Collections.
-
-=back
-
-In addition there are weaknesses or features of this module library
-
-=over 4
-
-=item *
-
-There is very little (or no) error reporting. This means that if you have
-garbled data or garbled data structures, then you are liable to generate duff
-fonts.
-
-=item *
-
-The exposing of the internal data structures everywhere means that doing
-radical re-structuring is almost impossible. But it stop the code from becoming
-ridiculously large.
-
-=back
-
-Apart from these, I try to keep the code in a state of "no known bugs", which
-given the amount of testing this code has had, is not a guarantee of high
-quality, yet.
-
-For more details see the appropriate class files.
-
-=head1 AUTHOR
-
-Martin Hosken Martin_Hosken@sil.org
-
-Copyright Martin Hosken 1998.
-
-No warranty or expression of effectiveness, least of all regarding anyone's
-safety, is implied in this software or documentation.
-
-=head2 Licensing
-
-The Perl TTF module is licensed under the Perl Artistic License.
-