SDL_GetRenderScale(3)

✨ SDL_GetRenderScale ✨

okay bestie, welcome to the SDL_GetRenderScale(3) page from the SDL3 FUNCTIONS squad 💖 lowkey one of the cutest little getters in the whole render API. let's get into it.

---

🌸 NAME 🌸

SDL_GetRenderScale — get the drawing scale for the current target. that's it. that's the whole job. iconic behavior honestly 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_render.h>

bool SDL_GetRenderScale(SDL_Renderer *renderer, float *scaleX, float *scaleY);

look at her. three params. returns a bool. no drama, no cap 🫶

---

🦋 DESCRIPTION 🦋

okay so here's the tea: every single render target has its own scale. like, its own personal vibe. this function gets the scale for the current render target — nothing more, nothing less.

so whatever target you're currently drawing into? that's whose scale you're asking about. not some other target. the current one. periodt ✨

---

💜 FUNCTION PARAMETERS 💜

• renderer — the rendering context. your main character 🎬
• scaleX — a pointer that gets filled in with the horizontal scaling factor. left-to-right energy 🌈
• scaleY — a pointer that gets filled in with the vertical scaling factor. up-and-down energy ⭐

---

👑 RETURN VALUE 👑

returns true on success or false on failure — and if it fails, bestie, call SDL_GetError() for more information. she will tell you what went wrong, fr fr 😭

---

🔥 THREAD SAFETY 🔥

this function should only be called on the main thread. do not be cute about it. do not try to sneak it onto a worker thread. main thread only, no exceptions, that's the rule 🙈

---

🌟 AVAILABILITY 🌟

this function is available since SDL 3.2.0. she's not ancient, she's fresh 💅

---

🧚 SEE ALSO 🧚

• SDL_SetRenderScale(3) — the other half of the duo, the one who sets the scale. you'll wanna check her out too 🎀

---

and that's the page!! mwah 💖

cute lil sign-off: this is from Simple Directmedia Layer, the manual itself is at version SDL 3.4.18, and the page is SDL_GetRenderScale(3). go forth and scale responsibly, queen 👑✨