SDL_HINT_AND...LOCK_ON_PAUSE(3)

💖 SDL_HINT_ANDROID_BLOCK_ON_PAUSE 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_HINT_ANDROID_BLOCK_ON_PAUSE 🫶

---

✨ NAME ✨

SDL_HINT_ANDROID_BLOCK_ON_PAUSE — a variable that controls whether the event loop is gonna block itself when the app gets paused 👀 lowkey important.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_ANDROID_BLOCK_ON_PAUSE "SDL_ANDROID_BLOCK_ON_PAUSE"

like yes, that's the include, that's the define, copy it exactly, no notes 💅

---

🎀 DESCRIPTION 🎀

so this variable can be set to the following values, and there are exactly two of them, we are not doing a third one:

• "0" — non blocking. the event loop just goes about its business, no waiting, no drama 🙈
• "1" — blocking. this is the default ✨

⚠️ bestie listen. this hint should be set before SDL is initialized. like, before. if you're setting it after, that's not it, that's giving too late 💀

---

🦋 AVAILABILITY 🦋

this hint has been available since SDL 3.2.0 — so if you're on anything older, sorry babe, it's not there 🌈

---

💜 SEE ALSO 💜

nothing else listed here, so it's just you and this hint, iconic duo energy 👑

---

mwah 💖 that's the whole page, you ate that. this came to you from the Simple Directmedia Layer girlies, running SDL 3.4.18 — go forth and set your hints early, periodt ✨🎀🦋