Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

font::ttf::kern(3) [centos man page]

Font::TTF::Kern(3)					User Contributed Perl Documentation					Font::TTF::Kern(3)

NAME

       Font::TTF::Kern - Kerning tables

DESCRIPTION

       Kerning tables are held as an ordered collection of subtables each giving incremental information regarding the kerning of various pairs of
       glyphs.

       The basic structure of the kerning data structure is:

	   $kern = $f->{'kern'}{'tables'}[$tnum]{'kerns'}{$leftnum}{$rightnum};

       Due to the possible complexity of some kerning tables the above information is insufficient. Reference also needs to be made to the type of
       the table and the coverage field.

INSTANCE VARIABLES

       The instance variables for a kerning table are relatively straightforward.

       Version
	   Version number of the kerning table

       Num Number of subtables in the kerning table

       tables
	   Array of subtables in the kerning table

	       Each subtable has a number of instance variables.

	       kern

	       A two level hash array containing kerning values. The indexing is left value and then right value. In the case of type 2 tables,
	       the indexing is via left class and right class. It may seem using hashes is strange, but most tables are not type 2 and this method
	       saves empty array values.

	       type

	       Stores the table type. Only type 0 and type 2 tables are specified for TrueType so far.

	       coverage

	       A bit field of coverage information regarding the kerning value. See the TrueType specification for details.

	       Version

	       Contains the version number of the table.

	       Num

	       Number of kerning pairs in this type 0 table.

	       left

	       An array indexed by glyph - left_first which returns a class number for the glyph in type 2 tables.

	       right

	       An array indexed by glyph - right_first which returns a class number for the glyph in type 2 tables.

	       left_first

	       the glyph number of the first element in the left array for type 2 tables.

	       right_first

	       the glyph number of the first element in the right array for type 2 tables.

	       num_left

	       Number of left classes

	       num_right

	       Number of right classes

METHODS

   $t->read
       Reads the whole kerning table into structures

   $t->out($fh)
       Outputs the kerning tables to the given file

   $t->XML_element($context, $depth, $key, $value)
       Handles outputting the kern hash into XML a little more tidily

BUGS

       o   Only supports kerning table types 0 & 2.

       o   No real support functions to do anything with the kerning tables yet.

AUTHOR

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

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 38:
	   You can't have =items (as at line 42) unless the first thing after the =over is an =item

perl v5.16.3							    2012-02-23							Font::TTF::Kern(3)

Check Out this Related Man Page

Font::TTF::Ttc(3pm)					User Contributed Perl Documentation				       Font::TTF::Ttc(3pm)

NAME

       Font::TTF::Ttc - Truetype Collection class

DESCRIPTION

       A TrueType collection is a collection of TrueType fonts in one file in which tables may be shared between different directories. In order
       to support this, the TTC introduces the concept of a table being shared by different TrueType fonts. This begs the question of what should
       happen to the ' PARENT' property of a particular table. It is made to point to the first directory object which refers to it. It is
       therefore up to the application to sort out any confusion.  Confusion only occurs if shared tables require access to non-shared tables.
       This should not happen since the shared tables are dealing with glyph information only and the private tables are dealing with encoding and
       glyph identification. Thus the general direction is from identification to glyph and not the other way around (at least not without
       knowledge of the particular context).

INSTANCE VARIABLES

       The following instance variables are preceded by a space

       fname (P)
	   Filename for this TrueType Collection

       INFILE (P)
	   The filehandle of this collection

       The following instance variable does not start with a space

       directs
	   An array of directories (Font::TTF::Font objects) for each sub-font in the directory

METHODS

   Font::TTF::Ttc->open($fname)
       Opens and reads the given filename as a TrueType Collection. Reading a collection involves reading each of the directories which go to make
       up the collection.

   $c->read
       Reads a Collection by reading all the directories in the collection

   $c->find($direct, $name, $check, $off, $len)
       Hunts around to see if a table with the given characteristics of name, checksum, offset and length has been associated with a directory
       earlier in the list.  Actually on checks the offset since no two tables can share the same offset in a TrueType font, collection or
       otherwise.

   $c->DESTROY
       Closees any opened files by us

BUGS

       No known bugs, but then not ever executed!

AUTHOR

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

perl v5.10.1							    2009-01-21						       Font::TTF::Ttc(3pm)
Man Page