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

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

NAME

       Font::TTF::Utils - Utility functions to save fingers

DESCRIPTION

       Lots of useful functions to save my fingers, especially for trivial tables

FUNCTIONS

       The following functions are exported

   ($val, $pos) = TTF_Init_Fields ($str, $pos)
       Given a field description from the "DATA" section, creates an absolute entry in the fields associative array for the class

   TTF_Read_Fields($obj, $dat, $fields)
       Given a block of data large enough to account for all the fields in a table, processes the data block to convert to the values in the
       objects instance variables by name based on the list in the "DATA" block which has been run through "TTF_Init_Fields"

   TTF_Unpack($fmt, $dat)
       A TrueType types equivalent of Perls "unpack" function. Thus $fmt consists of type followed by an optional number of elements to read
       including *. The type may be one of:

	   c	   BYTE
	   C	   CHAR
	   f	   FIXED
	   F	   F2DOT14
	   l	   LONG
	   L	   ULONG
	   s	   SHORT
	   S	   USHORT
	   v	   Version number (FIXED)

       Note that "FUNIT", "FWORD" and "UFWORD" are not data types but units.

       Returns array of scalar (first element) depending on context

   $dat = TTF_Out_Fields($obj, $fields, $len)
       Given the fields table from "TTF_Init_Fields" writes out the instance variables from the object to the filehandle in TTF binary form.

   $dat = TTF_Pack($fmt, @data)
       The TrueType equivalent to Perl's "pack" function. See details of "TTF_Unpack" for how to work the $fmt string.

   ($num, $range, $select, $shift) = TTF_bininfo($num)
       Calculates binary search information from a number of elements

   TTF_word_utf8($str)
       Returns the UTF8 form of the 16 bit string, assumed to be in big endian order, including surrogate handling

   TTF_utf8_word($str)
       Returns the 16-bit form in big endian order of the UTF 8 string, including surrogate handling to Unicode.

   XML_hexdump($context, $dat)
       Dumps out the given data as a sequence of <data> blocks each 16 bytes wide

   XML_outhints
       Converts a binary string of hinting code into a textual representation

   make_circle($f, $cmap, [$dia, $sb, $opts])
       Adds a dotted circle to a font. This function is very configurable. The parameters passed in are:

       $f  Font to work with. This is required.

       $cmap
	   A cmap table (not the 'val' sub-element of a cmap) to add the glyph too. Optional.

       $dia
	   Optional diameter for the main circle. Defaults to 80% em

       $sb Side bearing. The left and right side-bearings are always the same. This value defaults to 10% em.

       There are various options to control all sorts of interesting aspects of the circle

       numDots
	   Number of dots in the circle

       numPoints
	   Number of curve points to use to create each dot

       uid Unicode reference to store this glyph under in the cmap. Defaults to 0x25CC

       pname
	   Postscript name to give the glyph. Defaults to uni25CC.

       -dRadius
	   Radius of each dot.

BUGS

       No known bugs

AUTHOR

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

perl v5.16.3							    2012-05-23						       Font::TTF::Utils(3)

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)

Linux and UNIX Man Pages

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

Check Out this Related Man Page