Pdf/Resource/Font/Type0.php
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-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Pdf
- Subpackage
- Fonts
- Version
- $Id$
\Zend_Pdf_Resource_Font_Type0
Package: Zend_Pdf\FontsAdobe PDF composite fonts implementation
A composite font is one whose glyphs are obtained from other fonts or from fontlike
objects called CIDFonts ({@link Zend_Pdf_Resource_Font_CidFont}), organized hierarchically.
In PDF, a composite font is represented by a font dictionary whose Subtype value is Type0;
this is also called a Type 0 font (the Type 0 font at the top level of the hierarchy is the
root font).
In PDF, a Type 0 font is a CID-keyed font.
CID-keyed fonts provide effective method to operate with multi-byte character encodings.
The CID-keyed font architecture specifies the external representation of certain font programs,
called CMap and CIDFont files, along with some conventions for combining and using those files.
A CID-keyed font is the combination of a CMap with one or more CIDFonts, simple fonts,
or composite fonts containing glyph descriptions.
The term 'CID-keyed font' reflects the fact that CID (character identifier) numbers
are used to index and access the glyph descriptions in the font.
Font objects should be normally be obtained from the factory methods
{@link Zend_Pdf_Font::fontWithName} and {@link Zend_Pdf_Font::fontWithPath}.
- Parent(s)
- \Zend_Pdf_Resource_Font
<
\Zend_Pdf_Resource
- Copyright
- Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Properties
Methods
decodeString(string $string, string $charEncoding) : string
Convert string from the font encoding.
The method is used to convert strings retrieved from existing content streams
ParametersName | Type | Description |
---|
$string | string | |
---|
$charEncoding | string | Character encoding of resulting text. |
---|
ReturnsencodeString(string $string, string $charEncoding) : string
Convert string to the font encoding.
The method is used to prepare string for text drawing operators
ParametersName | Type | Description |
---|
$string | string | |
---|
$charEncoding | string | Character encoding of source text. |
---|
ReturnsgetCoveredPercentage(string $string, string $charEncoding = '') : float
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.
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.
ParametersName | Type | Description |
---|
$string | string | |
---|
$charEncoding | string | (optional) Character encoding of source text.
If omitted, uses 'current locale'. |
---|
ReturnsglyphNumberForCharacter(integer $characterCode) : integer
Returns the glyph number corresponding to the Unicode character.
Zend_Pdf uses 'Identity-H' encoding for Type 0 fonts.
So we don't need to perform any conversion
ParametersName | Type | Description |
---|
$characterCode | integer | Unicode character code (code point). |
---|
ReturnsType | Description |
---|
integer | Glyph number. |
glyphNumbersForCharacters(array $characterCodes) : array
Returns an array of glyph numbers corresponding to the Unicode characters.
Zend_Pdf uses 'Identity-H' encoding for Type 0 fonts.
So we don't need to perform any conversion
See also {@link glyphNumberForCharacter()}.
ParametersName | Type | Description |
---|
$characterCodes | array | Array of Unicode character codes (code points). |
---|
ReturnsType | Description |
---|
array | Array of glyph numbers. |
widthForGlyph(integer $glyphNumber) : integer
Returns the width of the glyph.
Like {@link widthsForGlyphs()} but used for one glyph at a time.
ParametersName | Type | Description |
---|
$glyphNumber | integer | |
---|
ReturnsThrowswidthsForGlyphs( $glyphNumbers) : array
Returns the widths of the glyphs.
The widths are expressed in the font's glyph space. You are responsible
for converting to user space as necessary. See {@link unitsPerEm()}.
Throws an exception if the glyph number is out of range.
See also {@link widthForGlyph()}.
ParametersName | Type | Description |
---|
$glyphNumbers | | |
---|
ReturnsType | Description |
---|
array | Array of glyph widths (integers). |
Throws