set_mouse_sprite(3alleg4)

💖 set_mouse_sprite 💖

okay bestie, gather round, because this is the set_mouse_sprite page from the Allegro manual — yes, the Allegro game programming library, version 4.4.3, we're being fancy today 👑

✨ NAME ✨

set_mouse_sprite — sets the mouse sprite. literally the whole job. it's giving "Allegro game programming library" energy 🦋

🌸 SYNOPSIS 🌸

#include <allegro.h>

void set_mouse_sprite(BITMAP *sprite);

that's it. one function, one pointer, no cap 🎀

💅 DESCRIPTION 💅

so. you don't like Allegro's mouse pointer? no problem, bestie. not even a little bit of a problem. use this function to supply an alternative of your own — your own cursor, your own vibe, your own main character moment. 🫶

and if you change the pointer and then you're like "wait. actually. I miss the arrow" — completely valid, we've all been there — just call:

set_mouse_sprite(NULL);

and Allegro's lovely arrow comes right back. iconic behaviour honestly ✨

and here's the bonus round, because Allegro is generous like that: set_mouse_sprite(NULL) uses the current palette when it picks colors for the arrow. so if your arrow mouse sprite is looking kinda ugly after you changed the palette, the move is just to call set_mouse_sprite(NULL). glow-up, immediately, no notes 💅

ngl the palette thing is the sleeper feature here. remember it. iykyk 😭

🦋 SEE ALSO 🦋

• install_mouse(3alleg4)
• show_mouse(3alleg4)
• set_mouse_sprite_focus(3alleg4)
• exmouse(3alleg4)

go read those too, they're all in the same friend group 🌸

okay that's the page!! this was set_mouse_sprite(3alleg4) from the Allegro manual, version 4.4.3, brought to you by the Allegro era of game programming. mwah, take care of your cursors, love u, bye 💖🎀🦋✨