SDL_GetTextureColorMod(3)

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

💖 SDL_GetTextureColorMod(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_GetTextureColorMod — yes that's the whole name, we're not abbreviating, she earned it 👑

✨ NAME ✨

SDL_GetTextureColorMod — get the additional color value multiplied into render copy operations.

like, the little color tint that gets multiplied into every render copy. that's the one. 🎀

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

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

copy that include exactly, no cap. 📋

🦋 FUNCTION PARAMETERS 🦋

  • texture — the texture we're querying. the one we're interrogating. the subject of the vibe check 💅
  • r — a pointer that gets filled in with the current red color value.
  • g — a pointer that gets filled in with the current green color value.
  • b — a pointer that gets filled in with the current blue color value.

three pointers, three colors, three little values handed back to you. it's giving RGB bestie era 🌈

⭐ RETURN VALUE ⭐

Returns true on success or false on failure. and if it fails? call SDL_GetError() for more information, she will tell you everything 🗣️

fr fr, always check the return value. false is not a vibe, it's a warning.

💀 THREAD SAFETY 💀

This function should only be called on the main thread.

main thread only!! do NOT go spawning threads and calling this from them, that's not the moment, that's not the energy 🙈

🎀 AVAILABILITY 🎀

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

👑 SEE ALSO 👑

go read those too, they're all part of the same friend group 🫶

and that's the whole page!! tysm for reading, ily, go tint something pretty ✨💜

Simple Directmedia Layer — SDL 3.4.18 — SDL_GetTextureColorMod(3) 🦋 that's the source, the version and the date all wrapped up in a little bow, mwah 💅

📦 where this page comes from