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

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

NAME

       Font::TTF::OS_2 - the OS/2 table in a TTF font

DESCRIPTION

       The OS/2 table has two versions and forms, one an extension of the other. This module supports both forms and the switching between them.

INSTANCE VARIABLES

       No other variables than those in table and those in the standard:

	   Version
	   xAvgCharWidth
	   usWeightClass
	   usWidthClass
	   fsType
	   ySubscriptXSize
	   ySubScriptYSize
	   ySubscriptXOffset
	   ySubscriptYOffset
	   ySuperscriptXSize
	   ySuperscriptYSize
	   ySuperscriptXOffset
	   ySuperscriptYOffset
	   yStrikeoutSize
	   yStrikeoutPosition
	   sFamilyClass
	   bFamilyType
	   bSerifStyle
	   bWeight
	   bProportion
	   bContrast
	   bStrokeVariation
	   bArmStyle
	   bLetterform
	   bMidline
	   bXheight
	   ulUnicodeRange1
	   ulUnicodeRange2
	   ulUnicodeRange3
	   ulUnicodeRange4
	   achVendID
	   fsSelection
	   usFirstCharIndex
	   usLastCharIndex
	   sTypoAscender
	   sTypoDescender
	   sTypoLineGap
	   usWinAscent
	   usWinDescent
	   ulCodePageRange1
	   ulCodePageRange2
	   xHeight
	   CapHeight
	   defaultChar
	   breakChar
	   maxLookups

       Notice that versions 0, 1, 2 & 3 of the table are supported. Notice also that the Panose variable has been broken down into its elements.

METHODS

   $t->read
       Reads in the various values from disk (see details of OS/2 table)

   $t->out($fh)
       Writes the table to a file either from memory or by copying.

   $t->XML_element($context, $depth, $key, $value)
       Tidies up the hex values to output them in hex

   $t->XML_end($context, $tag, %attrs)
       Now handle them on the way back in

   $t->update
       Updates the OS/2 table by getting information from other sources:

       Updates the "firstChar" and "lastChar" values based on the MS table in the cmap.

       Updates the sTypoAscender, sTypoDescender & sTypoLineGap to be the same values as Ascender, Descender and Linegap from the hhea table
       (assuming it is dirty) and also sets usWinAscent to be the sum of Ascender+Linegap and usWinDescent to be the negative of Descender.

BUGS

       None known

AUTHOR

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

perl v5.16.3							    2012-05-17							Font::TTF::OS_2(3)

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

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 preceeded 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 preceeded 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.16.3							    2012-02-23						     Font::TTF::OldCmap(3)