al_draw_text(3alleg5)

💖 NAME 💖

al_draw_text — the Allegro 5 API's own little text-slapping bestie ✨

(It lives in the Allegro 5 manual, section 3alleg5, and honestly? She's iconic.)

---

✨ SYNOPSIS ✨

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

---

🎀 DESCRIPTION 🎀

Okay so basically, al_draw_text takes your text — which is a NUL-terminated string, no cap — and writes it onto the target bitmap at position x, y, using the font you picked. That's it. That's the whole vibe. 🦋

The flags parameter can be 0, or one of these three:

• ALLEGRO_ALIGN_LEFT — draws the text left-aligned. Lowkey the same thing as 0, bestie. They're literally twins. 👯
• ALLEGRO_ALIGN_CENTRE — draws the text centered around the given position. Not starting at it, around it. Very main character energy. 👑
• ALLEGRO_ALIGN_RIGHT — draws the text right-aligned to the given position.

And you can also combine that with this one:

• ALLEGRO_ALIGN_INTEGER — always draws text aligned to an integer pixel position. This used to be the default behaviour btw, so if you're porting old code and things look slightly off, that's why 🙈. Since: 5.0.8, 5.1.4.

💀 Real talk though: this function does NOT support newline characters (\n). Not even a little. If you want multi-line text output you gotta go use al_draw_multiline_text(3alleg5) instead, fr fr.

---

🌸 SEE ALSO 🌸

• al_draw_ustr(3alleg5)
• al_draw_textf(3alleg5)
• al_draw_justified_text(3alleg5)
• al_draw_multiline_text(3alleg5)

---

And that's the whole page, bestie 🫶 — this one came straight out of the Allegro reference manual, filed under al_draw_text(3alleg5). Go forth and draw some text. Slay. 💅✨