SDL_RenderRect(3)

💖 SDL_RenderRect 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_RenderRect(3) — she draws a rectangle on the current rendering target at subpixel precision. yes, subpixel. she's precise like that. 💅

---

✨ NAME ✨

SDL_RenderRect — draw a rectangle on the current rendering target at subpixel precision. that's it, that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

bool SDL_RenderRect(SDL_Renderer *renderer, const SDL_FRect *rect);

---

🦋 FUNCTION PARAMETERS 🦋

• renderer — the renderer that should draw a rectangle. like, the one doing the drawing. give her the job. 🫶
• rect — a pointer to the destination rectangle, or NULL to outline the entire rendering target. yes bestie, NULL is a valid move here — it means "the whole screen, go off". 🔥

---

⭐ RETURN VALUE ⭐

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

---

💜 THREAD SAFETY 💜

This function should only be called on the main thread. no side-quests, no other threads, just main character energy on the main thread. periodt. 👑

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on something older… girl. upgrade. 🙈

---

🍓 SEE ALSO 🍓

• SDL_RenderRects(3) — the plural one. the friend group. go check her out too. ✨

---

okay that's the whole page, you ate that 💖 this was SDL_RenderRect(3) from the Simple Directmedia Layer crew, documented for SDL 3.4.18 — mwah, go draw some rectangles bestie 🧚💅