7d637570a06208c16e12a9930e73c608eee25c30
[librarian.git] / librarian / font-optimizer / ext / Font-TTF / lib / Font / TTF / Delta.pm
1 package Font::TTF::Delta;
2
3 =head1 NAME 
4
5 Font::TTF::Delta - Opentype Device tables
6
7 =head1 DESCRIPTION
8
9 Each device table corresponds to a set of deltas for a particular point over
10 a range of ppem values.
11
12 =item first
13
14 The first ppem value in the range
15
16 =item last
17
18 The last ppem value in the range
19
20 =item val
21
22 This is an array of deltas corresponding to each ppem in the range between
23 first and last inclusive.
24
25 =item fmt
26
27 This is the fmt used (log2 of number bits per value) when the device table was
28 read. It is recalculated on output.
29
30 =head1 METHODS
31
32 =cut
33
34 use strict;
35 use Font::TTF::Utils;
36
37 =head2 new
38
39 Creates a new device table
40
41 =cut
42
43 sub new
44 {
45     my ($class) = @_;
46     my ($self) = {};
47
48     bless $self, $class;
49 }
50
51
52 =head2 read
53
54 Reads a device table from the given IO object at the current location
55
56 =cut
57
58 sub read
59 {
60     my ($self, $fh) = @_;
61     my ($dat, $fmt, $num, $i, $j, $mask);
62
63     $fh->read($dat, 6);
64     ($self->{'first'}, $self->{'last'}, $fmt) = TTF_Unpack("S3", $dat);
65     $self->{'fmt'} = $fmt;
66
67     $fmt = 1 << $fmt;
68     $num = ((($self->{'last'} - $self->{'first'} + 1) * $fmt) + 15) >> 8;
69     $fh->read($dat, $num);
70
71     $mask = (0xffff << (16 - $fmt)) & 0xffff;
72     $j = 0;
73     for ($i = $self->{'first'}; $i <= $self->{'last'}; $i++)
74     {
75         if ($j == 0)
76         {
77             $num = TTF_Unpack("S", substr($dat, 0, 2));
78             substr($dat, 0, 2) = '';
79         }
80         push (@{$self->{'val'}}, ($num & $mask) >> (16 - $fmt));
81         $num <<= $fmt;
82         $j += $fmt;
83         $j = 0 if ($j >= 16);
84     }
85     $self;
86 }
87
88
89 =head2 out($fh, $style)
90
91 Outputs a device table to the given IO object at the current location, or just
92 returns the data to be output if $style != 0
93
94 =cut
95
96 sub out
97 {
98     my ($self, $fh, $style) = @_;
99     my ($dat, $fmt, $num, $mask, $j, $f, $out);
100
101     foreach $f (@{$self->{'val'}})
102     {
103         my ($tfmt) = $f > 0 ? $f + 1 : -$f;
104         $fmt = $tfmt if $tfmt > $fmt;
105     }
106
107     if ($fmt > 8)
108     { $fmt = 3; }
109     elsif ($fmt > 2)
110     { $fmt = 2; }
111     else
112     { $fmt = 1; }
113
114     $out = TTF_Pack("S3", $self->{'first'}, $self->{'last'}, $fmt);
115
116     $fmt = 1 << $fmt;
117     $mask = 0xffff >> (16 - $fmt);
118     $j = 0; $dat = 0;
119     foreach $f (@{$self->{'val'}})
120     {
121         $dat |= ($f & $mask) << (16 - $fmt - $j);
122         $j += $fmt;
123         if ($j >= 16)
124         {
125             $j = 0;
126             $out .= TTF_Pack("S", $dat);
127             $dat = 0;
128         }
129     }
130     $out .= pack('n', $dat) if ($j > 0);
131     $fh->print($out) unless $style;
132     $out;
133 }
134
135 =head2 $d->signature()
136
137 Returns a content based identifying string for this delta for
138 compression purposes
139
140 =cut
141
142 sub signature
143 {
144     my ($self) = @_;
145     return join (",", $self->{'first'}, $self->{'last'}, @{$self->{'val'}});
146 }
147
148
149 =head2 $d->out_xml($context)
150
151 Outputs a delta in XML
152
153 =cut
154
155 sub out_xml
156 {
157     my ($self, $context, $depth) = @_;
158     my ($fh) = $context->{'fh'};
159
160     $fh->printf("%s<delta first='%s' last='%s'>\n", $depth, $self->{'first'}, $self->{'last'});
161     $fh->print("$depth$context->{'indent'}" . join (' ', @{$self->{'val'}}) . "\n") if defined ($self->{'val'});
162     $fh->print("$depth</delta>\n");
163 }
164
165 =head1 AUTHOR
166
167 Martin Hosken Martin_Hosken@sil.org. See L<Font::TTF::Font> for copyright and
168 licensing.
169
170 =cut
171
172 1;
173