SDL_HINT_JOY...KLIST_DEVICES(3)

💖 SDL_HINT_JOYSTICK_BLACKLIST_DEVICES 💖

okay so bestie, this is a page from the SDL3 FUNCTIONS manual (yes, the SDL3 girlies stay winning ✨) and it's all about SDL_HINT_JOYSTICK_BLACKLIST_DEVICES. Sit down, hydrate, let's get into it 🫶

---

✨ NAME ✨

SDL_HINT_JOYSTICK_BLACKLIST_DEVICES — a variable holding a list of devices that should not be considered joysticks. it's giving "not you, bestie, you're not a controller" 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_BLACKLIST_DEVICES "SDL_JOYSTICK_BLACKLIST_DEVICES"

that's the whole vibe. one include, one define, iconic 🌈

---

🦋 DESCRIPTION 🦋

so the format of this string is a comma separated list of USB VID/PID pairs, written in hexadecimal form. like, literally:

0xAAAA/0xBBBB,0xCCCC/0xDDDD

see how they're all comma-separated and slash-split? that's the whole thing. each pair is a vendor ID and a product ID, hex-coded, and SDL goes "yeah nope, not a joystick" 🔥

and the plot twist: the variable can also take the form of "@file" — and in that case the named file gets loaded and interpreted as the value of the variable. so instead of cramming a giant list into one string, you point at a file and it eats that instead. main character energy, truly 📁✨

lowkey important: this hint can be set anytime. no waiting, no setup window, just go 🏃♀️💨

---

👑 AVAILABILITY 👑

this hint is available since SDL 3.2.0. so if you're on anything older, no cap, it's not there yet 💀

---

and that's the whole page, bestie — you ate this one fr fr 🎀

this little love letter to the SDL3 FUNCTIONS manual came to you courtesy of Simple Directmedia Layer, running version SDL 3.4.18. stay slay, keep reading manpages, mwah 💜🧚