.\" 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_draw_text" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_draw_text - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_font.h>

void al_draw_text(const ALLEGRO_FONT *font,
   ALLEGRO_COLOR color, float x, float y, int flags,
   char const *text) 
\f[R]
.fi
.SH DESCRIPTION
.PP
Writes the NUL-terminated string \f[V]text\f[R] onto the target bitmap
at position \f[V]x\f[R], \f[V]y\f[R], using the specified
\f[V]font\f[R].
.PP
The \f[V]flags\f[R] parameter can be 0 or one of the following flags:
.IP \[bu] 2
ALLEGRO_ALIGN_LEFT - Draw the text left-aligned (same as 0).
.IP \[bu] 2
ALLEGRO_ALIGN_CENTRE - Draw the text centered around the given position.
.IP \[bu] 2
ALLEGRO_ALIGN_RIGHT - Draw the text right-aligned to the given position.
.PP
It can also be combined with this flag:
.IP \[bu] 2
ALLEGRO_ALIGN_INTEGER - Always draw text aligned to an integer pixel
position.
This was formerly the default behaviour.
Since: 5.0.8, 5.1.4
.PP
This function does not support newline characters (\f[V]\[rs]n\f[R]),
but you can use al_draw_multiline_text(3alleg5) for multi line text
output.
.SH SEE ALSO
.PP
al_draw_ustr(3alleg5), al_draw_textf(3alleg5),
al_draw_justified_text(3alleg5), al_draw_multiline_text(3alleg5).