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(3pm) [debian man page]

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

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.

perl v5.10.1							    2011-02-25						      Font::TTF::Kern(3pm)

Check Out this Related Man Page

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

NAME

       Font::TTF::OldCmap - Character map table

       This module is deprecated

DESCRIPTION

       Looks after the character map. The primary structure used for handling a cmap is the Font::TTF::Segarr which handles the segmented arrays
       of format 4 tables, and in a simpler form for format 0 tables.

       Due to the complexity of working with segmented arrays, most of the handling of such arrays is via methods rather than via instance
       variables.

       One important feature of a format 4 table is that it always contains a segment with a final address of 0xFFFF. If you are creating a table
       from scratch this is important (although Font::TTF::Segarr can work quite happily without it).

INSTANCE VARIABLES

       The instance variables listed here are not preceded by a space due to their emulating structural information in the font.

       Num Number of subtables in this table

       Tables
	   An array of subtables ([0..Num-1])

       Each subtables also has its own instance variables which are, again, not preceded by a space.

       Platform
	   The platform number for this subtable

       Encoding
	   The encoding number for this subtable

       Format
	   Gives the stored format of this subtable

       Ver Gives the version (or language) information for this subtable

       val This points to a Font::TTF::Segarr which contains the content of the particular subtable.

METHODS

   $t->read
       Reads the cmap into memory. Format 4 subtables read the whole subtable and fill in the segmented array accordingly.

       Format 2 subtables are not read at all.

   $t->ms_lookup($uni)
       Given a Unicode value in the MS table (Platform 3, Encoding 1) locates that table and looks up the appropriate glyph number from it.

   $t->find_ms
       Finds the Microsoft Unicode table and sets the "mstable" instance variable to it if found. Returns the table it finds.

   $t->out($fh)
       Writes out a cmap table to a filehandle. If it has not been read, then just copies from input file to output

   @map = $t->reverse([$num])
       Returns a reverse map of the table of given number or the Microsoft cmap. I.e. given a glyph gives the Unicode value for it.

BUGS

       o   No support for format 2 tables (MBCS)

AUTHOR

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

perl v5.10.1							    2011-02-25						   Font::TTF::OldCmap(3pm)
Man Page