Alfred Reibenschuh > PDF-API2-0.71.001 > PDF::API2::Basic::TTF::Name

Download:
PDF-API2-0.71.001.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  4
Open  7
View/Report Bugs
Module Version: 1.1   Source   Latest Release: PDF-API2-0.73

NAME ^

PDF::API2::Basic::TTF::Name - String table for a TTF font

DESCRIPTION ^

Strings are held by number, platform, encoding and language. Strings are accessed as:

    $f->{'name'}{'strings'}[$number][$platform_id][$encoding_id]{$language_id}

Notice that the language is held in an associative array due to its sparse nature on some platforms such as Microsoft ($pid = 3). Notice also that the array order is different from the stored array order (platform, encoding, language, number) to allow for easy manipulation of strings by number (which is what I guess most people will want to do).

By default, $PDF::API2::Basic::TTF::Name::utf8 is set to 1, and strings will be stored as UTF8 wherever possible. The method is_utf8 can be used to find out if a string in a particular platform and encoding will be returned as UTF8. Unicode strings are always converted if utf8 is requested. Otherwise, strings are stored according to platform:

    ***WARNING NON-UTF8 is deprecated and utf8 strings has become the default***

You now have to set <$PDF::API2::Basic::TTF::Name::utf8> to 0 to get the old behaviour.

Apple Unicode (platform id = 0)

Data is stored as network ordered UCS2. There is no encoding id for this platform but there are language ids as per Mac language ids.

Mac (platform id = 1)

Data is stored as 8-bit binary data, leaving the interpretation to the user according to encoding id.

Unicode (platform id = 2)

Currently stored as 16-bit network ordered UCS2. Upon release of Perl 5.005 this will change to utf8 assuming current UCS2 semantics for all encoding ids.

Windows (platform id = 3)

As per Unicode, the data is currently stored as 16-bit network ordered UCS2. Upon release of Perl 5.005 this will change to utf8 assuming current UCS2 semantics for all encoding ids.

INSTANCE VARIABLES ^

strings

An array of arrays, etc.

METHODS ^

$t->read

Reads all the names into memory

$t->out($fh)

Writes out all the strings

$t->XML_element($context, $depth, $key, $value)

Outputs the string element in nice XML (which is all the table really!)

$t->XML_end($context, $tag, %attrs)

Store strings in the right place

is_utf8($pid, $eid)

Returns whether a string of a given platform and encoding is going to be in UTF8

find_name($nid)

Hunts down a name in all the standard places and returns the string and for an array context the pid, eid & lid as well

BUGS ^

AUTHOR ^

Martin Hosken Martin_Hosken@sil.org. See PDF::API2::Basic::TTF::Font for copyright and licensing.

syntax highlighting: