SDL_SetTextureAlphaMod(3)

✨ SDL_SetTextureAlphaMod ✨

okay bestie, welcome to the SDL3 corner of the manual — this is the page for SDL_SetTextureAlphaMod(3) and it's giving transparency slay 💅

---

🌸 NAME 🌸

SDL_SetTextureAlphaMod</purpose> — set an extra alpha value that gets multiplied into render copy operations 🫶

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_render.h>

bool SDL_SetTextureAlphaMod(SDL_Texture *texture, Uint8 alpha);

like, that's the whole vibe. one texture, one alpha, one bool. iconic.

---

💖 DESCRIPTION 💖

so here's the tea ☕ — when this texture gets rendered, during the copy operation the source alpha value gets modulated by this alpha value, using this exact formula:

srcA = srcA * (alpha / 255)

so yeah, it's a multiplier. your texture's own alpha times this alpha over 255. math but make it ✨fashion✨

⚠️ real talk though: alpha modulation is not always supported by the renderer. if it's not supported, this function will return false. no cap.

---

🦋 FUNCTION PARAMETERS 🦋

• texture — the texture you're updating, bestie. the glow-up target 💖
• alpha — the source alpha value that gets multiplied into copy operations.

---

⭐ RETURN VALUE ⭐

returns true on success, or false on failure 😭 — and if it fails, go call SDL_GetError() for the deets, she'll tell you what went wrong.

---

🧚 THREAD SAFETY 🧚

🚨 main thread ONLY, bestie. this function should only be called on the main thread. do not be out here threading this. i'm serious. 💀

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0 👑 so if you're on something older... upgrade, babe.

---

💜 SEE ALSO 💜

• SDL_GetTextureAlphaMod(3)
• SDL_SetTextureAlphaModFloat(3)
• SDL_SetTextureColorMod(3)

go read those next, iykyk 🍓

---

and that's the page!! mwah 💋 this whole thing lives in Simple Directmedia Layer, SDL 3.4.18, dated SDL_SetTextureAlphaMod(3) — k bye, go modulate some alpha, you absolute main character 🫶✨🎀