.\" Automatically generated by Pandoc 3.4
.\"
.TH "al_draw_text" "3" "" "Allegro reference manual"
.SH NAME
al_draw_text \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro_font.h>\f[R]

void al_draw_text(const ALLEGRO_FONT *font,
   ALLEGRO_COLOR color, float x, float y, int flags,
   char const *text)
.EE
.SH DESCRIPTION
Writes the NUL\-terminated string \f[CR]text\f[R] onto the target bitmap
at position \f[CR]x\f[R], \f[CR]y\f[R], using the specified
\f[CR]font\f[R].
.PP
The \f[CR]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[CR]\[rs]n\f[R]),
but you can use al_draw_multiline_text(3) for multi line text output.
.SH SEE ALSO
al_draw_ustr(3), al_draw_textf(3), al_draw_justified_text(3),
al_draw_multiline_text(3).