SDL_GETNATURALDISPLAYORIENTATION(3)

💅 NAME 💅

SDL_GetNaturalDisplayOrientation — bestie, this one tells you how a display is oriented when it's sitting there unrotated. Like, its natural, no-extra-vibes state. 🦋

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_video.h>

SDL_DisplayOrientation SDL_GetNaturalDisplayOrientation(SDL_DisplayID displayID);

---

🌸 FUNCTION PARAMETERS 🌸

• displayID — the instance ID of the display you wanna query. Yes, that display. The one you're curious about. 👀

---

🎀 RETURN VALUE 🎀

It hands you back the SDL_DisplayOrientation enum value of the display 💖 — or, if that info just isn't available, you get SDL_ORIENTATION_UNKNOWN instead. Not me getting ghosted by a display's orientation. 😭

---

🔥 THREAD SAFETY 🔥

Okay so, important: this function should only be called on the main thread. Periodt. Don't be out here calling it from some random thread, that's not the vibe. 🚫🧵

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. So if you're on something older, sorry bestie, she's not there yet. 💀

---

👑 SEE ALSO 👑

• SDL_GetDisplays(3) — go get the list of displays first, iykyk. 🫶

---

and that's the whole page, no cap! ✨ This lil' slice of documentation came to you from Simple Directmedia Layer, rocking SDL 3.4.18. Go forth and query those displays, you icon. 💅🎀🦋