Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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

NAME

       Font::TTF::Segarr - Segmented array

DESCRIPTION

       Holds data either directly or indirectly as a series of arrays. This class looks after the set of arrays and masks the individual sub-
       arrays, thus saving a class, we hope.

INSTANCE VARIABLES

       All instance variables do not start with a space.

       The segmented array is simply an array of segments

       Each segment is a more complex affair:

       START
	   In terms of the array, the address for the 0th element in this segment.

       LEN Number of elements in this segment

       VAL The array which contains the elements

METHODS

   Font::TTF::Segarr->new($size)
       Creates a new segmented array with a given data size

   $s->fastadd_segment($start, $is_sparse, @dat)
       Creates a new segment and adds it to the array assuming no overlap between the new segment and any others in the array. $is_sparse
       indicates whether the passed in array contains "undef"s or not. If false no checking is done (which is faster, but riskier). If equal to 2
       then 0 is considered undef as well.

       Returns the number of segments inserted.

   $s->add_segment($start, $overwrite, @dat)
       Creates a new segment and adds it to the array allowing for possible overlaps between the new segment and the existing ones. In the case of
       overlaps, elements from the new segment are deleted unless $overwrite is set in which case the elements already there are over-written.

       This method also checks the data coming in to see if it is sparse (i.e. contains undef values). Gaps cause new segments to be created or
       not to over-write existing values.

   $s->tidy
       Merges any immediately adjacent segments

   $s->at($addr, [$len])
       Looks up the data held at the given address by locating the appropriate segment etc. If $len > 1 then returns an array of values, spaces
       being filled with undef.

   $s->remove($addr, [$len])
       Removes the item or items from addr returning them as an array or the first value in a scalar context. This is very like "at", including
       padding with undef, but it deletes stuff as it goes.

   $s->copy
       Deep copies this array

   $s->copy_seg($seg)
       Creates a deep copy of a segment

BUGS

       No known bugs.

AUTHOR

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

perl v5.10.1							    2009-01-21						    Font::TTF::Segarr(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