SDL_OnApplic...terBackground(3)

🎀 NAME 🎀

okay so bestie, this page is SDL_OnApplic...terBackground(3) from the SDL3 FUNCTIONS manual, and it's all about SDL_OnApplicationDidEnterBackground — the function that lets iOS apps with external event handling report onApplicationDidEnterBackground. 💖

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_system.h>

void SDL_OnApplicationDidEnterBackground(void);

---

💅 DESCRIPTION 💅

This function is literally the lil hook for iOS apps that already have their own event handling — it lets them hook into SDL so SDL events get generated. It maps directly to an iOS-specific event, but since it doesn't do anything iOS-specific internally, it's available on all platforms, in case it might be useful for some specific paradigm. 🌈

Most apps do not need to use this directly; SDL's internal event code will handle all this for windows created by SDL_CreateWindow! No cap, SDL has you covered there. 🫶

---

🧵 THREAD SAFETY 🧵

It is safe to call this function from any thread. Fr fr, any thread, go off. ✨

---

🗓️ AVAILABILITY 🗓️

This function is available since SDL 3.2.0. Iconic behavior, honestly. 👑

---

source: Simple Directmedia Layer · version: SDL 3.4.18 · page: SDL_OnApplic...terBackground(3) — that's the whole vibe, bestie, slay 💅✨