Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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

NAME

       Font::TTF::Cmap - Character map table

DESCRIPTION

       Looks after the character map. For ease of use, the actual cmap is held in a hash against codepoint. Thus for a given table:

	   $gid = $font->{'cmap'}{'Tables'}[0]{'val'}{$code};

       Note that $code should be a true value(0x1234) rather than a string representation.

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 A hash keyed by the codepoint value (not a string) storing the glyph id

METHODS

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

   $t->ms_lookup($uni)
       Finds a Unicode table, giving preference to the MS one, and looks up the given Unicode codepoint in it to find the glyph id.

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

   $t->ms_enc
       Returns the encoding of the microsoft table (0 => symbol, etc.). Returns undef if there is no Microsoft cmap.

   $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

   $t->XML_element($context, $depth, $name, $val)
       Outputs the elements of the cmap in XML. We only need to process val here

   @map = $t->reverse(%opt)
       Returns a reverse map of the Unicode cmap. I.e. given a glyph gives the Unicode value for it. Options are:

       tnum
	   Table number to use rather than the default Unicode table

       array
	   Returns each element of reverse as an array since a glyph may be mapped by more than one Unicode value. The arrays are unsorted.
	   Otherwise store any one unicode value for a glyph.

   is_unicode($index)
       Returns whether the table of a given index is known to be a unicode table (as specified in the specifications)

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::Cmap(3pm)

Check Out this Related Man Page

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

NAME

       Font::TTF::GSUB - Module support for the GSUB table in conjunction with TTOpen

DESCRIPTION

       Handles the GSUB subtables in relation to Ttopen tables. Due to the variety of different lookup types, the data structures are not all that
       straightforward, although I have tried to make life easy for myself when using this!

INSTANCE VARIABLES

       The structure of a GSUB table is the same as that given in Font::TTF::Ttopen.  Here we give some of the semantics specific to GSUB lookups.

       ACTION_TYPE
	   This is a string taking one of 4 values indicating the nature of the information in the ACTION array of the rule:

	   g	   The action contains a string of glyphs to replace the match string by

	   l	   The action array contains a list of offsets and lookups to run, in order, on the matched string

	   a	   The action array is an unordered set of optional replacements for the matched glyph. The application should make the selection
		   somehow.

	   o	   The action array is empty (in fact there is no rule array for this type of rule) and the ADJUST value should be added to the
		   glyph id to find the replacement glyph id value

       MATCH_TYPE
	   This indicates which type of information the various MATCH arrays (MATCH, PRE, POST) hold in the rule:

	   g	   The array holds a string of glyph ids which should match exactly

	   c	   The array holds a sequence of class definitions which each glyph should correspondingly match to

	   o	   The array holds offsets to coverage tables

CORRESPONDANCE TO LAYOUT TYPES

       The following table gives the values for ACTION_TYPE and MATCH_TYPE for each of the 11 different lookup types found in the GSUB table
       definition I have:

		       1.1 1.2 2   3   4   5.1 5.2 5.3 6.1 6.2 6.3
	 ACTION_TYPE	o   g  g   a   g    l	l   l	l   l	l
	 MATCH_TYPE		       g    g	c   o	g   c	o

       Hopefully, the rest of the uses of the variables should make sense from this table.

METHODS

   $t->read_sub($fh, $lookup, $index)
       Asked by the superclass to read in from the given file the indexth subtable from lookup number lookup. The file is positioned ready for the
       read.

   $t->extension
       Returns the table type number for the extension table

   $t->out_sub($fh, $lookup, $index)
       Passed the filehandle to output to, suitably positioned, the lookup and subtable index, this function outputs the subtable to $fh at that
       point.

AUTHOR

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

perl v5.16.3							    2011-10-13							Font::TTF::GSUB(3)
Man Page