This module is considered internal.
Its use is deprecated and it will be removed in a future version.
A python interface to Adobe Font Metrics Files.
Although a number of other Python implementations exist, and may be more complete than this, it was decided not to go with them because they were either:
copyrighted or used a non-BSD compatible license
had too many dependencies and a free standing lib was needed
did more than needed and it was easier to write afresh rather than figure out how to get just what was needed.
It is pretty easy to use, and has no external dependencies:
>>> import matplotlib as mpl >>> from pathlib import Path >>> afm_path = Path(mpl.get_data_path(), 'fonts', 'afm', 'ptmr8a.afm') >>> >>> from matplotlib.afm import AFM >>> with afm_path.open('rb') as fh: ... afm = AFM(fh) >>> afm.string_width_height('What the heck?') (6220.0, 694) >>> afm.get_fontname() 'Times-Roman' >>> afm.get_kern_dist('A', 'f') 0 >>> afm.get_kern_dist('A', 'y') -92.0 >>> afm.get_bbox_char('!') [130, -9, 238, 676]
As in the Adobe Font Metrics File Format Specification, all dimensions are given in units of 1/1000 of the scale factor (point size) of the font being used.
- class matplotlib._afm.AFM(fh)[source]#
Parse the AFM file in file object fh.
- property family_name#
The font family name, e.g., 'Times'.
- get_height_char(c, isord=False)[source]#
Get the bounding box (ink) height of character c (space is 0).
Return the standard horizontal stem width as float, or None if not specified in AFM file.
- get_kern_dist_from_name(name1, name2)[source]#
Return the kerning pair distance (possibly 0) for chars name1 and name2.
Return the standard vertical stem width as float, or None if not specified in AFM file.
- get_width_char(c, isord=False)[source]#
Get the width of the character from the character metric WX field.
- property postscript_name#
- class matplotlib._afm.CharMetrics(width, name, bbox)[source]#
Represents the character metrics of a single character.
The fields do currently only describe a subset of character metrics information defined in the AFM standard.
Create new instance of CharMetrics(width, name, bbox)
The bbox of the character (B) as a tuple (llx, lly, urx, ury).
The character name (N).
The character width (WX).
- class matplotlib._afm.CompositePart(name, dx, dy)[source]#
Represents the information on a composite element of a composite char.
Create new instance of CompositePart(name, dx, dy)
x-displacement of the part from the origin.
y-displacement of the part from the origin.
Name of the part, e.g. 'acute'.