Scroll to navigation

SDL_SetTextureAlphaModFloat(3) SDL3 FUNCTIONS SDL_SetTextureAlphaModFloat(3)

NAME

SDL_SetTextureAlphaModFloat - Set an additional alpha value multiplied into render copy operations.

HEADER FILE

Defined in SDL3/SDL_render.h

SYNOPSIS

#include "SDL3/SDL.h"
bool SDL_SetTextureAlphaModFloat(SDL_Texture *texture, float alpha);

DESCRIPTION

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 Alpha modulation is not always supported by the renderer; it will return false if alpha modulation is not supported.

FUNCTION PARAMETERS

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

RETURN VALUE

Returns true on success or false on failure; call

SDL_GetError () for more information.

THREAD SAFETY

You may only call this function from the main thread.

AVAILABILITY

This function is available since SDL 3.1.3.

SEE ALSO

(3), SDL_GetTextureAlphaModFloat(3), (3), SDL_SetTextureAlphaMod(3), (3), SDL_SetTextureColorModFloat(3)

SDL 3.1.6 Simple Directmedia Layer