SDL_SetTextureColorMod(3)

💖 SDL_SetTextureColorMod 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual — the whole thing lives in SDL_SetTextureColorMod(3) — and it's literally the cutest little function for tinting your textures. let's get into it 🎀

---

✨ NAME ✨

SDL_SetTextureColorMod — slap an extra color value on there that gets multiplied into render copy operations. it's giving tint, it's giving glow-up 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

bool SDL_SetTextureColorMod(SDL_Texture *texture, Uint8 r, Uint8 g, Uint8 b);

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓: when this texture gets rendered, during the copy operation each source color channel gets modulated by the matching color value. the formula is right here, no cap:

srcC = srcC * (color / 255)

and the reddest flag of them all 🚩: color modulation is not always supported by the renderer. if it's not supported, this function will return false. periodt.

---

👑 FUNCTION PARAMETERS 👑

• texture — the texture you're updating, bestie. the main character of this whole operation.
• r — the red color value that gets multiplied into copy operations.
• g — the green color value that gets multiplied into copy operations.
• b — the blue color value that gets multiplied into copy operations.

---

⭐ RETURN VALUE ⭐

returns true on success or false on failure 🫶 and if it fails, call SDL_GetError() for more info — she'll tell you what went wrong, iykyk.

---

🧚 THREAD SAFETY 🧚

lowkey important: this function should only be called on the main thread. no sneaky side-thread shenanigans 🙈

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. iconic behavior honestly.

---

💜 SEE ALSO 💜

• SDL_GetTextureColorMod(3)
• SDL_SetTextureAlphaMod(3)
• SDL_SetTextureColorModFloat(3)

---

okay that's the whole page, bestie!! stay hydrated, modulate responsibly, and remember — this was brought to you by Simple Directmedia Layer ✨ version SDL 3.4.18 ✨ the SDL_SetTextureColorMod(3) page itself. mwah, love u, bye 💖🎀🦋