--- /dev/null
+package Font::TTF::GPOS;
+
+=head1 NAME
+
+Font::TTF::GPOS - Support for Opentype GPOS tables in conjunction with TTOpen
+
+=head1 DESCRIPTION
+
+The GPOS table is one of the most complicated tables in the TTF spec and the
+corresponding data structure abstraction is also not trivial. While much of the
+structure of a GPOS is shared with a GSUB table via the L<Font::TTF::Ttopen>
+
+=head1 INSTANCE VARIABLES
+
+Here we describe the additions and lookup specific information for GPOS tables.
+Unfortunately there is no one abstraction which seems to work comfortable for
+all GPOS tables, so we will also examine how the variables are used for different
+lookup types.
+
+The following are the values allowed in the ACTION_TYPE and MATCH_TYPE variables:
+
+=over 4
+
+=item ACTION_TYPE
+
+This can take any of the following values
+
+=over 8
+
+=item a
+
+The ACTION is an array of anchor tables
+
+=item o
+
+Offset. There is no RULE array. The ADJUST variable contains a value record (see
+later in this description)
+
+=item v
+
+The ACTION is a value record.
+
+=item p
+
+Pair adjustment. The ACTION contains an array of two value records for the matched
+two glyphs.
+
+=item e
+
+Exit and Entry records. The ACTION contains an array of two anchors corresponding
+to the exit and entry anchors for the glyph.
+
+=item l
+
+Indicates a lookup based contextual rule as per the GSUB table.
+
+=back
+
+=item MATCH_TYPE
+
+This can take any of the following values
+
+=over 8
+
+=item g
+
+A glyph array
+
+=item c
+
+An array of class values
+
+=item o
+
+An array of coverage tables
+
+=back
+
+=back
+
+The following variables are added for Attachment Positioning Subtables:
+
+=over 4
+
+=item MATCH
+
+This contains an array of glyphs to match against for all RULES. It is much like
+having the same MATCH string in all RULES. In the cases it is used so far, it only
+ever contains one element.
+
+=item MARKS
+
+This contains a Mark array consisting of each element being a subarray of two
+elements:
+
+=over 8
+
+=item CLASS
+
+The class that this mark uses on its base
+
+=item ANCHOR
+
+The anchor with which to attach this mark glyph
+
+=back
+
+The base table for mark to base, ligature or mark attachment positioning is
+structured with the ACTION containing an array of anchors corresponding to each
+attachment class. For ligatures, there is more than one RULE in the RULE array
+corresponding to each glyph in the coverage table.
+
+=back
+
+Other variables which are provided for informational purposes are:
+
+=over 4
+
+=item VFMT
+
+Value format for the adjustment of the glyph matched by the coverage table.
+
+=item VFMT2
+
+Value format used in pair adjustment for the second glyph in the pair
+
+=back
+
+=head2 Value Records
+
+There is a subtype used in GPOS tables called a value record. It is used to adjust
+the position of a glyph from its default position. The value record is variable
+length with a bitfield at the beginning to indicate which of the following
+entries are included. The bitfield is not stored since it is recalculated at
+write time.
+
+=over 4
+
+=item XPlacement
+
+Horizontal adjustment for placement (not affecting other unattached glyphs)
+
+=item YPlacement
+
+Vertical adjustment for placement (not affecting other unattached glyphs)
+
+=item XAdvance
+
+Adjust the advance width glyph (used only in horizontal writing systems)
+
+=item YAdvance
+
+Adjust the vertical advance (used only in vertical writing systems)
+
+=item XPlaDevice
+
+Device table for device specific adjustment of horizontal placement
+
+=item YPlaDevice
+
+Device table for device specific adjustment of vertical placement
+
+=item XAdvDevice
+
+Device table for device specific adjustment of horizontal advance
+
+=item YAdDevice
+
+Device table for device specific adjustment of vertical advance
+
+=item XIdPlacement
+
+Horizontal placement metric id (for Multiple Master fonts - but that's all I know!)
+
+=item YIdPlacement
+
+Vertical placement metric id
+
+=item XIdAdvance
+
+Horizontal advance metric id
+
+=item YIdAdvance
+
+Vertical advance metric id
+
+=back
+
+=head1 CORRESPONDANCE TO LAYOUT TYPES
+
+Here is what is stored in the ACTION_TYPE and MATCH_TYPE for each of the known
+GPOS subtable types:
+
+ 1.1 1.2 2.1 2.2 3 4 5 6 7.1 7.2 7.3 8.1 8.2 8.3
+ ACTION_TYPE o v p p e a a a l l l l l l
+ MATCH_TYPE g c g c o g c o
+
+
+=head1 METHODS
+
+=cut
+
+use strict;
+use Font::TTF::Ttopen;
+use Font::TTF::Delta;
+use Font::TTF::Anchor;
+use Font::TTF::Utils;
+use vars qw(@ISA);
+
+@ISA = qw(Font::TTF::Ttopen);
+
+
+=head2 read_sub
+
+Reads the subtable into the data structures
+
+=cut
+
+sub read_sub
+{
+ my ($self, $fh, $main_lookup, $sindex) = @_;
+ my ($type) = $main_lookup->{'TYPE'};
+ my ($loc) = $fh->tell();
+ my ($lookup) = $main_lookup->{'SUB'}[$sindex];
+ my ($dat, $mcount, $scount, $i, $j, $count, $fmt, $fmt2, $cover, $srec, $subst);
+ my ($c1, $c2, $s, $moff, $boff);
+
+
+ if ($type == 8)
+ {
+ $fh->read($dat, 4);
+ ($fmt, $cover) = TTF_Unpack('S2', $dat);
+ if ($fmt < 3)
+ {
+ $fh->read($dat, 2);
+ $count = TTF_Unpack('S', $dat);
+ }
+ } else
+ {
+ $fh->read($dat, 6);
+ ($fmt, $cover, $count) = TTF_Unpack("S3", $dat);
+ }
+ unless ($fmt == 3 && ($type == 7 || $type == 8))
+ { $lookup->{'COVERAGE'} = $self->read_cover($cover, $loc, $lookup, $fh, 1); }
+
+ $lookup->{'FORMAT'} = $fmt;
+ if ($type == 1 && $fmt == 1)
+ {
+ $lookup->{'VFMT'} = $count;
+ $lookup->{'ADJUST'} = $self->read_value($count, $loc, $lookup, $fh);
+ $lookup->{'ACTION_TYPE'} = 'o';
+ } elsif ($type == 1 && $fmt == 2)
+ {
+ $lookup->{'VFMT'} = $count;
+ $fh->read($dat, 2);
+ $mcount = unpack('n', $dat);
+ for ($i = 0; $i < $mcount; $i++)
+ { push (@{$lookup->{'RULES'}}, [{'ACTION' =>
+ [$self->read_value($count, $loc, $lookup, $fh)]}]); }
+ $lookup->{'ACTION_TYPE'} = 'v';
+ } elsif ($type == 2 && $fmt == 1)
+ {
+ $lookup->{'VFMT'} = $count;
+ $fh->read($dat, 4);
+ ($fmt2, $mcount) = unpack('n2', $dat);
+ $lookup->{'VFMT2'} = $fmt2;
+ $fh->read($dat, $mcount << 1);
+ foreach $s (unpack('n*', $dat))
+ {
+ $fh->seek($loc + $s, 0);
+ $fh->read($dat, 2);
+ $scount = TTF_Unpack('S', $dat);
+ $subst = [];
+ for ($i = 0; $i < $scount; $i++)
+ {
+ $srec = {};
+ $fh->read($dat, 2);
+ $srec->{'MATCH'} = [TTF_Unpack('S', $dat)];
+ $srec->{'ACTION'} = [$self->read_value($count, $loc, $lookup, $fh),
+ $self->read_value($fmt2, $loc, $lookup, $fh)];
+ push (@$subst, $srec);
+ }
+ push (@{$lookup->{'RULES'}}, $subst);
+ }
+ $lookup->{'ACTION_TYPE'} = 'p';
+ $lookup->{'MATCH_TYPE'} = 'g';
+ } elsif ($type == 2 && $fmt == 2)
+ {
+ $fh->read($dat, 10);
+ ($lookup->{'VFMT2'}, $c1, $c2, $mcount, $scount) = TTF_Unpack('S*', $dat);
+ $lookup->{'CLASS'} = $self->read_cover($c1, $loc, $lookup, $fh, 0);
+ $lookup->{'MATCH'} = [$self->read_cover($c2, $loc, $lookup, $fh, 0)];
+ $lookup->{'VFMT'} = $count;
+ for ($i = 0; $i < $mcount; $i++)
+ {
+ $subst = [];
+ for ($j = 0; $j < $scount; $j++)
+ {
+ $srec = {};
+ $srec->{'ACTION'} = [$self->read_value($lookup->{'VFMT'}, $loc, $lookup, $fh),
+ $self->read_value($lookup->{'VFMT2'}, $loc, $lookup, $fh)];
+ push (@$subst, $srec);
+ }
+ push (@{$lookup->{'RULES'}}, $subst);
+ }
+ $lookup->{'ACTION_TYPE'} = 'p';
+ $lookup->{'MATCH_TYPE'} = 'c';
+ } elsif ($type == 3 && $fmt == 1)
+ {
+ $fh->read($dat, $count << 2);
+ for ($i = 0; $i < $count; $i++)
+ { push (@{$lookup->{'RULES'}}, [{'ACTION' =>
+ [$self->read_anchor(TTF_Unpack('S', substr($dat, $i << 2, 2)),
+ $loc, $lookup, $fh),
+ $self->read_anchor(TTF_Unpack('S', substr($dat, ($i << 2) + 2, 2)),
+ $loc, $lookup, $fh)]}]); }
+ $lookup->{'ACTION_TYPE'} = 'e';
+ } elsif ($type == 4 || $type == 5 || $type == 6)
+ {
+ my (@offs, $mloc, $thisloc, $ncomp, $k);
+
+ $lookup->{'MATCH'} = [$lookup->{'COVERAGE'}];
+ $lookup->{'COVERAGE'} = $self->read_cover($count, $loc, $lookup, $fh, 1);
+ $fh->read($dat, 6);
+ ($mcount, $moff, $boff) = TTF_Unpack('S*', $dat);
+ $fh->seek($loc + $moff, 0);
+ $fh->read($dat, 2);
+ $count = TTF_Unpack('S', $dat);
+ for ($i = 0; $i < $count; $i++)
+ {
+ $fh->read($dat, 4);
+ push (@{$lookup->{'MARKS'}}, [TTF_Unpack('S', $dat),
+ $self->read_anchor(TTF_Unpack('S', substr($dat, 2, 2)) + $moff,
+ $loc, $lookup, $fh)]);
+ }
+ $fh->seek($loc + $boff, 0);
+ $fh->read($dat, 2);
+ $count = TTF_Unpack('S', $dat);
+ $mloc = $fh->tell() - 2;
+ $thisloc = $mloc;
+ if ($type == 5)
+ {
+ $fh->read($dat, $count << 1);
+ @offs = TTF_Unpack('S*', $dat);
+ }
+ for ($i = 0; $i < $count; $i++)
+ {
+ if ($type == 5)
+ {
+ $thisloc = $mloc + $offs[$i];
+ $fh->seek($thisloc, 0);
+ $fh->read($dat, 2);
+ $ncomp = TTF_Unpack('S', $dat);
+ } else
+ { $ncomp = 1; }
+ for ($j = 0; $j < $ncomp; $j++)
+ {
+ $subst = [];
+ $fh->read($dat, $mcount << 1);
+ for ($k = 0; $k < $mcount; $k++)
+ { push (@$subst, $self->read_anchor(TTF_Unpack('S', substr($dat, $k << 1, 2)) + $thisloc - $loc,
+ $loc, $lookup, $fh)); }
+
+ push (@{$lookup->{'RULES'}[$i]}, {'ACTION' => $subst});
+ }
+ }
+ $lookup->{'ACTION_TYPE'} = 'a';
+ } elsif ($type == 7 || $type == 8)
+ { $self->read_context($lookup, $fh, $type - 2, $fmt, $cover, $count, $loc); }
+ $lookup;
+}
+
+
+=head2 $t->extension
+
+Returns the table type number for the extension table
+
+=cut
+
+sub extension
+{ return 9; }
+
+
+=head2 $t->out_sub
+
+Outputs the subtable to the given filehandle
+
+=cut
+
+sub out_sub
+{
+ my ($self, $fh, $main_lookup, $index, $ctables, $base) = @_;
+ my ($type) = $main_lookup->{'TYPE'};
+ my ($lookup) = $main_lookup->{'SUB'}[$index];
+ my ($fmt) = $lookup->{'FORMAT'};
+ my ($out, $r, $s, $t, $i, $j, $vfmt, $vfmt2, $loc1);
+ my ($num) = $#{$lookup->{'RULES'}} + 1;
+ my ($mtables) = {};
+ my (@reftables);
+
+ if ($type == 1 && $fmt == 1)
+ {
+ $out = pack('n2', $fmt, Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 2 + $base));
+ $vfmt = $self->fmt_value($lookup->{'ADJUST'});
+ $out .= pack('n', $vfmt) . $self->out_value($lookup->{'ADJUST'}, $vfmt, $ctables, 6 + $base);
+ } elsif ($type == 1 && $fmt == 2)
+ {
+ $vfmt = 0;
+ foreach $r (@{$lookup->{'RULES'}})
+ { $vfmt |= $self->fmt_value($r->[0]{'ACTION'}[0]); }
+ $out = pack('n4', $fmt, Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 2 + $base),
+ $vfmt, $#{$lookup->{'RULES'}} + 1);
+ foreach $r (@{$lookup->{'RULES'}})
+ { $out .= $self->out_value($r->[0]{'ACTION'}[0], $vfmt, $ctables, length($out) + $base); }
+ } elsif ($type == 2 && $fmt < 3)
+ {
+ $vfmt = 0;
+ $vfmt2 = 0;
+ foreach $r (@{$lookup->{'RULES'}})
+ {
+ foreach $t (@$r)
+ {
+ $vfmt |= $self->fmt_value($t->{'ACTION'}[0]);
+ $vfmt2 |= $self->fmt_value($t->{'ACTION'}[1]);
+ }
+ }
+ if ($fmt == 1)
+ {
+ # start PairPosFormat1 subtable
+ $out = pack('n5',
+ $fmt,
+ Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 2 + $base),
+ $vfmt,
+ $vfmt2,
+ $#{$lookup->{'RULES'}} + 1); # PairSetCount
+ my $off = 0;
+ $off += length($out);
+ $off += 2 * ($#{$lookup->{'RULES'}} + 1); # there will be PairSetCount offsets here
+ my $pairsets = '';
+ my (%cache);
+ foreach $r (@{$lookup->{'RULES'}}) # foreach PairSet table
+ {
+ # write offset to this PairSet at end of PairPosFormat1 table
+ if (defined $cache{"$r"})
+ { $out .= pack('n', $cache{"$r"}); }
+ else
+ {
+ $out .= pack('n', $off);
+ $cache{"$r"} = $off;
+
+ # generate PairSet itself (using $off as eventual offset within PairPos subtable)
+ my $pairset = pack('n', $#{$r} + 1); # PairValueCount
+ foreach $t (@$r) # foreach PairValueRecord
+ {
+ $pairset .= pack('n', $t->{'MATCH'}[0]); # SecondGlyph - MATCH has only one entry
+ $pairset .=
+ $self->out_value($t->{'ACTION'}[0], $vfmt, $ctables, $off + length($pairset) + $base);
+ $pairset .=
+ $self->out_value($t->{'ACTION'}[1], $vfmt2, $ctables, $off + length($pairset) + $base);
+ }
+ $off += length($pairset);
+ $pairsets .= $pairset;
+ }
+ }
+ $out .= $pairsets;
+ die "internal error: PairPos size not as calculated" if (length($out) != $off);
+ } else
+ {
+ $out = pack('n8', $fmt, Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 2 + $base),
+ $vfmt, $vfmt2,
+ Font::TTF::Ttopen::ref_cache($lookup->{'CLASS'}, $ctables, 8 + $base),
+ Font::TTF::Ttopen::ref_cache($lookup->{'MATCH'}[0], $ctables, 10 + $base),
+ $lookup->{'CLASS'}{'max'} + 1, $lookup->{'MATCH'}[0]{'max'} + 1);
+
+ for ($i = 0; $i <= $lookup->{'CLASS'}{'max'}; $i++)
+ {
+ for ($j = 0; $j <= $lookup->{'MATCH'}[0]{'max'}; $j++)
+ {
+ $out .= $self->out_value($lookup->{'RULES'}[$i][$j]{'ACTION'}[0], $vfmt, $ctables, length($out) + $base);
+ $out .= $self->out_value($lookup->{'RULES'}[$i][$j]{'ACTION'}[1], $vfmt2, $ctables, length($out) + $base);
+ }
+ }
+ }
+ } elsif ($type == 3 && $fmt == 1)
+ {
+ $out = pack('n3', $fmt, Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 2 + $base),
+ $#{$lookup->{'RULES'}} + 1);
+ foreach $r (@{$lookup->{'RULES'}})
+ {
+ $out .= pack('n2', Font::TTF::Ttopen::ref_cache($r->[0]{'ACTION'}[0], $ctables, length($out) + $base),
+ Font::TTF::Ttopen::ref_cache($r->[0]{'ACTION'}[1], $ctables, length($out) + 2 + $base));
+ }
+ } elsif ($type == 4 || $type == 5 || $type == 6)
+ {
+ my ($loc_off, $loc_t, $ltables);
+
+ $out = pack('n7', $fmt, Font::TTF::Ttopen::ref_cache($lookup->{'MATCH'}[0], $ctables, 2 + $base),
+ Font::TTF::Ttopen::ref_cache($lookup->{'COVERAGE'}, $ctables, 4 + $base),
+ $#{$lookup->{'RULES'}[0][0]{'ACTION'}} + 1, 12, ($#{$lookup->{'MARKS'}} + 4) << 2,
+ $#{$lookup->{'MARKS'}} + 1);
+ foreach $r (@{$lookup->{'MARKS'}})
+ { $out .= pack('n2', $r->[0], Font::TTF::Ttopen::ref_cache($r->[1], $mtables, length($out) + 2)); }
+ push (@reftables, [$mtables, 12]);
+
+ $loc_t = length($out);
+ substr($out, 10, 2) = pack('n', $loc_t);
+ $out .= pack('n', $#{$lookup->{'RULES'}} + 1);
+ if ($type == 5)
+ {
+ $loc1 = length($out);
+ $out .= pack('n*', (0) x ($#{$lookup->{'RULES'}} + 1));
+ }
+ $ltables = {};
+ for ($i = 0; $i <= $#{$lookup->{'RULES'}}; $i++)
+ {
+ if ($type == 5)
+ {
+ $ltables = {};
+ $loc_t = length($out);
+ substr($out, $loc1 + ($i << 1), 2) = TTF_Pack('S', $loc_t - $loc1 + 2);
+ }
+
+ $r = $lookup->{'RULES'}[$i];
+ $out .= pack('n', $#{$r} + 1) if ($type == 5);
+ foreach $t (@$r)
+ {
+ foreach $s (@{$t->{'ACTION'}})
+ { $out .= pack('n', Font::TTF::Ttopen::ref_cache($s, $ltables, length($out))); }
+ }
+ push (@reftables, [$ltables, $loc_t]) if ($type == 5);
+ }
+ push (@reftables, [$ltables, $loc_t]) unless ($type == 5);
+ $out = Font::TTF::Ttopen::out_final($fh, $out, \@reftables, 1);
+ } elsif ($type == 7 || $type == 8)
+ { $out = $self->out_context($lookup, $fh, $type - 2, $fmt, $ctables, $out, $num, $base); }
+# push (@reftables, [$ctables, 0]);
+ $out;
+}
+
+
+=head2 $t->read_value($format, $base, $lookup, $fh)
+
+Reads a value record from the current location in the file, according to the
+format given.
+
+=cut
+
+sub read_value
+{
+ my ($self, $fmt, $base, $lookup, $fh) = @_;
+ my ($flag) = 1;
+ my ($res) = {};
+ my ($s, $i, $dat);
+
+ $s = 0;
+ for ($i = 0; $i < 12; $i++)
+ {
+ $s++ if ($flag & $fmt);
+ $flag <<= 1;
+ }
+
+ $fh->read($dat, $s << 1);
+ $flag = 1; $i = 0;
+ foreach $s (qw(XPlacement YPlacement XAdvance YAdvance))
+ {
+ $res->{$s} = TTF_Unpack('s', substr($dat, $i++ << 1, 2)) if ($fmt & $flag);
+ $flag <<= 1;
+ }
+
+ foreach $s (qw(XPlaDevice YPlaDevice XAdvDevice YAdvDevice))
+ {
+ if ($fmt & $flag)
+ { $res->{$s} = $self->read_delta(TTF_Unpack('S', substr($i++ << 1, 2)),
+ $base, $lookup, $fh); }
+ $flag <<= 1;
+ }
+
+ foreach $s (qw(XIdPlacement YIdPlacement XIdAdvance YIdAdvance))
+ {
+ $res->{$s} = TTF_Unpack('S', substr($dat, $i++ << 1, 2)) if ($fmt & $flag);
+ $flag <<= 1;
+ }
+ $res;
+}
+
+
+=head2 $t->read_delta($offset, $base, $lookup, $fh)
+
+Reads a delta (device table) at the given offset if it hasn't already been read.
+Store the offset and item in the lookup cache ($lookup->{' CACHE'})
+
+=cut
+
+sub read_delta
+{
+ my ($self, $offset, $base, $lookup, $fh) = @_;
+ my ($loc) = $fh->tell();
+ my ($res, $str);
+
+ return undef unless $offset;
+ $str = sprintf("%X", $base + $offset);
+ return $lookup->{' CACHE'}{$str} if defined $lookup->{' CACHE'}{$str};
+ $fh->seek($base + $offset, 0);
+ $res = Font::TTF::Delta->new->read($fh);
+ $fh->seek($loc, 0);
+ $lookup->{' CACHE'}{$str} = $res;
+ return $res;
+}
+
+
+=head2 $t->read_anchor($offset, $base, $lookup, $fh)
+
+Reads an Anchor table at the given offset if it hasn't already been read.
+
+=cut
+
+sub read_anchor
+{
+ my ($self, $offset, $base, $lookup, $fh) = @_;
+ my ($loc) = $fh->tell();
+ my ($res, $str);
+
+ return undef unless $offset;
+ $str = sprintf("%X", $base + $offset);
+ return $lookup->{' CACHE'}{$str} if defined $lookup->{' CACHE'}{$str};
+ $fh->seek($base + $offset, 0);
+ $res = Font::TTF::Anchor->new->read($fh);
+ $fh->seek($loc, 0);
+ $lookup->{' CACHE'}{$str} = $res;
+ return $res;
+}
+
+
+=head2 $t->fmt_value
+
+Returns the value format for a given value record
+
+=cut
+
+sub fmt_value
+{
+ my ($self, $value) = @_;
+ my ($fmt) = 0;
+ my ($n);
+
+ foreach $n (reverse qw(XPlacement YPlacement XAdvance YAdvance XPlaDevice YPlaDevice
+ XAdvDevice YAdvDevice XIdPlacement YIdPlacement XIdAdvance
+ YIdAdvance))
+ {
+ $fmt <<= 1;
+ $fmt |= 1 if (defined $value->{$n} && (ref $value->{$n} || $value->{$n}));
+ }
+ $fmt;
+}
+
+
+=head2 $t->out_value
+
+Returns the output string for the outputting of the value for a given format. Also
+updates the offset cache for any device tables referenced.
+
+=cut
+
+sub out_value
+{
+ my ($self, $value, $fmt, $tables, $offset) = @_;
+ my ($n, $flag, $out);
+
+ $flag = 1;
+ foreach $n (qw(XPlacement YPlacement XAdvance YAdvance))
+ {
+ $out .= pack('n', $value->{$n}) if ($flag & $fmt);
+ $flag <<= 1;
+ }
+ foreach $n (qw(XPlaDevice YPlaDevice XAdvDevice YAdvDevice))
+ {
+ if ($flag & $fmt)
+ {
+ $out .= pack('n', Font::TTF::Ttopen::ref_cache(
+ $value->{$n}, $tables, $offset + length($out)));
+ }
+ $flag <<= 1;
+ }
+ foreach $n (qw(XIdPlacement YIdPlacement XIdAdvance YIdAdvance))
+ {
+ $out .= pack('n', $value->{$n}) if ($flag & $fmt);
+ $flag <<= 1;
+ }
+ $out;
+}
+
+
+=head1 AUTHOR
+
+Martin Hosken Martin_Hosken@sil.org. See L<Font::TTF::Font> for copyright and
+licensing.
+
+=cut
+
+1;
+