al_draw_rotated_bitmap(3)

💖 al_draw_rotated_bitmap 💖

okay so this little icon is straight out of the Allegro 5 API, living in the Library Functions Manual — and bestie, it's giving “rotate the bitmap, slay the canvas” energy ✨

---

🌸 NAME 🌸

al_draw_rotated_bitmap — Allegro 5 API 🎀

---

✨ 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 💅

So this one draws a rotated version of the given bitmap to the target bitmap. The bitmap is rotated by angle radians clockwise. Periodt. 🔥

The point at cx/cy relative to the upper left corner of the bitmap will be drawn at dx/dy, and the bitmap is rotated around this point. If cx,cy is 0,0, the bitmap will rotate around its upper left corner. No cap, that's the whole rotation vibe check 🌀

• cx — center x (relative to the bitmap) 🎯
• cy — center y (relative to the bitmap) 🎯
• dx — destination x 📍
• dy — destination y 📍
• angle — angle by which to rotate (radians) 🔄
• flags — same as for al_draw_bitmap(3) 🚩

---

🦋 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);

The above code draws the bitmap centered on x/y and rotates it 90° clockwise. Iconic behavior honestly 👑

Lowkey important: see al_draw_bitmap(3) for a note on restrictions on which bitmaps can be drawn where. Don't skip the fine print, bestie 💀

---

🌈 SEE ALSO 🌈

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

---

shoutout to the Allegro reference manual for the source/version line at the bottom — and the footer's date slot is literally blank, so no date to report, bestie 🫶💖