SDL_RenderLines(3)

💖 SDL_RenderLines 💖

okay bestie, gather round, because this one is a little iconic. this is SDL_RenderLines, a function from the SDL3 FUNCTIONS fam, and it does exactly what it says on the tin: it draws a whole series of connected lines onto the current rendering target, at subpixel precision. not pixel precision. SUBpixel. she's precise. she's delicate. she ate. ✨

---

🌸 NAME 🌸

SDL_RenderLines — draw a series of connected lines on the current rendering target at subpixel precision 🎀

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_render.h>

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

like. look at her. three little arguments and she's ready to go 💅

---

🍓 FUNCTION PARAMETERS 🍓

• renderer — the renderer that should draw multiple lines. she's the one holding the pen, fr fr.
• points — the points along the lines. this is your little trail of coordinates, and the lines get stitched through them 🧚
• count — the number of points, and lowkey here's the tea: you're drawing count-1 lines. so if you want N lines you gotta bring N+1 points. no cap, that's just how she works.

---

⭐ RETURN VALUE ⭐

returns true on success, or false on failure 😭 and if it fails you gotta call SDL_GetError() for more information — she'll tell you what went wrong, she's not mysterious like that.

---

👑 THREAD SAFETY 👑

main thread only, bestie. do NOT try to call this from a side thread. this function should only be called on the main thread. periodt.

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on something older, sorry babe, she's not there yet 🙈

---

💜 SEE ALSO 💜

• SDL_RenderLine(3) — the single-line sister, for when one line is all you need 🫶

---

and that's the whole page, gorgeous. this was brought to you by Simple Directmedia Layer, running version SDL 3.4.18 — mwah, take care of her, she's an icon 💖✨🎀