SDL_HINT_JOY...GROUND_EVENTS(3)

💖 SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS 💖

okay bestie, pull up a chair, because this is a page from the SDL3 FUNCTIONS manual and it's literally about keeping your joystick alive while your app is out here catching zero attention. yes, this is one of those SDL_HINT_JOY...GROUND_EVENTS pages, so let's get into it 🎀

---

✨ NAME ✨

SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS — a variable that lets you enable joystick (and gamecontroller) events even when your app is in the background. it's giving "don't ghost my controller" energy fr fr 💅

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS "SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS"

like, that's the whole thing. that #define is the string you'd use as the hint name, and yes you must copy it exactly, no cap 🫶

---

✨ DESCRIPTION ✨

so the way this works, bestie: this variable can be set to the following values 👑

• "0" — disable joystick & gamecontroller input events when the application is in the background. (this is the default, so if you don't touch anything, this is what you get)
• "1" — enable joystick & gamecontroller input events when the application is in the background. this is the main character setting 🌟

This hint can be set anytime. like, whenever. no waiting, no scheduling, no "come back at 3pm" nonsense — set it whenever you want and go 🦋

---

✨ AVAILABILITY ✨

This hint is available since SDL 3.2.0. so if you're on something older than that... girl, upgrade 😭

---

and that's the vibe check on this one!! this page came to you from Simple Directmedia Layer, shipping with SDL 3.4.18 💖 stay slay, keep your background events enabled (if you want), and remember: the default is "0", so don't come crying to me when your joystick goes quiet in the background ✨🎀👑