NAME

PDF::API2::Resource::Font::SynFont - Module for creating synthetic Fonts.

SYNOPSIS

    my $pdf = PDF::API2->new();
    my $base_font = $pdf->font('Helvetica');

    # Create a condensed synthetic font
    my $condensed = $pdf->synthetic_font($base_font, hscale => 80);

    # Compare the two fonts
    my $text = $pdf->page->text();

    $text->font($base_font, 18);
    $text->distance(72, 720);
    $text->text('Hello World!');

    $text->font($condensed, 18);
    $text->distance(0, -36);
    $text->text('Hello World!');

    $pdf->save('sample.pdf');

DESCRIPTION

This module allows you to create a custom font based on an existing font, adjusting the scale, stroke thickness, angle, and other properties of each glyph.

FONT OPTIONS

hscale

A percentage to condense (less than 100) or expand (greater than 100) the glyphs horizontally.

angle

A number of degrees to lean the glyphs to the left (negative angle) or to the right (positive angle).

bold

A stroke width, in thousandths of a text unit, to add to the glyph's outline, creating a bold effect.

smallcaps

Set to true to replace lower-case characters with small versions of their upper-case glyphs.

space

Additional space, in thousandths of a text unit, to add between glyphs.