init III
This commit is contained in:
320
Perl OTRS/Kernel/cpan-lib/Font/TTF/GrFeat.pm
Normal file
320
Perl OTRS/Kernel/cpan-lib/Font/TTF/GrFeat.pm
Normal file
@@ -0,0 +1,320 @@
|
||||
package Font::TTF::GrFeat;
|
||||
|
||||
=head1 NAME
|
||||
|
||||
Font::TTF::GrFeat - Graphite Font Features
|
||||
|
||||
=head1 DESCRIPTION
|
||||
|
||||
=head1 INSTANCE VARIABLES
|
||||
|
||||
=over 4
|
||||
|
||||
=item version
|
||||
|
||||
=item features
|
||||
|
||||
An array of hashes of the following form
|
||||
|
||||
=over 8
|
||||
|
||||
=item feature
|
||||
|
||||
feature id number
|
||||
|
||||
=item name
|
||||
|
||||
name index in name table
|
||||
|
||||
=item exclusive
|
||||
|
||||
exclusive flag
|
||||
|
||||
=item default
|
||||
|
||||
the default setting number
|
||||
|
||||
=item settings
|
||||
|
||||
hash of setting number against name string index
|
||||
|
||||
=back
|
||||
|
||||
=back
|
||||
|
||||
=head1 METHODS
|
||||
|
||||
=cut
|
||||
|
||||
use strict;
|
||||
use vars qw(@ISA);
|
||||
|
||||
use Font::TTF::Utils;
|
||||
|
||||
require Font::TTF::Table;
|
||||
|
||||
@ISA = qw(Font::TTF::Table);
|
||||
|
||||
=head2 $t->read
|
||||
|
||||
Reads the features from the TTF file into memory
|
||||
|
||||
=cut
|
||||
|
||||
sub read
|
||||
{
|
||||
my ($self) = @_;
|
||||
my ($featureCount, $features);
|
||||
|
||||
return $self if $self->{' read'};
|
||||
$self->SUPER::read_dat or return $self;
|
||||
|
||||
($self->{'version'}, $featureCount) = TTF_Unpack("vS", $self->{' dat'});
|
||||
|
||||
$features = [];
|
||||
foreach (1 .. $featureCount) {
|
||||
my ($feature, $nSettings, $settingTable, $featureFlags, $nameIndex, $reserved);
|
||||
if ($self->{'version'} == 1)
|
||||
{
|
||||
($feature, $nSettings, $settingTable, $featureFlags, $nameIndex)
|
||||
= TTF_Unpack("SSLSS", substr($self->{' dat'}, $_ * 12, 12));
|
||||
#The version 1 Feat table ends with a feature (id 1) named NoName
|
||||
#with zero settings but with an offset to the last entry in the setting
|
||||
#array. This last setting has id 0 and an invalid name id. This last
|
||||
#feature is changed to have one setting.
|
||||
if ($_ == $featureCount && $nSettings == 0) {$nSettings = 1;}
|
||||
}
|
||||
else #version == 2
|
||||
{($feature, $nSettings, $reserved, $settingTable, $featureFlags, $nameIndex)
|
||||
= TTF_Unpack("LSSLSS", substr($self->{' dat'}, 12 + ($_ - 1) * 16, 16))};
|
||||
$feature =
|
||||
{
|
||||
'feature' => $feature,
|
||||
'name' => $nameIndex,
|
||||
};
|
||||
|
||||
#interpret the featureFlags & store settings
|
||||
$feature->{'exclusive'} = (($featureFlags & 0x8000) != 0);
|
||||
|
||||
my @settings = TTF_Unpack("S*", substr($self->{' dat'}, $settingTable, $nSettings * 4));
|
||||
if ($featureFlags & 0x4000)
|
||||
{$feature->{'default'} = $featureFlags & 0x00FF;}
|
||||
else
|
||||
{$feature->{'default'} = $settings[0];}
|
||||
$feature->{'settings'} = {@settings};
|
||||
|
||||
push(@$features, $feature);
|
||||
}
|
||||
|
||||
$self->{'features'} = $features;
|
||||
|
||||
delete $self->{' dat'}; # no longer needed, and may become obsolete
|
||||
$self->{' read'} = 1;
|
||||
$self;
|
||||
}
|
||||
|
||||
=head2 $t->out($fh)
|
||||
|
||||
Writes the features to a TTF file
|
||||
|
||||
=cut
|
||||
|
||||
sub out
|
||||
{
|
||||
my ($self, $fh) = @_;
|
||||
my ($features, $numFeatures, $settings, $featureFlags, $featuresData, $settingsData);
|
||||
|
||||
return $self->SUPER::out($fh) unless $self->{' read'};
|
||||
|
||||
$features = $self->{'features'};
|
||||
$numFeatures = @$features;
|
||||
$featuresData = $settingsData = '';
|
||||
|
||||
foreach (@$features) {
|
||||
$settings = $_->{'settings'};
|
||||
$featureFlags = ($_->{'exclusive'} ? 0x8000 : 0x0000);
|
||||
|
||||
# output default setting first instead of using the featureFlags (as done below)
|
||||
# $featureFlags = ($_->{'exclusive'} ? 0x8000 : 0x0000) |
|
||||
# ($_->{'default'} != 0 ? 0x4000 | ($_->{'default'} & 0x00FF)
|
||||
# : 0x0000);
|
||||
if ($self->{'version'} == 1)
|
||||
{
|
||||
$featuresData .= TTF_Pack("SSLSS",
|
||||
$_->{'feature'},
|
||||
scalar keys %$settings,
|
||||
12 + 12 * $numFeatures + length $settingsData,
|
||||
$featureFlags,
|
||||
$_->{'name'});
|
||||
}
|
||||
else #version == 2
|
||||
{
|
||||
$featuresData .= TTF_Pack("LSSLSS",
|
||||
$_->{'feature'},
|
||||
scalar keys %$settings,
|
||||
0,
|
||||
12 + 16 * $numFeatures + length $settingsData,
|
||||
$featureFlags,
|
||||
$_->{'name'});
|
||||
}
|
||||
|
||||
#output default setting first
|
||||
#the settings may not be in their original order
|
||||
my $defaultSetting = $_->{'default'};
|
||||
$settingsData .= TTF_Pack("SS", $defaultSetting, $settings->{$defaultSetting});
|
||||
foreach (sort {$a <=> $b} keys %$settings) {
|
||||
if ($_ == $defaultSetting) {next;} #skip default setting
|
||||
$settingsData .= TTF_Pack("SS", $_, $settings->{$_});
|
||||
}
|
||||
}
|
||||
|
||||
$fh->print(TTF_Pack("vSSL", $self->{'version'}, $numFeatures, 0, 0));
|
||||
$fh->print($featuresData);
|
||||
$fh->print($settingsData);
|
||||
|
||||
$self;
|
||||
}
|
||||
|
||||
=head2 $t->minsize()
|
||||
|
||||
Returns the minimum size this table can be. If it is smaller than this, then the table
|
||||
must be bad and should be deleted or whatever.
|
||||
|
||||
=cut
|
||||
|
||||
sub minsize
|
||||
{
|
||||
return 6;
|
||||
}
|
||||
|
||||
=head2 $t->print($fh)
|
||||
|
||||
Prints a human-readable representation of the table
|
||||
|
||||
=cut
|
||||
|
||||
sub print
|
||||
{
|
||||
my ($self, $fh) = @_;
|
||||
my ($names, $features, $settings);
|
||||
|
||||
$self->read;
|
||||
|
||||
$names = $self->{' PARENT'}->{'name'};
|
||||
$names->read;
|
||||
|
||||
$fh = 'STDOUT' unless defined $fh;
|
||||
|
||||
$features = $self->{'features'};
|
||||
foreach (@$features) {
|
||||
$fh->printf("Feature %s, %s, default: %d name %d # '%s'\n",
|
||||
$_->{'feature'} > 0x01000000 ? '"' . $self->num_to_tag($_->{'feature'}) . '"' : $_->{'feature'},
|
||||
($_->{'exclusive'} ? "exclusive" : "additive"),
|
||||
$_->{'default'},
|
||||
$_->{'name'},
|
||||
$names->{'strings'}[$_->{'name'}][3][1]{1033});
|
||||
$settings = $_->{'settings'};
|
||||
foreach (sort { $a <=> $b } keys %$settings) {
|
||||
$fh->printf("\tSetting %d, name %d # '%s'\n",
|
||||
$_, $settings->{$_}, $names->{'strings'}[$settings->{$_}][3][1]{1033});
|
||||
}
|
||||
}
|
||||
|
||||
$self;
|
||||
}
|
||||
|
||||
sub settingName
|
||||
{
|
||||
my ($self, $feature, $setting) = @_;
|
||||
|
||||
$self->read;
|
||||
|
||||
my $names = $self->{' PARENT'}->{'name'};
|
||||
$names->read;
|
||||
|
||||
my $features = $self->{'features'};
|
||||
my ($featureEntry) = grep { $_->{'feature'} == $feature } @$features;
|
||||
my $featureName = $names->{'strings'}[$featureEntry->{'name'}][3][1]{1033};
|
||||
my $settingName = $featureEntry->{'exclusive'}
|
||||
? $names->{'strings'}[$featureEntry->{'settings'}->{$setting}][3][1]{1033}
|
||||
: $names->{'strings'}[$featureEntry->{'settings'}->{$setting & ~1}][3][1]{1033}
|
||||
. (($setting & 1) == 0 ? " On" : " Off");
|
||||
|
||||
($featureName, $settingName);
|
||||
}
|
||||
|
||||
=head2 $t->tag_to_num ($feat_str)
|
||||
|
||||
Convert an alphanumeric feature id tag (string) to a number (32-bit).
|
||||
Tags are normally 4 chars. Graphite ignores space
|
||||
padding if it is present, so we do the same here.
|
||||
|
||||
=cut
|
||||
|
||||
sub tag_to_num
|
||||
{
|
||||
my ($self, $feat_tag) = @_;
|
||||
my $new_feat_num;
|
||||
|
||||
if ($feat_tag > 0)
|
||||
{$new_feat_num = $feat_tag;} # already a number, so just return it.
|
||||
else
|
||||
{
|
||||
$feat_tag =~ s/[ \000]+$//o; # strip trailing nulls or space
|
||||
$new_feat_num = unpack('N', pack('a4', $feat_tag)); #adds null padding on right if less than 4 chars
|
||||
}
|
||||
|
||||
return $new_feat_num;
|
||||
}
|
||||
|
||||
=head2 $t->num_to_tag ($feat_num)
|
||||
|
||||
Convert a feature id number (32-bit) back to a tag (string).
|
||||
Trailing space or null padding is removed.
|
||||
Feature id numbers that do not represent alphanumeric tags
|
||||
are returned unchanged.
|
||||
|
||||
=cut
|
||||
|
||||
sub num_to_tag
|
||||
{
|
||||
my ($self, $feat_num) = @_;
|
||||
my $new_feat_tag;
|
||||
|
||||
if ($feat_num > 0x01000000)
|
||||
{
|
||||
$new_feat_tag = unpack('a4', pack('N', $feat_num));
|
||||
$new_feat_tag =~ s/[ \000]+$//o; # strip trailing nulls or space
|
||||
}
|
||||
else
|
||||
{$new_feat_tag = $feat_num;}
|
||||
|
||||
return $new_feat_tag;
|
||||
}
|
||||
|
||||
1;
|
||||
|
||||
=head1 BUGS
|
||||
|
||||
The version 1 Feat table ends with a feature (id 1) named NoName
|
||||
with zero settings but with an offset to the last entry in the setting
|
||||
array. This last setting has id 0 and an invalid name id. This last
|
||||
feature is changed to have one setting.
|
||||
|
||||
=head1 AUTHOR
|
||||
|
||||
Alan Ward (derived from Jonathan Kew's Feat.pm).
|
||||
|
||||
|
||||
=head1 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.
|
||||
|
||||
|
||||
|
||||
=cut
|
||||
|
||||
|
||||
Reference in New Issue
Block a user