al_draw_tinted_bitmap(3)

✨ al_draw_tinted_bitmap ✨

okay bestie, welcome to the Allegro 5 API manual 💅 this one's a little function with big main character energy — it's literally al_draw_bitmap but with a whole tint situation going on. let's get into it 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

void al_draw_tinted_bitmap(ALLEGRO_BITMAP *bitmap, ALLEGRO_COLOR tint,
   float dx, float dy, int flags)

literally just one header and one call, no cap 🫶

---

💖 DESCRIPTION 💖

so it's like al_draw_bitmap(3) — same whole vibe — but it multiplies all the colors in the bitmap with the color you pass in as tint. it's giving color filter, it's giving mood lighting, it's iconic ✨

for example:

al_draw_tinted_bitmap(bitmap, al_map_rgba_f(0.5, 0.5, 0.5, 0.5), x, y, 0);

the above will draw the bitmap 50% transparently — and ngl, this part matters: the r/g/b values need to be pre-multiplied with the alpha component when you're using the default blend mode. so don't come for me if it looks weird, that's on the math 💀

and then:

al_draw_tinted_bitmap(bitmap, al_map_rgba_f(1, 0, 0, 1), x, y, 0);

the above will only draw the red component of the bitmap. red era only 🔥 periodt.

🫶 heads up bestie — see al_draw_bitmap(3) for a note on restrictions on which bitmaps can be drawn where. like, there are rules, and you gotta respect them 🙈

---

🦋 SEE ALSO 🦋

• al_draw_bitmap(3) — the un-tinted original, the blueprint, the mother 🎀

---

that's the whole page, bestie — go forth and tint responsibly 💅✨

from the Allegro reference manual, dated 2026-01-31 (source/version: Allegro reference manual) 🌸