toyplot.font module

Font management and font metrics.

class toyplot.font.Font[source]

Abstract interface for objects that return information about a specific combination of typeface and size.

property ascent

Font ascent (maximum height above the baseline).

property descent

Font descent (maximum height below the baseline).

width(string)[source]

Return the width of a string if rendered using the font.

Parameters:: string (str, required) – The text to be measured.
Returns:: width – Width of the string in CSS pixels, if rendered using the given font and font size.
Return type:: number

class toyplot.font.Library[source]

Bases: object

Abstract interface for objects that manage a collection of fonts.

font(style)[source]

Lookup a font using CSS style information and return a corresponding Font object.

class toyplot.font.ReportlabFont(family, size)[source]

Bases: Font

Use Reportlab to access the metrics for a font.

Parameters:

font_family (str) – PDF font family to use for measurement.
font_size (number) – Font size for the measurement. Defaults to CSS pixel units, and supports all toyplot Units.

property ascent

Font ascent (maximum height above the baseline).

property descent

Font descent (maximum height below the baseline).

width(string)[source]

Return the width of a string if rendered using the font.

Parameters:

Returns:

width – Width of the string in CSS pixels, if rendered using the given font and font size.

Return type:

number

class toyplot.font.ReportlabLibrary[source]

Bases: Library

Use Reportlab to provide information about standard PDF fonts.

font(style)[source]

Lookup a font using CSS style information and return a corresponding Font object.