SDL_RENDERCOORDINATESTOWINDOW(3)

💖 SDL_RenderCoordinatesToWindow(3) 💖

okay bestie, listen up — this one lives in the SDL3 FUNCTIONS section of the manual, and it's literally the glow-up translator between render coordinates and window coordinates. ✨

---

🌸 NAME 🌸

SDL_RenderCoordinatesToWindow — get a point in window coordinates when you're handed a point in render coordinates.

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_render.h>

bool SDL_RenderCoordinatesToWindow(SDL_Renderer *renderer, float x, float y, float *window_x, float *window_y);

---

🦋 DESCRIPTION 🦋

so here's the vibe: you give it a point that's chillin' in render coordinates, and it hands you back that same point but translated into window coordinates. it's giving personal translator fr fr. 💅

and the way it does that? it takes a whole bunch of states into account, no cap:

• the window dimensions. 👑
• the logical presentation settings (SDL_SetRenderLogicalPresentation)
• the scale (SDL_SetRenderScale)
• the viewport (SDL_SetRenderViewport)

all four of those are lowkey in the mix, so don't be surprised when your point comes out somewhere else entirely. 🌈

---

🍓 FUNCTION PARAMETERS 🍓

• renderer — the rendering context. your main character. 🫶
• x — the x coordinate in render coordinates. 💜
• y — the y coordinate in render coordinates. 💜
• window_x — a pointer that gets filled with the x coordinate in window coordinates. 📍
• window_y — a pointer that gets filled with the y coordinate in window coordinates. 📍

---

✨ RETURN VALUE ✨

returns true on success, or false on failure. 😭 and if it's a fail, bestie, call SDL_GetError() for more information. that's your receipts, always go get them.

---

🔥 THREAD SAFETY 🔥

⚠️ this function should only be called on the main thread. no side-quests, no background threads, no exceptions. main thread only, periodt. 💀

---

🌟 AVAILABILITY 🌟

this function is available since SDL 3.2.0. so if you're on something older… yeah, that's a no from her. 🙈

---

🌈 SEE ALSO 🌈

• SDL_SetRenderLogicalPresentation(3)
• SDL_SetRenderScale(3)
• SDL_SetRenderViewport(3)

---

and that's the whole page, bestie, you ate that. 🧚 this one's brought to you by Simple Directmedia Layer, rockin' SDL 3.4.18 — mwah, take care of her, she's iconic. 👑💖