al_create_mouse_cursor(3)

✨ NAME ✨

Okay so this page lives in the Library Functions Manual and it's all about al_create_mouse_cursor(3) — the Allegro 5 API bestie for making mouse cursors. 💅

al_create_mouse_cursor — Allegro 5 API. That's the function, that's the vibe.

---

🌸 SYNOPSIS 🌸

              #include <allegro5/allegro.h>

              ALLEGRO_MOUSE_CURSOR *al_create_mouse_cursor(ALLEGRO_BITMAP *bmp,
                 int x_focus, int y_focus)

---

💅 DESCRIPTION 💅

You're literally making a mouse cursor from the bitmap you pass in, bestie. ✨

x_focus and y_focus describe the bit of the cursor that will represent the actual mouse position. That's the whole point — they tell Allegro which part of the cursor is the real mouse-y bit. 🎯

On success, you get a pointer to the cursor. Slay. 💖

🚨 Failure mode: you get NULL, not a cursor. No cap. 😭

On failure, it returns NULL. That's the entire mood.

---

🦋 SEE ALSO 🦋

• al_set_mouse_cursor(3)
• al_destroy_mouse_cursor(3)

---

💖 That's a wrap, bestie! This lil' page is from the Allegro reference manual and is filed under al_create_mouse_cursor(3) — the footer doesn't give a date, so no cap, no invented timestamp. 🎀