al_draw_rotated_bitmap(3alleg5)

✨ NAME ✨

al_draw_rotated_bitmap — like, the Allegro 5 API function that spins your bitmap around 💫 (this one lives in the Allegro 5 API, bestie, section 3 of the manual, iykyk)

---

🎀 SYNOPSIS 🎀

#include <allegro5/allegro.h>

void al_draw_rotated_bitmap(ALLEGRO_BITMAP *bitmap,
   float cx, float cy, float dx, float dy, float angle, int flags)

---

🦋 DESCRIPTION 🦋

okay so this one draws a rotated version of the bitmap you hand it, onto the target bitmap. The rotation is by angle radians, and it goes clockwise, no cap 🕐

Here's the tea: the point at cx/cy — measured relative to the upper left corner of the bitmap — is the point that gets drawn at dx/dy, and the whole bitmap rotates around it. So if cx,cy is 0,0, your bitmap spins around its upper left corner. That's it, that's the mechanic 💅

• cx — center x, and it's relative to the bitmap, not the screen
• cy — center y, same deal, relative to the bitmap
• dx — destination x, where the party actually lands
• dy — destination y, fr fr
• angle — the angle you're rotating by, in radians
• flags — literally the same as for al_draw_bitmap(3alleg5), nothing new here

🌸 Example 🌸

float w = al_get_bitmap_width(bitmap);
float h = al_get_bitmap_height(bitmap);
al_draw_rotated_bitmap(bitmap, w / 2, h / 2, x, y, ALLEGRO_PI / 2, 0);

So what that little cutie above is doing: it draws the bitmap centered on x/y and rotates it 90° clockwise. Iconic behaviour, honestly ✨

Heads up bestie — go read al_draw_bitmap(3alleg5) for a note on restrictions on which bitmaps can be drawn where. Don't skip it, it's giving important 🙈

---

👑 SEE ALSO 👑

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

---

and that's the whole page, bestie 💖 this was the Allegro reference manual dropping al_draw_rotated_bitmap(3alleg5) for you — go rotate something slay, ily, bye 🫶