SDL_RenderPoints(3)

💖 SDL_RenderPoints 💖

okay bestie, so this one lives in the SDL3 FUNCTIONS fam and it's literally called SDL_RenderPoints — yes, plural, because we're drawing a whole bunch of points, not just one 🫶

---

✨ NAME ✨

SDL_RenderPoints — Draw multiple points on the current rendering target at subpixel precision.

no cap, "subpixel precision" is the moment here, we love a renderer that doesn't snap to whole pixels 🌸

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_render.h>

bool SDL_RenderPoints(SDL_Renderer *renderer, const SDL_FPoint *points, int count);

look at that signature. iconic. 💅

---

🦋 FUNCTION PARAMETERS 🦋

• renderer — the renderer which should draw multiple points. this is the one doing the actual slaying.
• points — the points to draw. yes girl, all of them.
• count — the number of points to draw. the way that this tells the function how many of points to actually care about… obsessed.

---

⭐ RETURN VALUE ⭐

Returns true on success or false on failure 🥲 and if it's giving failure, call SDL_GetError() for more information. she'll tell you what went wrong, fr fr.

---

🌈 THREAD SAFETY 🌈

This function should only be called on the main thread. no side-quest threads for this one, bestie. main character energy only 👑

---

💜 AVAILABILITY 💜

This function is available since SDL 3.2.0. so if you're on something older… it's not there, and that's on that 💀

---

🔥 SEE ALSO 🔥

• SDL_RenderPoint(3) — the singular version, for when you just need one point and not the whole friend group ✨

---

Simple Directmedia Layer wrote this one, and it's coming at you from SDL 3.4.18 🎀 tysm for reading bestie, go draw some points, ily, mwah 💖🧚🌸