al_load_ttf_font(1) Allegro 5 API


#include <allegro5/allegro_ttf.h>
ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)


Loads a TrueType font from a file using the FreeType library. Quoting from the FreeType FAQ this means support for many different font formats:

TrueType, OpenType, Type1, CID, CFF, Windows FON/FNT, X11 PCF, and others

The size parameter determines the size the font will be rendered at, specified in pixels. The standard font size is measured in units per EM, if you instead want to specify the size as the total height of glyphs in pixels, pass it as a negative value.

Note: If you want to display text at multiple sizes, load the font multiple times with different size parameters.

The following flags are supported:

  • ALLEGRO_TTF_NO_KERNING - Do not use any kerning even if the font file supports it.
  • ALLEGRO_TTF_MONOCHROME - Load as a monochrome font (which means no anti-aliasing of the font is done).
  • ALLEGRO_TTF_NO_AUTOHINT - Disable the Auto Hinter which is enabled by default in newer versions of FreeType. Since: 5.0.6, 5.1.2