SDL_GetWindowSize(3)

💖 SDL_GetWindowSize(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we're gonna talk about SDL_GetWindowSize — she's the one who tells you how big your window's client area is. no cap. 🪟✨

---

✨ NAME ✨

SDL_GetWindowSize — get the size of a window's client area.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_video.h>

bool SDL_GetWindowSize(SDL_Window *window, int *w, int *h);

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie: the window pixel size may lowkey differ from its window coordinate size if the window is sitting on a high pixel density display. like, it's giving "same window, two different numbers" 😭.

if you want the real client area size in pixels, use SDL_GetWindowSizeInPixels() or SDL_GetRenderOutputSize(). those are the ones who actually know. 💅

---

🎀 FUNCTION PARAMETERS 🎀

• window — the window you wanna query the width and height from. 👑
• w — a pointer that gets filled in with the width of the window. she may be NULL, and that's fine, we don't judge. 🙈
• h — a pointer that gets filled in with the height of the window. also may be NULL. iconic behaviour honestly. 💜

---

⭐ RETURN VALUE ⭐

returns true on success or false on failure. if it fails, hit up SDL_GetError() for more info — she'll tell you what went wrong. 🔥

---

🧚 THREAD SAFETY 🧚

this function should only be called on the main thread. do not be out here calling her from a side 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_GetRenderOutputSize(3)
• SDL_GetWindowSizeInPixels(3)
• SDL_SetWindowSize(3)
• SDL_EVENT_WINDOW_RESIZED(3)

---

and that's the whole page, bestie!! 🫶 this was brought to you by Simple Directmedia Layer, version SDL 3.4.18 — go get those window dimensions, you absolute main character. slay. 💖✨🎀🦋