SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR(3)

💖 SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR 🖱️✨

---

✨ NAME ✨

SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR — a variable that sets which system cursor you wanna use as the default cursor. like, THE cursor. the one that shows up when nothing else is happening. no cap 🎀

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_MOUSE_DEFAULT_SYSTEM_CURSOR "SDL_MOUSE_DEFAULT_SYSTEM_CURSOR"

---

✨ DESCRIPTION ✨

so here's the tea ☕ — this hint should be an integer that corresponds to the SDL_SystemCursor enum. that's it. that's the whole vibe. an integer. matching the enum. slay.

and the default value? it's zero, which is SDL_SYSTEM_CURSOR_DEFAULT. so if you never touch this hint at all, you're already living at zero and that's totally valid 💅

⚠️ okay but listen — this hint needs to be set before SDL_Init(). like, BEFORE. set it early or it does not count. periodt. 🙈

---

✨ AVAILABILITY ✨

this hint has been available since SDL 3.2.0 🦋 so if you're on anything older, bestie, it's not giving what you need it to give.

---

and that's the whole page!! you understood it, i'm so proud of you, mwah 🫶

this little writeup came to you straight from Simple Directmedia Layer, rocking SDL 3.4.18, and yeah that's the version and source, so go forth and set your cursor before init like the icon you are 👑✨ bye bestie!! 💖🌸