The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

MHOSKEN / Font-TTF-0.23 / lib / Font / TTF / Head.pm 

            

              
1
—
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
—
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
—
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
—
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
—
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
—
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
—
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
—
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251

              
package Font::TTF::Head;
=head1 NAME
Font::TTF::Head - The head table for a TTF Font
=head1 DESCRIPTION
This is a very basic table with just instance variables as described in the
TTF documentation, using the same names. One of the most commonly used is
C<unitsPerEm>.
=head1 INSTANCE VARIABLES
The C<head> table has no internal instance variables beyond those common to all
tables and those specified in the standard:
    version
    fontRevision
    checkSumAdjustment
    magicNumber
    flags
    unitsPerEm
    created
    modified
    xMin
    yMin
    xMax
    yMax
    macStyle
    lowestRecPPEM
    fontDirectionHint
    indexToLocFormat
    glyphDataFormat
The two dates are held as an array of two unsigned longs (32-bits)
=head1 METHODS
=cut
use strict;
use vars qw(@ISA %fields);
require Font::TTF::Table;
use Font::TTF::Utils;
@ISA = qw(Font::TTF::Table);
sub init
{
    my ($k, $v, $c);
    while (<Font::TTF::Head::DATA>)
    {
        ($k, $v, $c) = TTF_Init_Fields($_, $c);
        next unless defined $k && $k ne "";
        $fields{$k} = $v;
    }
}
=head2 $t->read
Reads the table into memory thanks to some utility functions
=cut
sub read
{
    my ($self) = @_;
    my ($dat);
    $self->SUPER::read || return $self;
    init unless defined $fields{'Ascender'};
    $self->{' INFILE'}->read($dat, 54);
    TTF_Read_Fields($self, $dat, \%fields);
    $self;
}
=head2 $t->out($fh)
Writes the table to a file either from memory or by copying. If in memory
(which is usually) the checkSumAdjustment field is set to 0 as per the default
if the file checksum is not to be considered.
=cut
sub out
{
    my ($self, $fh) = @_;
    return $self->SUPER::out($fh) unless $self->{' read'};      # this is never true
#    $self->{'checkSumAdjustment'} = 0 unless $self->{' PARENT'}{' wantsig'};
    $fh->print(TTF_Out_Fields($self, \%fields, 54));
    $self;
}
=head2 $t->XML_element($context, $depth, $key, $value)
Handles date process for the XML exporter
=cut
sub XML_element
{
    my ($self) = shift;
    my ($context, $depth, $key, $value) = @_;
    my ($fh) = $context->{'fh'};
    my ($output, @time);
    my (@month) = qw(JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC);
    return $self->SUPER::XML_element(@_) unless ($key eq 'created' || $key eq 'modified');
    @time = gmtime($self->getdate($key eq 'created'));
    $output = sprintf("%d/%s/%d %d:%d:%d", $time[3], $month[$time[4]], $time[5] + 1900,
            $time[2], $time[1], $time[0]);
    $fh->print("$depth<$key>$output</$key>\n");
    $self;
}
     
=head2 $t->update
Updates the head table based on the glyph data and the hmtx table
=cut
sub update
{
    my ($self) = @_;
    my ($num, $i, $loc, $hmtx);
    my ($xMin, $yMin, $xMax, $yMax, $lsbx);
    $num = $self->{' PARENT'}{'maxp'}{'numGlyphs'};
    return undef unless (defined $self->{' PARENT'}{'hmtx'} && defined $self->{' PARENT'}{'loca'});
    $hmtx = $self->{' PARENT'}{'hmtx'}->read;
    return undef unless ($self->{' PARENT'}{'loca'}{' isDirty'} || $hmtx->{' isDirty'});
     
    $self->{' PARENT'}{'loca'}->update;
    $hmtx->update;
    $lsbx = 1;
    for ($i = 0; $i < $num; $i++)
    {
        $loc = $self->{' PARENT'}{'loca'}{'glyphs'}[$i];
        next unless defined $loc;
        $loc->read;
        $xMin = $loc->{'xMin'} if ($loc->{'xMin'} < $xMin || $i == 0);
        $yMin = $loc->{'yMin'} if ($loc->{'yMin'} < $yMin || $i == 0);
        $xMax = $loc->{'xMax'} if ($loc->{'xMax'} > $xMax);
        $yMax = $loc->{'yMax'} if ($loc->{'yMax'} > $yMax);
        $lsbx &= ($loc->{'xMin'} == $hmtx->{'lsb'}[$i]);
    }
    $self->{'xMin'} = $xMin;
    $self->{'yMin'} = $yMin;
    $self->{'xMax'} = $xMax;
    $self->{'yMax'} = $yMax;
    if ($lsbx)
    { $self->{'flags'} |= 2; }
    else
    { $self->{'flags'} &= ~2; }
    $self->{' isDirty'} = 1;            # tell everyone else we've changed (I assume)
    $self;
}
=head2 $t->getdate($is_create)
Converts font modification time (or creation time if $is_create is set) to a 32-bit integer as returned
from time(). Returns undef if the value is out of range, either before the epoch or after the maximum
storable time.
=cut
sub getdate
{
    my ($self, $is_create) = @_;
    my ($arr) = $self->{$is_create ? 'created' : 'modified'};
    $arr->[1] -= 2082844800;        # seconds between 1/Jan/1904 and 1/Jan/1970 (midnight)
    if ($arr->[1] < 0)
    {
        $arr->[1] += 0xFFFFFFF; $arr->[1]++;
        $arr->[0]--;
    }
    return undef if $arr->[0] != 0;
    return $arr->[1];
}
=head2 $t->setdate($time, $is_create)
Sets the time information for modification (or creation time if $is_create is set) according to the 32-bit
time information.
=cut
sub setdate
{
    my ($self, $time, $is_create) = @_;
    my (@arr);
    $arr[1] = $time;
    if ($arr[1] >= 0x83DA4F80)
    {
        $arr[1] -= 0xFFFFFFFF;
        $arr[1]--;
        $arr[0]++;
    }
    $arr[1] += 2082844800;
    $self->{$is_create ? 'created' : 'modified'} = \@arr;
    $self;
}
     
1;
=head1 BUGS
None known
=head1 AUTHOR
Martin Hosken Martin_Hosken@sil.org. See L<Font::TTF::Font> for copyright and
licensing.
=cut
__DATA__
version, f
fontRevision, f
checkSumAdjustment, L
magicNumber, L
flags, S
unitsPerEm, S
created, L2
modified, L2
xMin, s
yMin, s
xMax, s
yMax, s
macStyle, S
lowestRecPPEM, S
fontDirectionHint, s
indexToLocFormat, s
glyphDataFormat, s