Ubuntu Manpages

SDL_SetTextureAlphaMod

Set an additional alpha value multiplied into render copy operations.

#include <SDL3/SDL_render.h>
bool SDL_SetTextureAlphaMod(SDL_Texture *texture, Uint8 alpha);

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.

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

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

This function should only be called on the main thread.

This function is available since SDL 3.2.0.

SDL_GetTextureAlphaMod(3), SDL_SetTextureAlphaModFloat(3), SDL_SetTextureColorMod(3)