NAME

PDF::API2::Resource::BaseFont - Base class for font resources

METHODS

$font = PDF::API2::Resource::BaseFont->new $pdf, $name

Returns a font resource object.

$font = PDF::API2::Resource::BaseFont->new_api $api, $name

Returns a font resource object. This method is different from 'new' that it needs an PDF::API2-object rather than a Text::PDF::File-object.

$descriptor = $font->descrByData()

Returns the fonts FontDescriptor key-structure based on the fonts data.

FONT-MANAGEMENT RELATED METHODS

$name = $font->fontname()

Returns the fonts name (aka. display-name).

$name = $font->altname()

Returns the fonts alternative-name (aka. windows-name for a postscript font).

$name = $font->subname()

Returns the fonts subname (aka. font-variant, schriftschnitt).

$name = $font->apiname()

Returns the fonts name to be used internally (should be equal to $font->name).

$issymbol = $font->issymbol()

Returns the fonts symbol flag.

$iscff = $font->iscff()

Returns the fonts compact-font-format flag.

TYPOGRAPHY RELATED METHODS

($llx, $lly, $urx, $ury) = $font->fontbbox()

Returns the fonts bounding-box.

$capheight = $font->capheight()

Returns the fonts capheight value.

$xheight = $font->xheight()

Returns the fonts xheight value.

$missingwidth = $font->missingwidth()

Returns the fonts missingwidth value.

$maxwidth = $font->maxwidth()

Returns the fonts maxwidth value.

$avgwidth = $font->avgwidth()

Returns the fonts avgwidth value.

$flags = $font->flags()

Returns the fonts flags value.

$stemv = $font->stemv()

Returns the fonts stemv value.

$stemh = $font->stemh()

Returns the fonts stemh value.

$italicangle = $font->italicangle()

Returns the fonts italicangle value.

$isfixedpitch = $font->isfixedpitch()

Returns the fonts isfixedpitch flag.

$underlineposition = $font->underlineposition()

Returns the fonts underlineposition value.

$underlinethickness = $font->underlinethickness()

Returns the fonts underlinethickness value.

$ascender = $font->ascender()

Returns the fonts ascender value.

$descender = $font->descender()

Returns the fonts descender value.

GLYPH RELATED METHODS

@names = $font->glyphNames()

Returns the defined glyph-names of the font.

$glNum = $font->glyphNum()

Returns the number of defined glyph-names of the font.

$uni = $font->uniByGlyph $char

Returns the unicode by glyph-name.

$uni = $font->uniByEnc $char

Returns the unicode by the fonts encoding map.

$uni = $font->uniByMap $char

Returns the unicode by the fonts default map.

$char = $font->encByGlyph $glyph

Returns the character by the given glyph-name of the fonts encoding map.

$char = $font->encByUni $uni

Returns the character by the given unicode of the fonts encoding map.

$char = $font->mapByGlyph $glyph

Returns the character by the given glyph-name of the fonts default map.

$char = $font->mapByUni $uni

Returns the character by the given unicode of the fonts default map.

$name = $font->glyphByUni $unicode

Returns the glyphs name by the fonts unicode map. BEWARE: non-standard glyph-names are mapped onto the ms-symbol area (0xF000).

$name = $font->glyphByEnc $char

Returns the glyphs name by the fonts encoding map.

$name = $font->glyphByMap $char

Returns the glyphs name by the fonts default map.

$width = $font->wxByGlyph $glyph

Returns the glyphs width.

$width = $font->wxByUni $uni

Returns the unicodes width.

$width = $font->wxByEnc $char

Returns the characters width based on the current encoding.

$width = $font->wxByMap $char

Returns the characters width based on the fonts default encoding.

$wd = $font->width $text

Returns the width of $text as if it were at size 1. BEWARE: works only correctly if a proper perl-string is used either in native or utf8 format (check utf8-flag).

@widths = $font->width_array $text

Returns the widths of the words in $text as if they were at size 1.

STRING METHODS

$utf8string = $font->utfByStr $string

Returns the utf8-string from string based on the fonts encoding map.

$string = $font->strByUtf $utf8string

Returns the encoded string from utf8-string based on the fonts encoding map.

$pdfstring = $font->textByStr $text

Returns a properly formatted representation of $text for use in the PDF.