METHODS¶

new( [ atts... ] )

For convenience only. Text::Layout::FontConfig is a singleton. Creating objects with new() will always return the same object.

Attributes:

register_fonts( $font, $family, $style [ , $weight ] [ , $props ] )

Registers a font fmaily, style and weight for the given font.

$font can be the name of a built-in font, or the name of a TrueType or OpenType font file.

$family is a font family name such as "normal", "sans", "serif", or "monospace". It is possible to specify multiple family names, e.g., "times, serif".

$style is the slant style, one of "normal", "oblique", or "italic".

$weight is the font weight, like "normal", or "bold".

For convenience, style combinations like "bolditalic" are allowed.

A final hash reference can be passed to specify additional properties for this font. Recognized properties are:

add_fontdirs( @dirs )

Adds one or more file paths to be searched for font files.

register_aliases( $family, $aliases, ... )

Adds aliases for existing font families.

Multiple aliases can be specified, e.g.

    $layout->register_aliases( "times", "serif, default" );
    

or

    $layout->register_aliases( "times", "serif", "default" );
    

register_corefonts( %options )

This is a convenience method that registers all built-in corefonts.

Aliases for families "serif", "sans", and "monospace" are added unless $noaliases is specified.

You do not need to call this method if you provide your own font registrations.

Options:

remap($font)

remap( $src => $dst, ... )

Handles font remapping. The main purpose is to remap corefonts to real fonts.

With a single argument, returns the remapped value, or undef if none.

With a hash argument, maps each of the targets (keys) to a font file (value). This file must be present in one of the font directories.

Alternatively, the key may be one of "Times", "Helvetica" and "Courier" and the value an already registered family.

find_font( $family, $style, $weight )

Returns a font descriptor based on the given family, style and weight.

On Linux, fallback using fontconfig.

from_string( $description )

Returns a font descriptor using a Pango-style font description, e.g. "Sans Italic 14".

On Linux, fallback using fontconfig.

parse( $description )

Parses a Pango-style font description and returns a hash ref with keys "family", "style", "weight", and "size".

Unspecified items are returned as empty strings or, in the case of "size", zero.

from_filename( $filename )

Returns a font descriptor from a filename. Tries to infer Pango data from the name.