Pdf/Cmap.php

Show:

inherited

Classes
- \Zend_Pdf_Cmap

Table of Contents

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to [email protected] so we can send you a copy immediately.

Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Package: Zend_Pdf
Subpackage: Fonts
Version: $Id: Cmap.php 24593 2012-01-05 20:35:02Z matthew $

\Zend_Pdf_Cmap
jump to top

Package: Zend\Pdf\Fonts

Abstract helper class for {@link Zend_Pdf_Resource_Font} which manages font character maps.

Defines the public interface for concrete subclasses which are responsible for mapping Unicode characters to the font's glyph numbers. Also provides shared utility methods.

Cmap objects should ordinarily be obtained through the factory method cmapWithTypeData().

The supported character map types are those found in the OpenType spec. For additional detail on the internal binary format of these tables, see:

Children: \Zend_Pdf_Cmap_ByteEncoding; \Zend_Pdf_Cmap_TrimmedTable; \Zend_Pdf_Cmap_SegmentToDelta
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Todo: Write code for Zend_Pdf_FontCmap_HighByteMapping class.
Todo: Write code for Zend_Pdf_FontCmap_MixedCoverage class.
Todo: Write code for Zend_Pdf_FontCmap_TrimmedArray class.
Todo: Write code for Zend_Pdf_FontCmap_SegmentedCoverage class.

Constants

 
                TYPE_BYTE_ENCODING
                = 0

Byte Encoding character map table type.

 
                TYPE_HIGH_BYTE_MAPPING
                = 2

High Byte Mapping character map table type.

 
                TYPE_SEGMENT_TO_DELTA
                = 4

Segment Value to Delta Mapping character map table type.

 
                TYPE_TRIMMED_TABLE
                = 6

Trimmed Table character map table type.

 
                TYPE_MIXED_COVERAGE
                = 8

Mixed Coverage character map table type.

 
                TYPE_TRIMMED_ARRAY
                = 10

Trimmed Array character map table type.

 
                TYPE_SEGMENTED_COVERAGE
                = 12

Segmented Coverage character map table type.

 
                TYPE_BYTE_ENCODING_STATIC
                = 241

Static Byte Encoding character map table type.

Variant of TYPE_BYTEENCODING.

 
                TYPE_UNKNOWN
                = 255

Unknown character map table type.

 
                MISSING_CHARACTER_GLYPH
                = 0

Glyph representing missing characters.

Methods

__construct(string $cmapData) : void

abstract

Object constructor

Parses the raw binary table data. Throws an exception if the table is malformed.

Parameters

Name	Type	Description
$cmapData	string	Raw binary cmap table data.

Throws

Exception	Description
\Zend_Pdf_Exception

_extractInt2(string $data, integer $index) : integer

Extracts a signed 2-byte integer from a string.

Integers are always big-endian. Throws an exception if the index is out of range.

Parameters

Name	Type	Description
$data	string	&$data
$index	integer	Position in string of integer.

Returns

Type	Description
integer

Throws

Exception	Description
\Zend_Pdf_Exception

_extractUInt2(string $data, integer $index) : integer

Extracts an unsigned 2-byte integer from a string.

Integers are always big-endian. Throws an exception if the index is out of range.

Parameters

Name	Type	Description
$data	string	&$data
$index	integer	Position in string of integer.

Returns

Type	Description
integer

Throws

Exception	Description
\Zend_Pdf_Exception

_extractUInt4(string $data, integer $index) : integer

Extracts an unsigned 4-byte integer from a string.

Integers are always big-endian. Throws an exception if the index is out of range.

NOTE: If you ask for a 4-byte unsigned integer on a 32-bit machine, the resulting value WILL BE SIGNED because PHP uses signed integers internally for everything. To guarantee portability, be sure to use bitwise or similar operators on large integers!

Parameters

Name	Type	Description
$data	string	&$data
$index	integer	Position in string of integer.

Returns

Type	Description
integer

Throws

Exception	Description
\Zend_Pdf_Exception

cmapWithTypeData(integer $cmapType, mixed $cmapData) : \Zend_Pdf_Cmap

static

Instantiates the appropriate concrete subclass based on the type of cmap table and returns the instance.

The cmap type must be one of the following values:

Throws an exception if the table type is invalid or the cmap table data cannot be validated.

Parameters

Name	Type	Description
$cmapType	integer	Type of cmap.
$cmapData	mixed	Cmap table data. Usually a string or array.

Returns

Type	Description
\Zend_Pdf_Cmap

Throws

Exception	Description
\Zend_Pdf_Exception

getCoveredCharacters() : array

abstract

Returns an array containing the Unicode characters that have entries in this character map.

Returns

Type	Description
array	Unicode character codes.

glyphNumberForCharacter(integer $characterCode) : integer

abstract

Returns the glyph number corresponding to the Unicode character.

If a particular character doesn't exist in this font, the special 'missing character glyph' will be substituted.

See also glyphNumbersForCharacters() which is optimized for bulk operations.

Parameters

Name	Type	Description
$characterCode	integer	Unicode character code (code point).

Returns

Type	Description
integer	Glyph number.

glyphNumbersForCharacters(array $characterCodes) : array

abstract

Returns an array of glyph numbers corresponding to the Unicode characters.

If a particular character doesn't exist in this font, the special 'missing character glyph' will be substituted.

Pdf/Cmap.php

\Zend_Pdf_Cmapjump to top

Constants

Methods

\Zend_Pdf_Cmap
jump to top