.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_load_ttf_font" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_load_ttf_font - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_ttf.h>

ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)
\f[R]
.fi
.SH DESCRIPTION
.PP
Loads a TrueType font from a file using the FreeType library.
Quoting from the FreeType FAQ this means support for many different font
formats:
.PP
\f[I]TrueType, OpenType, Type1, CID, CFF, Windows FON/FNT, X11 PCF, and
others\f[R]
.PP
The \f[V]size\f[R] parameter determines the size the font will be
rendered at, specified in pixels.
The standard font size is measured in \f[I]units per EM\f[R], if you
instead want to specify the size as the total height of glyphs in
pixels, pass it as a negative value.
.RS
.PP
\f[I]Note:\f[R] If you want to display text at multiple sizes, load the
font multiple times with different size parameters.
.RE
.PP
The following flags are supported:
.IP \[bu] 2
ALLEGRO_TTF_NO_KERNING - Do not use any kerning even if the font file
supports it.
.IP \[bu] 2
ALLEGRO_TTF_MONOCHROME - Load as a monochrome font (which means no
anti-aliasing of the font is done).
.IP \[bu] 2
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
.SH SEE ALSO
.PP
al_init_ttf_addon(3alleg5), al_load_ttf_font_f(3alleg5)