al_set_sys...use_cursor(3)

✨ NAME ✨

okay so this is al_set_system_mouse_cursor — Allegro 5 API, and it’s chillin’ in the Library Functions Manual under the shortened page title al_set_sys...use_cursor(3) (iykyk, the title got abbreviated). It’s the function for setting the system mouse cursor. 💅🖱️

🎀 SYNOPSIS 🎀

#include <allegro5/allegro.h>

bool al_set_system_mouse_cursor(ALLEGRO_DISPLAY *display,
   ALLEGRO_SYSTEM_MOUSE_CURSOR cursor_id)

🦋 DESCRIPTION 🦋

okay so you call this to set the given system mouse cursor as the current mouse cursor for the given display. If the cursor is currently shown (as opposed to hidden), the change is immediately visible — like, instant glow-up, no waiting. ✨

If the cursor doesn’t exist on the current platform, another cursor will be silently substituted. no cap, no error, just a sneaky little swap. 🙈

The cursors are:

• ALLEGRO_SYSTEM_MOUSE_CURSOR_DEFAULT
• ALLEGRO_SYSTEM_MOUSE_CURSOR_ARROW
• ALLEGRO_SYSTEM_MOUSE_CURSOR_BUSY
• ALLEGRO_SYSTEM_MOUSE_CURSOR_QUESTION
• ALLEGRO_SYSTEM_MOUSE_CURSOR_EDIT
• ALLEGRO_SYSTEM_MOUSE_CURSOR_MOVE
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_N
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_W
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_S
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_E
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_NW
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_SW
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_SE
• ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_NE
• ALLEGRO_SYSTEM_MOUSE_CURSOR_PROGRESS
• ALLEGRO_SYSTEM_MOUSE_CURSOR_PRECISION
• ALLEGRO_SYSTEM_MOUSE_CURSOR_LINK
• ALLEGRO_SYSTEM_MOUSE_CURSOR_ALT_SELECT
• ALLEGRO_SYSTEM_MOUSE_CURSOR_UNAVAILABLE

Returns true on success, false on failure. that’s the vibe check, bestie. ✅💀

🔥 SEE ALSO 🔥

• al_set_mouse_cursor(3)
• al_show_mouse_cursor(3)
• al_hide_mouse_cursor(3)

---

mwah 💖 xoxo from the Allegro reference manual, page al_set_sys...use_cursor(3) — the footer doesn’t print a date, so that’s the whole sign-off, bestie. 🫶