al_draw_bitmap(3)

💖 al_draw_bitmap (3) 💖

okay so real talk, this is a page from the Library Functions Manual, and it's literally the Allegro 5 API, bestie. here we go 🫶

---

✨ NAME

al_draw_bitmap — the Allegro 5 API function that just... puts your bitmap on screen. no drama, no scaling, no spinning. she's simple, she's iconic 👑

---

🦋 SYNOPSIS

#include <allegro5/allegro.h>

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

yeah that's the whole thing. bitmap goes in, some dx and dy floats, an int flags, and she slays ✨

---

🌸 DESCRIPTION

so this function draws an unscaled, unrotated bitmap — like, no resizing, no rotating, she's coming out exactly as she is, no cap — at the position you give her, and it goes onto the current target bitmap (that's the al_set_target_bitmap(3) one if you need to look it up 💅).

flags can be a combination of these babies:

• ALLEGRO_FLIP_HORIZONTAL — flips the bitmap about the y-axis, like a mirror selfie 🙈
• ALLEGRO_FLIP_VERTICAL — flips the bitmap about the x-axis, so she's upside down ✨

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 to another sub-bitmap of its parent) — none of that is currently supported, bestie, it's just not. If you need to copy part of a bitmap into the same bitmap, just use a temporary bitmap instead. lowkey the move 🧚

Note 💀: the backbuffer (or a sub-bitmap thereof) can not be transformed, blended or tinted. not a single one. if you need to draw the backbuffer, draw it to a temporary bitmap first with no active transformation (except translation) — otherwise your blending and tinting settings/parameters will just be ignored 😭. and this does not apply when you're drawing into a memory bitmap, so that's your little loophole 👑

---

🌈 SEE ALSO

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

like, the whole family. go say hi to the rest of the bitmaps 🦋

---

and that's the whole vibe check, bestie 💖 this was brought to you by the Allegro reference manual, starring al_draw_bitmap(3) herself — no cap, she ate 💅🎀