font::ttf::gdef(3pm) [debian man page]

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

NAME

       Font::TTF::GDEF - Opentype GDEF table support

DESCRIPTION

       The GDEF table contains various global lists of information which are apparantly used in other places in an OpenType renderer. But
       precisely where is open to speculation...

INSTANCE VARIABLES

       There are 4 tables in the GDEF table, each with their own structure:

       GLYPH
	   This is an Font::TTF::Coverage Class Definition table containing information as to what type each glyph is.

       ATTACH
	   The attach table consists of a coverage table and then attachment points for each glyph in the coverage table:

	   COVERAGE
		   This is a coverage table

	   POINTS  This is an array of point elements. Each element is an array of curve points corresponding to the attachment points on that
		   glyph. The order of the curve points in the array corresponds to the attachment point number specified in the MARKS coverage
		   table (see below).

       LIG This contains the ligature caret positioning information for ligature glyphs

	   COVERAGE
		   A coverage table to say which glyphs are ligatures

	   LIGS    An array of elements for each ligature. Each element is an array of information for each caret position in the ligature (there
		   being number of components - 1 of these, generally)

		   FMT	       This is the format of the information and is important to provide the semantics for the value. This value must be
			       set correctly before output

		   VAL	       The value which has meaning according to FMT

		   DEVICE      For FMT = 3, a device table is also referenced which is stored here

       MARKS
	   Due to confusion in the GDEF specification, this field is currently withdrawn until the confusion is resolved. That way, perhaps this
	   stuff will work!

	   This class definition table stores the mark attachment point numbers for each attachment mark, to indicate which attachment point the
	   mark attaches to on its base glyph.

METHODS

   $t->read
       Reads the table into the data structure

   $t->out($fh)
       Writes out this table.

perl v5.10.1							    2009-01-29						      Font::TTF::GDEF(3pm)

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

NAME

       Font::TTF::Loca - the Locations table, which is intimately tied to the glyf table

DESCRIPTION

       The location table holds the directory of locations of each glyph within the glyf table. Due to this relationship and the unimportance of
       the actual locations when it comes to holding glyphs in memory, reading the location table results in the creation of glyph objects for
       each glyph and stores them here.  So if you are looking for glyphs, don't look in the "glyf" table, look here instead.

       Things get complicated if you try to change the glyph list within the one table.  The recommendation is to create another clean location
       object to replace this table in the font, ensuring that the old table is read first and to transfer or copy glyphs across from the read
       table to the new table.

INSTANCE VARIABLES

       The instance variables do not start with a space

       glyphs
	   An array of glyph objects for each glyph.

       glyphtype
	   A string containing the class name to create for each new glyph. If empty, defaults to Font::TTF::Glyph.

METHODS

   $t->new
       Creates a new location table making sure it has a glyphs array

   $t->read
       Reads the location table creating glyph objects (Font::TTF::Glyph) for each glyph allowing their later reading.

   $t->out($fh)
       Writes the location table out to $fh. Notice that not having read the location table implies that the glyf table has not been read either,
       so the numbers in the location table are still valid. Let's hope that "maxp/numGlyphs" and "head/indexToLocFmt" haven't changed otherwise
       we are in big trouble.

       The function uses the OUTLOC location in the glyph calculated when the glyf table was attempted to be output.

   $t->out_xml($context, $depth)
       No need to output a loca table, this is dynamically generated

   $t->glyphs_do(&func)
       Calls func for each glyph in this location table in numerical order:

	   &func($glyph, $glyph_num)

BUGS

       None known

AUTHOR

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

perl v5.10.1							    2009-01-21						      Font::TTF::Loca(3pm)