SDL_HINT_JOY...DAPI_GAMECUBE(3)

✨ SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE ✨

okay bestie, sit down, we're doing a manual page from the SDL3 FUNCTIONS collection and honestly? this one is a lil cutie. it's a hint — a variable — that controls whether the HIDAPI driver for Nintendo GameCube controllers should be used. yes, the cube. the chonky purple one with the handle. we're talking about that. 💜

---

🌸 NAME 🌸

SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE — a variable controlling whether the HIDAPI driver for Nintendo GameCube controllers should be used. no cap, that's the whole gig. 🎮

---

✨ SYNOPSIS ✨

like, here's how you even get to it:

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_HIDAPI_GAMECUBE "SDL_JOYSTICK_HIDAPI_GAMECUBE"

see that? the macro name and the string are literally the same words. the string is what you'd actually pass around, and the #define is just handing you the string so you don't have to type it out and typo it. slay. 🫶

---

🦋 DESCRIPTION 🦋

so this variable can be set to these values, and there are exactly two of them, so no decision paralysis bestie:

• "0" — HIDAPI driver is not used.
• "1" — HIDAPI driver is used.

and the default? it's the value of SDL_HINT_JOYSTICK_HIDAPI. so if you never touch this one, it just inherits whatever the bigger, more general hint says. it's giving "i'm not making the call, my parent hint is" energy. 💅

⚠️ okay important: this hint should be set before initializing joysticks and gamepads. before. like, do it first. if you set it after, that's not it, chief. 😭

---

🌈 AVAILABILITY 🌈

this hint is available since SDL 3.2.0. so if you're on something older, she's not there yet. upgrade era. ⭐

---

💖 SEE ALSO 💖

there's no SEE ALSO section on this page, so like... that's it? nothing to cross-reference. the page said what it said and dipped. iconic honestly. 🎀

---

and that's the whole page, bestie. short, sweet, one (1) job, does it well. 🧚

💌 cute lil sign-off: this came to you from the Simple Directmedia Layer crew, at version SDL 3.4.18. mwah. 💋