SDL_GetTextureAlphaMod(3)

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

SDL_GetTextureAlphaMod 💅✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual 🎀 this one lives in SDL3 and it's lowkey a tiny little baddie — it's the getter that tells you what extra alpha is being multiplied into your render copy operations. yes. the additional alpha. the sneaky extra one. 🦋

✨ NAME ✨

SDL_GetTextureAlphaMod — get the additional alpha value multiplied into render copy operations 🫶

✨ SYNOPSIS ✨

#include <SDL3/SDL_render.h>

bool SDL_GetTextureAlphaMod(SDL_Texture *texture, Uint8 *alpha);

look at her. two args. so clean. so demure. 💜

✨ FUNCTION PARAMETERS ✨

  • texture — the texture you're querying, bestie. the one you wanna know about. 👑
  • alpha — a pointer that gets filled in with the current alpha value ✨. not the alpha you want, the alpha you have. she writes into it, so hand her somewhere to write. 🍓

✨ RETURN VALUE ✨

Returns true on success or false on failure 💖 — and if it's a false situation, call SDL_GetError() for more information, because she will NOT elaborate on her own. 😭

no cap, if you get false and just move on without checking SDL_GetError(), that's on you fr fr 💀

✨ THREAD SAFETY ✨

This function should only be called on the main thread. 🚨

main thread only. main character energy only. do not be passing this off to your little worker threads, she will not answer. 🙈

✨ AVAILABILITY ✨

This function is available since SDL 3.2.0. 🌱

so if you're on something older than that, she simply does not exist yet. rip. ⭐

✨ SEE ALSO ✨

the whole alpha mod friend group. go say hi. iykyk 💅

and that's the whole page, bestie!! you ate that 💖✨

this has been a page from the Simple Directmedia Layer manual, SDL 3.4.18 — mwah, go forth and modulate your alphas responsibly 🎀🦋💜

📦 where this page comes from