al_draw_text man page

al_draw_text — Allegro 5 API


#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)


Writes the NUL-terminated string text onto the target bitmap at position x, y, using the specified font.

The flags parameter can be 0 or one of the following flags:

ALLEGRO_ALIGN_LEFT - Draw the text left-aligned (same as 0).
ALLEGRO_ALIGN_CENTRE - Draw the text centered around the given position.
ALLEGRO_ALIGN_RIGHT - Draw the text right-aligned to the given position.

It can also be combined with this flag:

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

This function does not support newline characters (\n), but you can use al_draw_multiline_text(3) for multi line text output.

See Also

al_draw_ustr(3), al_draw_textf(3), al_draw_justified_text(3), al_draw_multiline_text(3).

Referenced By

al_draw_justified_text(3), al_draw_multiline_text(3), al_draw_textf(3), al_draw_ustr(3), al_set_fallback_font(3).

Explore man page connections for al_draw_text(3).