al_draw_bitmap(3alleg5)

💖 al_draw_bitmap — the Allegro 5 API glow-up 💖

okay bestie, gather round, because we're talking about al_draw_bitmap from the Allegro 5 API and honestly? it's giving foundational. it's giving main character. let's get into it. 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_draw_bitmap(ALLEGRO_BITMAP *bitmap, float dx, float dy, int flags)

---

🌸 DESCRIPTION 🌸

So what does it do? It draws your bitmap — unscaled and unrotated, no notes — at the position you give it, straight onto the current target bitmap (peep al_set_target_bitmap(3alleg5) if you need the tea on that one). ✨

now the flags situation. flags can be a combination of these two icons:

• ALLEGRO_FLIP_HORIZONTAL — flips the bitmap about the y-axis 🪞
• ALLEGRO_FLIP_VERTICAL — flips the bitmap about the x-axis 🔄

💀 Note: the current target bitmap must be a different bitmap. Drawing a bitmap to itself (or to a sub-bitmap of itself), or drawing a sub-bitmap to its parent (or another sub-bitmap of its parent), is not currently supported. like, at all. not me trying to do the impossible 🙈. If you genuinely need to copy part of a bitmap into that same bitmap, just use a temporary bitmap instead. periodt.

🫶 Note: the backbuffer (or a sub-bitmap of it) can not be transformed, blended, or tinted. so if you need to draw the backbuffer, draw it to a temporary bitmap first, with no active transformation — except translation, that one's fine. any blending and tinting settings/parameters will just be ignored. 🙈 This does not apply when you're drawing into a memory bitmap though, so breathe. 💜

---

👑 SEE ALSO 👑

• al_draw_bitmap_region(3alleg5)
• al_draw_scaled_bitmap(3alleg5)
• al_draw_rotated_bitmap(3alleg5)
• al_draw_scaled_rotated_bitmap(3alleg5)

---

and that's the whole vibe, bestie 💅 this was the Allegro reference manual, al_draw_bitmap(3alleg5). go forth and draw, you absolute icon 🌈⭐