SDL_HINT_JOY...GAMEINPUT_RAW(3)

💖 SDL_HINT_JOY...GAMEINPUT_RAW(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, pls sit down, hydrate, and let me tell you about the cutest little hint macro you ever did see 🫶

---

✨ NAME ✨

SDL_HINT_JOYSTICK_GAMEINPUT_RAW — a variable that controls whether GameInput should be used for handling GIP devices that require raw report processing, but aren't supported by HIDRAW, such as Xbox One Guitars. 🎸

yes the header up top abbreviates it as SDL_HINT_JOY...GAMEINPUT_RAW because girl, that full name is long, but the real one is the full one. no cap.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_GAMEINPUT_RAW "SDL_JOYSTICK_GAMEINPUT_RAW"

like, that's it. that's the whole vibe. one #define, one string, and the string is literally the name again. iconic behavior honestly. 💅

---

🎀 DESCRIPTION 🎀

First thing, and this is important so listen up: this is only supported with GameInput 3 or newer. not 2, not 1, 3 or newer. periodt. ✨

So the variable can be set to the following values:

• "0" — GameInput is not used to handle raw GIP devices. nope, not today. 🙈
• "1" — GameInput is used. slay. 👑

And the default? The default is "1" when using GameInput 3 or newer, and is "0" otherwise. so if you're on the new hotness it's already on for you, and if you're not, it's off. lowkey fair.

⚠️ This hint should be set before SDL is initialized. fr fr, set it early or it won't do the thing. don't come crying to me later bestie 😭

---

🌈 AVAILABILITY 🌈

This hint is available since SDL 3.4.4. so if you're on something older, it's giving ✨nothing✨ and you gotta update. 🦋

---

that's the whole page, you understood it perfectly, I'm so proud of you. go forth and raw-report-process those Xbox One Guitars. 💜🎸

— written for Simple Directmedia Layer, version SDL 3.4.18, and yes, the page title is literally SDL_HINT_JOY...GAMEINPUT_RAW(3). byeeee 🫶✨