SDL_RenderFillRects(3)

💖 SDL_RenderFillRects(3) 💖

okay so bestie, welcome to the SDL3 FUNCTIONS corner of the internet 🎀 pull up a chair, we're talking about SDL_RenderFillRects(3) and honestly? it's giving efficiency queen 👑

---

✨ NAME ✨

SDL_RenderFillRects — fill some number of rectangles on the current rendering target with the drawing color at subpixel precision 💅

like. MULTIPLE rects. ONE call. the way that she just does that 😭

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

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

that's it. that's the whole vibe. one line, infinite rectangles ✨

---

🦋 FUNCTION PARAMETERS 🦋

• renderer — the renderer which should fill multiple rectangles. yes bestie, THE renderer, the one you made, the main character of your whole rendering situation 👑
• rects — a pointer to an array of destination rectangles. an ARRAY. as in more than one. as in we're doing this in bulk, no cap 📦
• count — the number of rectangles. she needs to know how many. tell her how many. don't leave her guessing 🙈

---

⭐ RETURN VALUE ⭐

Returns true on success or false on failure — and if it's a false girlie, you gotta call SDL_GetError() for more information 🔍 lowkey mandatory, not optional, do it.

ngl if you get false and just move on with your life, the error message is still sitting there waiting for you. just check it. please. for me 🫶

---

🧚 THREAD SAFETY 🧚

This function should only be called on the main thread. MAIN THREAD ONLY. periodt 💀 do not be out here calling this from a worker thread and then acting surprised when the universe gets weird. she's monogamous, she's main-thread-only, respect the boundary 💖

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0 — so if you're on anything older, bestie, this one is not for you, and that's simply the tea ☕

---

👑 SEE ALSO 👑

• SDL_RenderFillRect(3) — the single-rect little sister 🎀 same energy, one rectangle, still iconic

---

💜 the sign-off 💜

this lil page came to you courtesy of the Simple Directmedia Layer girlies, straight out of SDL 3.4.18 🫶 go fill some rectangles, you're doing amazing, and remember: subpixel precision means she's precise AND she's got range 💅✨ bye bestie 💖