enable_hardware_cursor(3alleg4)

💖 enable_hardware_cursor 💖

okay bestie, so this one lives in the Allegro manual — that's the Allegro game programming library, the 3alleg4 section, and it's literally just enable_hardware_cursor. ✨

🎀 NAME 🎀

enable_hardware_cursor — hands the mouse cursor over to your OS instead of letting Allegro do it, in the Allegro game programming library. 👑

🦋 SYNOPSIS 🦋

#include <allegro.h>

void enable_hardware_cursor(void);

✨ DESCRIPTION ✨

so the way this works: the second you call this function, Allegro stops drawing the mouse cursor itself and lets the operating system do it instead. main character handoff energy, fr fr. 💅

but ngl, not every graphics driver is gonna be down for that. it's not possible with all graphics drivers, so after you call show_mouse(), you gotta go check the gfx_capabilities flags to see if it actually worked. vibe check your capabilities, basically. 🙈

⚠️ and here's the part you cannot skip, bestie: on some platforms, enabling the hardware cursor makes get_mouse_mickeys() return only a limited range of values. so if you need your mouse mickeys, do NOT call this function. it's giving tradeoff. 😭

🌸 SEE ALSO 🌸

• install_mouse(3alleg4)
• show_mouse(3alleg4)
• set_mouse_sprite(3alleg4)
• get_mouse_mickeys(3alleg4)
• gfx_capabilities(3alleg4)
• disable_hardware_cursor(3alleg4)
• show_os_cursor(3alleg4)
• exsyscur(3alleg4)

Allegro version 4.4.3 💜 that's the source and the version right there, and this whole page is enable_hardware_cursor(3alleg4). slay, go enable that cursor responsibly, ily, bye 🫶🌸