SDL_SetRenderDrawColor(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_SetRenderDrawColor 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and we're diving straight into SDL_SetRenderDrawColor(3) — the girl whose whole job is picking the color your renderer draws with. she's iconic, she's simple, she's literally just a color setter. let's go 🎨✨

🌸 NAME 🌸

SDL_SetRenderDrawColor — Set the color used for drawing operations.

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_render.h>

bool SDL_SetRenderDrawColor(SDL_Renderer *renderer, Uint8 r, Uint8 g, Uint8 b, Uint8 a);

✨ DESCRIPTION ✨

so what does she actually do? she sets the color for drawing or filling rectangles, lines, and points — and also for SDL_RenderClear(). that's it. that's the vibe. one function, one job, ate 💅

think of it as telling your renderer "bestie, THIS is the color we're working with now" and everything you draw after that follows along. main character energy fr fr.

🎀 FUNCTION PARAMETERS 🎀

  • renderer — the rendering context. yep, the whole rendering situation you're working with 🖼️
  • r — the red value used to draw on the rendering target. 🔴
  • g — the green value used to draw on the rendering target. 🟢
  • b — the blue value used to draw on the rendering target. 🔵
  • a — the alpha value used to draw on the rendering target; usually SDL_ALPHA_OPAQUE (255). and heads up: use SDL_SetRenderDrawBlendMode to specify how the alpha channel is used. lowkey important, don't skip her 👀

🌈 RETURN VALUE 🌈

returns true on success or false on failure — and if it's giving failure, call SDL_GetError() for more information. she will tell you what went wrong, you just gotta ask 🫶

🧚 THREAD SAFETY 🧚

okay so this one matters: this function should only be called on the main thread. no cap. don't be out here calling her from a side thread and expecting peace 💀

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. if you're on anything older, she's not there yet bestie 😭

👑 SEE ALSO 👑

and that's the whole page, gorgeous 🌸 thank you for reading, mwah 💖

this has been Simple Directmedia Layer, SDL 3.4.18, page SDL_SetRenderDrawColor(3) — go set some colors and slay ✨🎀🦋

📦 where this page comes from