SDL_ONAPPLICATIONDIDCHANGESTATUSBARORIENTATION(3)

💅 SDL_OnApplicationDidChangeStatusBarOrientation 💅

okay bestie, so this one lives in the SDL3 FUNCTIONS part of the manual — it's SDL_OnApplicationDidChangeStatusBarOrientation(3), which is a whole mouthful, iykyk. Let's get into it 🫶

---

✨ NAME ✨

SDL_OnApplicationDidChangeStatusBarOrientation — the lil hook that lets iOS apps with their own external event handling report onApplicationDidChangeStatusBarOrientation. that's it, that's the job 💖

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_system.h>

void SDL_OnApplicationDidChangeStatusBarOrientation(void);

no args, no return value, just a vibe check and a function call ✨

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — this function lets iOS apps that are already doing their own event handling hook into SDL so SDL can generate SDL events. it maps directly to an iOS-specific event, but here's the twist: since it doesn't actually do anything iOS-specific internally, it's available on all platforms, just in case it might be useful for some specific paradigm. slay, cross-platform king 👑

and like… most apps do not need to use this directly, okay? SDL's internal event code will handle all of this for windows created by SDL_CreateWindow! so if you're out here calling it manually for no reason, that's giving main character energy for a background extra 😭 let SDL cook.

---

🧵 THREAD SAFETY 🧵

it is safe to call this function from any thread. no cap. every thread is welcome at this party 💜

---

🌈 AVAILABILITY 🌈

this function has been available since SDL 3.2.0. so if you're on something older… bestie. upgrade. 🙈

---

⭐ quick reminder: this is a hook for external event handling, not a thing you sprinkle on top of your normal SDL app. if you're unsure, you're probably in the "don't need it" club, and that's totally fine 💅

---

and that's the whole page, no notes ✨ this lil icon came to you from the fine folks at Simple Directmedia Layer, version SDL 3.4.18 — mwah, take care of her 🎀💖🦋