View on GitHub


Read font files and render glyphs using FreeType2

[Raku PDF Project] / [Font-FreeType Module] / Font::FreeType :: GlyphImage

class Font::FreeType::GlyphImage

Glyph images from font typefaces


use Font::FreeType;

my Font::FreeType $freetype .= new;
my $face = $freetype.face('Vera.ttf');
$face.set-char-size(24, 24, 100, 100);

for $face.glyph-images('ABC') {
    # Read vector outline.
    my $svg = .outline.svg;
    my $bitmap = .bitmap;


This class represents individual glyph images (character image) loaded from a font.

set-bold(int strength)

Embolden the glyph. This needs to be done before calling either the bitmap() or outline() methods.


If the glyph is from a bitmap font, the bitmap image is returned. If it is from a vector font, then it is converted into a bitmap glyph. The outline is rendered into a bitmap at the face’s current size.

If anti-aliasing is used then shades of grey between 0 and 255 may occur. Anti-aliasing is performed by default, but can be turned off by passing the FT_RENDER_MODE_MONO option.

The size of the bitmap can be obtained as follows:

my $bitmap = $glyph-image.bitmap;
my $width =  $bitmap.width;
my $height = $bitmap.height;

The optional :render-mode argument can be any one of the following:

bitmap_magick( :render-mode_) ** NYI **

A simple wrapper around the bitmap() method. Renders the bitmap as normal and returns it as an Image::Magick object, which can then be composited onto a larger bit-mapped image, or manipulated using any of the features available in Image::Magick.

The image is in the ‘gray’ format, with a depth of 8 bits.

The left and top distances in pixels are returned as well, in the same way as for the bitmap() method.

This method, particularly the use of the left and top offsets for correct positioning of the bitmap, is demonstrated in the example program.


True if the glyph has a vector outline, in which case it is safe to call outline. Otherwise, the glyph only has a bitmap image.


Returns an object of type Font::FreeType::Outline

See Also


Geoff Richards

David Warring (Raku Port)

Copyright 2004, Geoff Richards.

Ported from Perl to Raku by David Warring Copyright 2017.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.