Pdf/Resource/Font.php

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

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

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

The method is used to prepare string for text drawing operators

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.

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.

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

The font name type is usually one of the following:

• Zend_Pdf_Font::NAME_FULL
• Zend_Pdf_Font::NAME_FAMILY
• Zend_Pdf_Font::NAME_PREFERRED_FAMILY
• Zend_Pdf_Font::NAME_STYLE
• Zend_Pdf_Font::NAME_PREFERRED_STYLE
• Zend_Pdf_Font::NAME_DESCRIPTION
• Zend_Pdf_Font::NAME_SAMPLE_TEXT
• Zend_Pdf_Font::NAME_ID
• Zend_Pdf_Font::NAME_VERSION
• Zend_Pdf_Font::NAME_POSTSCRIPT
• Zend_Pdf_Font::NAME_CID_NAME
• Zend_Pdf_Font::NAME_DESIGNER
• Zend_Pdf_Font::NAME_DESIGNER_URL
• Zend_Pdf_Font::NAME_MANUFACTURER
• Zend_Pdf_Font::NAME_VENDOR_URL
• Zend_Pdf_Font::NAME_COPYRIGHT
• Zend_Pdf_Font::NAME_TRADEMARK
• Zend_Pdf_Font::NAME_LICENSE
• Zend_Pdf_Font::NAME_LICENSE_URL

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.

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).

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.

This value is usually negative.

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

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.

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

See also glyphNumberForCharacter().

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

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().