SDL_GetRenderOutputSize(3)

✨ SDL_GetRenderOutputSize ✨

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today we're getting the output size in pixels of a rendering context 💅

---

🌸 NAME 🌸

SDL_GetRenderOutputSize — get the output size in pixels of a rendering context 🎀

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_render.h>

bool SDL_GetRenderOutputSize(SDL_Renderer *renderer, int *w, int *h);

---

💖 DESCRIPTION 💖

So like, this one returns the true output size in pixels — and the way it does that is by ignoring any render targets, and ignoring logical size and presentation too. It's giving "just the raw pixels, no filter, no edits" ✨

But wait — if you actually want the output size of the current rendering target, with all the logical size adjustments baked in, then you want SDL_GetCurrentRenderOutputSize() instead. Different function, different vibe, iykyk 🫶

---

🎀 FUNCTION PARAMETERS 🎀

• renderer — the rendering context 💜
• w — a pointer that gets filled in with the width in pixels.
• h — a pointer that gets filled in with the height in pixels.

---

🌈 RETURN VALUE 🌈

Returns true on success or false on failure — and if it's a fail, call SDL_GetError() for more info, she'll tell you what went wrong 😭

---

👑 THREAD SAFETY 👑

This function should only be called on the main thread. No side-quests, no background threads, main character energy only 🚫🧵

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0 💫

---

🦄 SEE ALSO 🦄

• SDL_GetCurrentRenderOutputSize(3)

---

Simple Directmedia Layer • SDL 3.4.18 • SDL_GetRenderOutputSize(3)

and that's the whole page bestie, slay 💅✨ go get those pixels 🍓🦋🎀