SDL_RenderRects(3)

✨ SDL_RenderRects(3) ✨

okay bestie, welcome to the SDL3 FUNCTIONS page for SDL_RenderRects 💖 this is the one in <SDL3/SDL_render.h>, and she is that girl.

---

🎀 NAME 🎀

SDL_RenderRects — draw some number of rectangles on the current rendering target, at subpixel precision 👑

like. not one rectangle. some number of them. a whole lil squad. and they're subpixel-precise so they land exactly where you meant, no cap.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

bool SDL_RenderRects(SDL_Renderer *renderer, const SDL_FRect *rects, int count);

look at her. three args. zero drama. 💅

---

🦋 FUNCTION PARAMETERS 🦋

• renderer — the renderer which should draw multiple rectangles. this is your main character, the one doing the actual drawing 🫶
• rects — a pointer to an array of destination rectangles. yes bestie, an array, that's the whole point of the "Rects" part 🌈
• count — the number of rectangles. how many of them from that array are getting drawn. tell her the number or she's just guessing fr fr

---

💜 RETURN VALUE 💜

Returns true on success or false on failure 😭

and if it fails? call SDL_GetError() for more information — she will tell you exactly what went wrong, go ask her, don't just sit there spiraling 🙈

---

🧚 THREAD SAFETY 🧚

This function should only be called on the main thread. 🚨

main thread only, periodt. don't be out here calling her from some random thread, that's not the vibe check you want to fail 💀

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0 ✨ so if you're on something older, that's why she's not picking up the phone.

---

👑 SEE ALSO 👑

• SDL_RenderRect(3) — the singular sister. one rectangle instead of many, iykyk 🍓

---

kisses, and go draw some rectangles bestie, you got this 💖✨🎀🦋🌸💅🫶

this page is brought to you by the fine folks at Simple Directmedia Layer, living in SDL 3.4.18 — and she is iconic, no notes 🌈⭐🔥💜