SDL_GetWindowAspectRatio(3)

💖 SDL_GetWindowAspectRatio(3) 💖

okay bestie, so this one lives in the SDL3 FUNCTIONS section of the SDL_GetWindowAspectRatio(3) manual page, and it's literally the "hey what's my window's aspect ratio" function 🦋

---

✨ NAME ✨

SDL_GetWindowAspectRatio — get the aspect ratio of a window's client area. that's it, that's the whole vibe 💅

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_video.h>

bool SDL_GetWindowAspectRatio(SDL_Window *window, float *min_aspect, float *max_aspect);

like yes she's a one-liner, she's serving compact 👑

---

✨ FUNCTION PARAMETERS ✨

• window — the window you wanna query the width and height from 🪟
• min_aspect — a pointer that gets filled in with the minimum aspect ratio of the window. may be NULL, no pressure, she's flexible 💜
• max_aspect — a pointer that gets filled in with the maximum aspect ratio of the window. also may be NULL, twin behaviour fr fr 🙈

---

✨ RETURN VALUE ✨

Returns true on success or false on failure 😭 — and if it's a fail, call SDL_GetError() for more information, she will tell you exactly what went wrong, no cap.

---

✨ THREAD SAFETY ✨

⚠️ bestie. listen. This function should only be called on the main thread. not the side threads, not the little background gremlins, the main one. periodt 💀

---

✨ AVAILABILITY ✨

This function is available since SDL 3.2.0 ✨ so if you're on anything older, she simply does not exist yet, sorry babe 🌸

---

✨ SEE ALSO ✨

• SDL_SetWindowAspectRatio(3) — the setter to this getter, they're a matched set, iconic duo 🫶

---

and that's the whole page, mwah 💋

Simple Directmedia Layer made this, it's SDL 3.4.18, and yeah, that's the version tag at the bottom of the page — go forth and query those ratios, you absolute main character 🌈⭐👑