Latest commit 32dd26b
Mar 18, 2017
It's used elsewhere in the tool-chain (PDF::Content)
|Failed to load latest commit information.|
NAME Font::AFM - Interface to Adobe Font Metrics files SYNOPSIS use Font::AFM; my $h = Font::AFM.new: "Helvetica"; my $copyright = $h.Notice; my $w = $h.Wx<aring>; $w = $h.stringwidth("Gisle", 10); DESCRIPTION This module implements the Font::AFM class. Objects of this class are initialised from an AFM-file and allows you to obtain information about the font and the metrics of the various glyphs in the font. All measurements in AFM files are given in terms of units equal to 1/1000 of the scale factor of the font being used. To compute actual sizes in a document, these amounts should be multiplied by (scale factor of font)/1000. The following methods are available: my $afm = Font::AFM.new($fontname) Object constructor. Takes the name of the font as argument. It will croak if the font can not be found. $afm.stringwidth($string, $fontsize, :kern, :%glyphs) Returns the width of the string passed as argument. The string is assumed to be encoded in the iso-8859-1 character set. A second argument can be used to scale the width according to the font size. :kern - make kerning adjustments :%glyphs - is an optional mapping of characters to glyph-names. characters not in the glyph-map are ignored. $afm.kern($string, $fontsize, :%glyphs) Kern the string. Returns an array of string segments, separated by numeric kerning distances, plus the overall width of the string. :%glyphs - an optional mapping of characters to glyph-names. $afm.FontName The name of the font as presented to the PostScript language `findfont' operator, for instance "Times-Roman". $afm.FullName Unique, human-readable name for an individual font, for instance "Times Roman". $afm.FamilyName Human-readable name for a group of fonts that are stylistic variants of a single design. All fonts that are member of such a group should have exactly the same `FamilyName'. Example of a family name is "Times". $afm.Weight Human-readable name for the weight, or "boldness", attribute of a font. Exampes are `Roman', `Bold', `Light'. $afm.ItalicAngle Angle in degrees counterclockwise from the vertical of the dominant vertical strokes of the font. $afm.IsFixedPitch If the value is `true', it indicated that the font is a fixed-pitch (monospaced) font. $afm.FontBBox An array of integers giving the lower-left x, lower-left y, upper-right x, and upper-right y of the font bounding box. The font bounding box is the smallest rectangle enclosing the shape that would result if all the characters of the font were placed with their origins coincident, and then painted. $afm.KernData A two dimensional hash containing from and to glyphs and kerning widths. $afm.UnderlinePosition Recommended distance from the baseline for positioning underline stokes. This number is the y coordinate of the center of the stroke. $afm.UnderlineThickness Recommended stroke width for underlining. $afm.Version Version number of the font. $afm.Notice Trademark or copyright notice, if applicable. $afm.Comment Comments found in the AFM file. $afm.EncodingScheme The name of the standard encoding scheme for the font. Most Adobe fonts use the `AdobeStandardEncoding'. Special fonts might state `FontSpecific'. $afm.CapHeight Usually the y-value of the top of the capital H. $afm.XHeight Typically the y-value of the top of the lowercase x. $afm.Ascender Typically the y-value of the top of the lowercase d. $afm.Descender Typically the y-value of the bottom of the lowercase p. $afm.Wx Returns a hash table that maps from glyph names to the width of that glyph. $afm.BBox Returns a hash table that maps from glyph names to bounding box information. The bounding box consist of 4 numbers: llx, lly, urx, ury. The AFM specification can be found at: http://partners.adobe.com/asn/developer/pdfs/tn/5004.AFM_Spec.pdf ENVIRONMENT METRICS Contains the path to seach for AFM-files. Format is as for the PATH environment variable. The default path built into this library is: /usr/lib/afm:/usr/local/lib/afm:/usr/openwin/lib/fonts/afm/:. BUGS Composite character and Ligature data are not parsed. COPYRIGHT Copyright 1995-1998 Gisle Aas. All rights reserved. Ported from Perl 5 to 6 by David Warring Copyright 2015. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.