SDL_GETRENDERLOGICALPRESENTATIONRECT(3)

💖 SDL_GetRenderLogicalPresentationRect(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_GetRenderLogicalPresentationRect 🎀 she's a lil getter function and she is literally serving exactly what her name says, no cap.

---

✨ NAME ✨

SDL_GetRenderLogicalPresentationRect — get the final presentation rectangle for rendering. 🦋

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_render.h>

bool SDL_GetRenderLogicalPresentationRect(SDL_Renderer *renderer, SDL_FRect *rect);

---

✨ DESCRIPTION ✨

so the way this works is iconic honestly: this function hands you back the calculated rectangle that's being used for logical presentation — and it figures that out based on the presentation mode and the output size. like, it does the math so you don't have to 💅

and if logical presentation is disabled? she still fills the rectangle for you — with the output size, in pixels. so you're never left hanging with an empty rect, periodt. 👑

one thing to remember tho: every single render target has its own logical presentation state. so this function? it gets the rectangle for the current render target. not all of them, not the one you're thinking about, the current one. iykyk 🫶

---

✨ FUNCTION PARAMETERS ✨

• renderer — the rendering context. the whole vibe. the main character of the operation. 💜
• rect — a pointer that gets filled in with the final presentation rectangle. and bestie, it may be NULL — no pressure, she's flexible like that. 🙈

---

✨ RETURN VALUE ✨

returns true on success, or false on failure — and if it's giving failure, go 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 thread only. fr fr. 💀

---

✨ AVAILABILITY ✨

this beauty has been available since SDL 3.2.0 ⭐ (yes she's new-ish, yes she's thriving 🌸)

---

✨ SEE ALSO ✨

• SDL_SetRenderLogicalPresentation(3) — the setter to her getter, they're a matched set, obsessed 🧚

---

okay that's the whole page bestie, you ate this one 🌈💖

this manual page came to you courtesy of Simple Directmedia Layer, rocking SDL 3.4.18, filed under SDL_GetRender...sentationRect(3) — mwah, slay, bye 👑✨