SDL_SetTextureAlphaMod

Set an additional alpha value multiplied into render copy operations.

Header File

bool SDL_SetTextureAlphaMod(SDL_Texture *texture, Uint8 alpha);

SDL_Texture *	texture	the texture to update.
Uint8	alpha	the source alpha value multiplied into copy operations.

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

When this texture is rendered, during the copy operation the source alpha value is modulated by this alpha value according to the following formula:

srcA = srcA * (alpha / 255)

Alpha modulation is not always supported by the renderer; it will return false if alpha modulation is not supported.

You may only call this function from the main thread.

This function is available since SDL 3.1.3.