SDL_HINT_EMSCRIPTEN_ASYNCIFY(3)

💖 SDL_HINT_EMSCRIPTEN_ASYNCIFY 💖

okay bestie, so this is a page about SDL_HINT_EMSCRIPTEN_ASYNCIFY from the SDL3 functions manual, and it's genuinely such a niche little queen. she's about not handing control back to the browser automatically when you're running with asyncify. that's the whole personality. let's get into it 🫶

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_EMSCRIPTEN_ASYNCIFY "SDL_EMSCRIPTEN_ASYNCIFY"

---

🌸 DESCRIPTION 🌸

so here's the tea ☕ when you build with -s ASYNCIFY, SDL goes ahead and calls emscripten_sleep during stuff like refreshing the screen or polling events. that's the default behaviour, she's just doing her thing.

🚨 heads up: this hint only applies to the emscripten platform. if you're not on emscripten, she literally does not know you. no cap.

the variable can be set to these values, and honestly the vibes are simple:

• "0" — disable emscripten_sleep calls. you'd pick this if you're giving back browser control manually yourself, or if you're using asyncify for some other purpose entirely. main character energy, you handle it 💅
• "1" — enable emscripten_sleep calls. this is the default, so if you do nothing, this is what you get ✨

and the best part? this hint can be set anytime. no weird timing rules, no waiting for the right moment in the init order. she's flexible like that 😌

---

👑 AVAILABILITY 👑

this hint has been available since SDL 3.2.0. so if you're on anything older... yeah, she doesn't exist yet, sorry babe 😭

---

and that's the whole page, bestie!! go forth and toggle your asyncify behaviour with confidence 💜🦋

this was the SDL_HINT_EMSCRIPTEN_ASYNCIFY(3) page from the Simple Directmedia Layer manual, SDL 3.4.18 era 🎀 mwah, love u, see u in the next manpage 💖