Pdf/Resource/Font/CidFont/TrueType.php

Show: PublicProtectedPrivateinherited
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 license@zend.com 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: TrueType.php 24593 2012-01-05 20:35:02Z matthew $  

\Zend_Pdf_Resource_Font_CidFont_TrueType

Package: Zend\Pdf\Fonts
Type 2 CIDFonts implementation

For Type 2, the CIDFont program is actually a TrueType font program, which has no native notion of CIDs. In a TrueType font program, glyph descriptions are identified by glyph index values. Glyph indices are internal to the font and are not defined consistently from one font to another. Instead, a TrueType font program contains a 'cmap' table that provides mappings directly from character codes to glyph indices for one or more predefined encodings.

Parent(s)
\Zend_Pdf_Resource_Font_CidFont < \Zend_Pdf_Resource_Font < \Zend_Pdf_Resource
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  

Properties

>VPropertyprotectedinteger $_ascent = 0
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_ascent  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_ascent  
>VPropertyprotectedarray $_charWidths = null
inherited
Array containing the widths of each character that have entries in used character map.
Inherited from: \Zend_Pdf_Resource_Font_CidFont::$$_charWidths
Default valuenullDetails
Type
array
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_charWidths  
>VPropertyprotected\Zend_Pdf_Cmap $_cmap = null
inherited
Object representing the font's cmap (character to glyph map).
Inherited from: \Zend_Pdf_Resource_Font_CidFont::$$_cmap
Default valuenullDetails
Type
\Zend_Pdf_Cmap
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_cmap  
>VPropertyprotectedinteger $_descent = 0
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_descent  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_descent  
>VPropertyprotectedarray $_fontNames = array()
inherited
Array containing descriptive names for the font.
Inherited from: \Zend_Pdf_Resource_Font::$$_fontNames\Zend_Pdf_Resource_Font_CidFont::$$_fontNames
Default valuearray()Details
Type
array
Inherited_from
\Zend_Pdf_Resource_Font::$$_fontNames  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_fontNames  
>VPropertyprotectedinteger $_fontType = \Zend_Pdf_Font::TYPE_UNKNOWN

Use TYPE_ constants defined in Zend_Pdf_Font.

Default value\Zend_Pdf_Font::TYPE_UNKNOWNDetails
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_fontType  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_fontType  
>VPropertyprotectedboolean $_isBold = false
inherited
Flag indicating whether or not this font is bold.
Inherited from: \Zend_Pdf_Resource_Font::$$_isBold\Zend_Pdf_Resource_Font_CidFont::$$_isBold
Default valuefalseDetails
Type
boolean
Inherited_from
\Zend_Pdf_Resource_Font::$$_isBold  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_isBold  
>VPropertyprotectedboolean $_isItalic = false
inherited
Flag indicating whether or not this font is italic.
Inherited from: \Zend_Pdf_Resource_Font::$$_isItalic\Zend_Pdf_Resource_Font_CidFont::$$_isItalic
Default valuefalseDetails
Type
boolean
Inherited_from
\Zend_Pdf_Resource_Font::$$_isItalic  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_isItalic  
>VPropertyprotectedboolean $_isMonospace = false
inherited
Flag indicating whether or not this font is monospaced.
Inherited from: \Zend_Pdf_Resource_Font::$$_isMonospace\Zend_Pdf_Resource_Font_CidFont::$$_isMonospace
Default valuefalseDetails
Type
boolean
Inherited_from
\Zend_Pdf_Resource_Font::$$_isMonospace  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_isMonospace  
>VPropertyprotectedinteger $_lineGap = 0
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_lineGap  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_lineGap  
>VPropertyprotectedinteger $_missingCharWidth = 0
inherited
Width for characters missed in the font
Inherited from: \Zend_Pdf_Resource_Font_CidFont::$$_missingCharWidth
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_missingCharWidth  
>VPropertyprotected\Zend_Pdf_ElementFactory_Interface $_objectFactory

..) interacts with a PDF itself. It creates appropriate PDF objects, structures and sometime embedded files. Resources are referenced in content streams by names, which are stored in a page resource dictionaries.

Thus, resources must be attached to the PDF.

Resource abstraction uses own PDF object factory to store all necessary information. At the render time internal object factory is appended to the global PDF file factory.

Resource abstraction also cashes information about rendered PDF files and doesn't duplicate resource description each time then Resource is rendered (referenced).

Details
Type
\Zend_Pdf_ElementFactory_Interface
Inherited_from
\Zend_Pdf_Resource::$$_objectFactory  
Inherited_from
\Zend_Pdf_Resource_Font::$$_objectFactory  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_objectFactory  
>VPropertyprotectedinteger $_strikePosition = 0
inherited
The position above the text baseline of the strikethrough (in glyph units).
Inherited from: \Zend_Pdf_Resource_Font::$$_strikePosition\Zend_Pdf_Resource_Font_CidFont::$$_strikePosition
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_strikePosition  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_strikePosition  
>VPropertyprotectedinteger $_strikeThickness = 0
inherited
The thickness of the strikethrough (in glyph units).
Inherited from: \Zend_Pdf_Resource_Font::$$_strikeThickness\Zend_Pdf_Resource_Font_CidFont::$$_strikeThickness
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_strikeThickness  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_strikeThickness  
>VPropertyprotectedinteger $_underlinePosition = 0
inherited
The position below the text baseline of the underline (in glyph units).
Inherited from: \Zend_Pdf_Resource_Font::$$_underlinePosition\Zend_Pdf_Resource_Font_CidFont::$$_underlinePosition
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_underlinePosition  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_underlinePosition  
>VPropertyprotectedinteger $_underlineThickness = 0
inherited
The thickness of the underline (in glyph units).
Inherited from: \Zend_Pdf_Resource_Font::$$_underlineThickness\Zend_Pdf_Resource_Font_CidFont::$$_underlineThickness
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_underlineThickness  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_underlineThickness  
>VPropertyprotectedinteger $_unitsPerEm = 0
Default value0Details
Type
integer
Inherited_from
\Zend_Pdf_Resource_Font::$$_unitsPerEm  
Inherited_from
\Zend_Pdf_Resource_Font_CidFont::$$_unitsPerEm  

Methods

methodpublic__clone() : void
inherited

Clone page, extract it and dependent objects from the current document, so it can be used within other docs.

Inherited from: \Zend_Pdf_Resource::__clone()\Zend_Pdf_Resource_Font::__clone()\Zend_Pdf_Resource_Font_CidFont::__clone()
methodpublic__construct(\Zend_Pdf_FileParser_Font_OpenType_TrueType $fontParser, integer $embeddingOptions) : void

Object constructor

If resource is not a Zend_Pdf_Element object, then stream object with specified value is generated.

Parameters
NameTypeDescription
$fontParser\Zend_Pdf_FileParser_Font_OpenType_TrueType

Font parser object containing parsed TrueType file.

$embeddingOptionsinteger

Options for font embedding.

Throws
ExceptionDescription
\Zend_Pdf_Exception
Details
Todo
Joing this class with Zend_Pdf_Resource_Font_Simple_Parsed_TrueType  
methodpublic__toString() : string
inherited

Returns the full name of the font in the encoding method of the current locale.

Inherited from: \Zend_Pdf_Resource_Font::__toString()\Zend_Pdf_Resource_Font_CidFont::__toString()

Transliterates any characters that cannot be naturally represented in that character set.

Returns
TypeDescription
string
methodpublicdecodeString(string $string, string $charEncoding) : string
inherited

Convert string from the font encoding.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::decodeString()

The method is used to convert strings retrieved from existing content streams

Parameters
NameTypeDescription
$stringstring
$charEncodingstring

Character encoding of resulting text.

Returns
TypeDescription
string
Throws
ExceptionDescription
\Zend_Pdf_Exception
methodpublicencodeString(string $string, string $charEncoding) : string
inherited

Convert string to the font encoding.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::encodeString()

The method is used to prepare string for text drawing operators

Parameters
NameTypeDescription
$stringstring
$charEncodingstring

Character encoding of source text.

Returns
TypeDescription
string
Throws
ExceptionDescription
\Zend_Pdf_Exception
methodpublicgetAscent() : integer
inherited

Returns the typographic ascent in font glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getAscent()\Zend_Pdf_Resource_Font_CidFont::getAscent()

The typographic ascent is the distance from the font's baseline to the top of the text frame. It is frequently used to locate the initial baseline for a paragraph of text inside a given rectangle.

Returns
TypeDescription
integer
methodpublicgetCoveredPercentage(string $string, string $charEncoding = '') : float
inherited

Returns a number between 0 and 1 inclusive that indicates the percentage of characters in the string which are covered by glyphs in this font.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::getCoveredPercentage()

Since no one font will contain glyphs for the entire Unicode character range, this method can be used to help locate a suitable font when the actual contents of the string are not known.

Note that some fonts lie about the characters they support. Additionally, fonts don't usually contain glyphs for control characters such as tabs and line breaks, so it is rare that you will get back a full 1.0 score. The resulting value should be considered informational only.

Parameters
NameTypeDescription
$stringstring
$charEncodingstring

(optional) Character encoding of source text. If omitted, uses 'current locale'.

Returns
TypeDescription
float
methodpublicgetDescent() : integer
inherited

Returns the typographic descent in font glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getDescent()\Zend_Pdf_Resource_Font_CidFont::getDescent()

The typographic descent is the distance below the font's baseline to the bottom of the text frame. It is always negative.

Returns
TypeDescription
integer
methodpublicgetFontName(integer $nameType, mixed $language, string $characterSet = null) : string
inherited

Returns the specified descriptive name for the font.

Inherited from: \Zend_Pdf_Resource_Font::getFontName()\Zend_Pdf_Resource_Font_CidFont::getFontName()

The font name type is usually one of the following:

Note that not all names are available for all fonts. In addition, some fonts may contain additional names, whose indicies are in the range 256 to 32767 inclusive, which are used for certain font layout features.

If the preferred language translation is not available, uses the first available translation for the name, which is usually English.

If the requested name does not exist, returns null.

All names are stored internally as Unicode strings, using UTF-16BE encoding. You may optionally supply a different resulting character set.

Parameters
NameTypeDescription
$nameTypeinteger

Type of name requested.

$languagemixed

Preferred language (string) or array of languages in preferred order. Use the ISO 639 standard 2-letter language codes.

$characterSetstring

(optional) Desired resulting character set. You may use any character set supported by {@link iconv()};

Returns
TypeDescription
string
methodpublicgetFontNames() : array
Returns
TypeDescription
array
methodpublicgetFontType() : integer
Returns
TypeDescription
integerOne of the TYPE_ constants defined in {@link Zend_Pdf_Font}.
methodpublicgetLineGap() : integer
inherited

Returns the typographic line gap in font glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getLineGap()\Zend_Pdf_Resource_Font_CidFont::getLineGap()

The typographic line gap is the distance between the bottom of the text frame of one line to the top of the text frame of the next. It is typically combined with the typographical ascent and descent to determine the font's total line height (or leading).

Returns
TypeDescription
integer
methodpublicgetLineHeight() : integer
inherited

Returns the suggested line height (or leading) in font glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getLineHeight()\Zend_Pdf_Resource_Font_CidFont::getLineHeight()

This value is determined by adding together the values of the typographic ascent, descent, and line gap. This value yields the suggested line spacing as determined by the font developer.

It should be noted that this is only a guideline; layout engines will frequently modify this value to achieve special effects such as double- spacing.

Returns
TypeDescription
integer
methodpublicgetStrikePosition() : integer
inherited

Returns the suggested position above the text baseline of the strikethrough in glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getStrikePosition()\Zend_Pdf_Resource_Font_CidFont::getStrikePosition()
Returns
TypeDescription
integer
methodpublicgetStrikeThickness() : integer
inherited

Returns the suggested line thickness of the strikethrough in glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getStrikeThickness()\Zend_Pdf_Resource_Font_CidFont::getStrikeThickness()
Returns
TypeDescription
integer
methodpublicgetUnderlinePosition() : integer
inherited

Returns the suggested position below the text baseline of the underline in glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getUnderlinePosition()\Zend_Pdf_Resource_Font_CidFont::getUnderlinePosition()

This value is usually negative.

Returns
TypeDescription
integer
methodpublicgetUnderlineThickness() : integer
inherited

Returns the suggested line thickness of the underline in glyph units.

Inherited from: \Zend_Pdf_Resource_Font::getUnderlineThickness()\Zend_Pdf_Resource_Font_CidFont::getUnderlineThickness()
Returns
TypeDescription
integer
methodpublicgetUnitsPerEm() : integer
inherited

Returns the number of glyph units per em.

Inherited from: \Zend_Pdf_Resource_Font::getUnitsPerEm()\Zend_Pdf_Resource_Font_CidFont::getUnitsPerEm()

Used to convert glyph space to user space. Frequently used in conjunction with widthsForGlyphs() to calculate the with of a run of text.

Returns
TypeDescription
integer
methodpublicglyphNumberForCharacter(integer $characterCode) : integer
inherited

Returns the glyph number corresponding to the Unicode character.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::glyphNumberForCharacter()

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
NameTypeDescription
$characterCodeinteger

Unicode character code (code point).

Returns
TypeDescription
integerGlyph number.
methodpublicglyphNumbersForCharacters(array $characterCodes) : array
inherited

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

Inherited from: \Zend_Pdf_Resource_Font_CidFont::glyphNumbersForCharacters()

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

See also glyphNumberForCharacter().

Parameters
NameTypeDescription
$characterCodesarray

Array of Unicode character codes (code points).

Returns
TypeDescription
arrayArray of glyph numbers.
methodpublicisBold() : boolean
inherited

Returns true if font is bold.

Inherited from: \Zend_Pdf_Resource_Font::isBold()\Zend_Pdf_Resource_Font_CidFont::isBold()
Returns
TypeDescription
boolean
methodpublicisItalic() : boolean
inherited

Returns true if font is italic.

Inherited from: \Zend_Pdf_Resource_Font::isItalic()\Zend_Pdf_Resource_Font_CidFont::isItalic()
Returns
TypeDescription
boolean
methodpublicisMonospace() : boolean
inherited

Returns true if font is monospace.

Inherited from: \Zend_Pdf_Resource_Font::isMonospace()\Zend_Pdf_Resource_Font_CidFont::isMonospace()
Returns
TypeDescription
boolean
methodpublicwidthForChar(integer $charCode) : integer
inherited

Returns the width of the character.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::widthForChar()

Like widthsForChars() but used for one char at a time.

Parameters
NameTypeDescription
$charCodeinteger
Returns
TypeDescription
integer
methodpublicwidthForGlyph(integer $glyphNumber) : integer
inherited

Returns the width of the glyph.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::widthForGlyph()

Like widthsForGlyphs() but used for one glyph at a time.

Parameters
NameTypeDescription
$glyphNumberinteger
Returns
TypeDescription
integer
Throws
ExceptionDescription
\Zend_Pdf_Exception
methodpublicwidthsForChars(array $charCodes) : array
inherited

Returns the widths of the Chars.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::widthsForChars()

The widths are expressed in the font's glyph space. You are responsible for converting to user space as necessary. See unitsPerEm().

See also widthForChar().

Parameters
NameTypeDescription
$charCodesarray

&$glyphNumbers Array of glyph numbers.

Returns
TypeDescription
arrayArray of glyph widths (integers).
methodpublicwidthsForGlyphs(array $glyphNumbers) : array
inherited

Returns the widths of the glyphs.

Inherited from: \Zend_Pdf_Resource_Font_CidFont::widthsForGlyphs()

The widths are expressed in the font's glyph space. You are responsible for converting to user space as necessary. See unitsPerEm().

See also widthForGlyph().

Parameters
NameTypeDescription
$glyphNumbersarray

&$glyphNumbers Array of glyph numbers.

Returns
TypeDescription
arrayArray of glyph widths (integers).
Throws
ExceptionDescription
\Zend_Pdf_Exception
Documentation was generated by phpDocumentor 2.0.0a12.