rotate_sprite(3alleg4)

💖 rotate_sprite 💖

okay so bestie, welcome to the Allegro manual — this one's rotate_sprite(3alleg4) and it is, genuinely, one of the most useful little functions in the whole game programming library. no cap. spin that sprite, queen. 🌀✨

✨ NAME ✨

rotate_sprite — rotates a sprite. it's part of the Allegro game programming library 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

void rotate_sprite(BITMAP *bmp, BITMAP *sprite, int x, int y, fixed
angle);

🦋 DESCRIPTION 🦋

okay so here's the vibe: this bad boy draws the sprite image onto the bitmap. that's the whole thing. but with flair.

it gets placed with its top left corner at the position you specify, and then it gets rotated by the angle you specify, spinning around its centre 🌈 — not its corner, its centre, that's important, don't come for me.

now. the angle. listen. the angle is a fixed point 16.16 number, and it's in the exact same format that the fixed point trig routines use. so:

• 256 = a full circle 🎡
• 64 = a right angle 📐
• and so on, you get it, it's just proportions of a circle, math girlie behavior

also, huge news: all rotation functions can draw between any two bitmaps. like, any. even screen bitmaps. even bitmaps of different color depth. the range is unreal. we love a flexible queen 💅

and one more thing — positive increments of the angle will make the sprite rotate clockwise on the screen. clockwise. which, as demonstrated by the Allegro example, is exactly what you'd expect and yet somehow everyone gets it wrong the first time. 😭

ngl bestie, just remember: bigger angle = clockwise. don't overthink it, the example file has your back. 🫶

💜 SEE ALSO 💜

go read these next, they're all part of the rotation/pivot cinematic universe:

• draw_sprite(3alleg4)
• rotate_scaled_sprite(3alleg4)
• rotate_sprite_v_flip(3alleg4)
• rotate_scaled_sprite_v_flip(3alleg4)
• pivot_sprite(3alleg4)
• pivot_sprite_v_flip(3alleg4)
• pivot_scaled_sprite(3alleg4)
• pivot_scaled_sprite_v_flip(3alleg4)
• itofix(3alleg4)
• exsprite(3alleg4)

and that's the whole page, bestie!! 🎀 this was Allegro, version 4.4.3, and the page is rotate_sprite(3alleg4). go forth and rotate, you absolute icon 👑💖✨