SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual, section 3, and it's all about one lil hint macro that lives in the SDL3 universe. sit down, get comfy, we're gonna talk about telling SDL which controllers to ignore. yes, ignoring. we love a boundary-setting icon. 👑

✨ NAME ✨

SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES — a variable containing a list of devices to skip when scanning for game controllers. it's giving "not you, babe" energy and honestly? iconic. 🚫🎮

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES "SDL_GAMECONTROLLER_IGNORE_DEVICES"

like yes, you literally just include the header and the macro is right there, ready to be used. slay. 💅

✨ DESCRIPTION ✨

so here's the tea 🍓: the format of the string is a comma separated list of USB VID/PID pairs in hexadecimal form, like for real for real:

0xAAAA/0xBBBB,0xCCCC/0xDDDD

that's it. that's the whole vibe. VID slash PID, hex, commas between the pairs. no cap. ✨

and because SDL is a thoughtful queen 👑, the variable can also take the form of "@file", in which case the named file will be loaded and interpreted as the value of the variable. so instead of cramming your whole list into the hint string, you can just point at a file and let it cook. 🧚

lowkey important: this hint can be set anytime. no weird timing rules, no "only before init" nonsense. set it whenever, bestie. 🫶

✨ AVAILABILITY ✨

this hint is available since SDL 3.2.0. so if you're on anything older... babe, it's not there. upgrade time. 😭

and that's the whole page, fr fr. go forth and ignore devices with confidence. 💜

Simple Directmedia Layer — SDL 3.4.18 🌸 stay hydrated, read your man pages, and remember: setting boundaries is main character energy. mwah. 💖✨

📦 where this page comes from