SDL_HINT_JOY...ICES_EXCLUDED(3)

💅 SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED 💅

okay bestie so this one's a lil page from the SDL3 FUNCTIONS manual, and it's all about one very specific little hint. buckle up 🎀

---

✨ NAME ✨

SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED — a variable that's literally just a whole list of devices that we know don't have a GameCube form factor. like, they're not cube-shaped. we're excluding them. periodt. 🚫🎮

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED "SDL_JOYSTICK_GAMECUBE_DEVICES_EXCLUDED"

yeah that's the whole thing. a #include and a #define. slay. 💖

---

🦋 DESCRIPTION 🦋

so here's the tea: setting this hint overrides SDL_HINT_JOYSTICK_GAMECUBE_DEVICES and the built-in device list. like, it fully takes the wheel. 🎀

the format? it's a comma separated list of USB VID/PID pairs, all in hexadecimal form, like this:

0xAAAA/0xBBBB,0xCCCC/0xDDDD

and — plot twist — the variable can also be written as "@file", and in that case the file you named gets loaded and read as if it were the value of the variable. cute, right? 📁✨

you can set this hint anytime. no waiting around. no timing drama. iykyk. 💅

---

👑 AVAILABILITY 👑

this hint has been around since SDL 3.2.0. it's not new new, but it's not ancient either. it's giving established. 🌈

---

and that's the whole page, bestie!! every single detail, no notes, no cap. 🫶 this icon of a hint comes to you from Simple Directmedia Layer, version SDL 3.4.18 — go forth and exclude those non-GameCube devices, you absolute main character 💖✨🎀