NAME¶

SDL_SetTextureBlendMode - Set the blend mode for a texture, used by SDL_RenderTexture().

SYNOPSIS¶

#include <SDL3/SDL_render.h>

bool SDL_SetTextureBlendMode(SDL_Texture *texture, SDL_BlendMode blendMode);

DESCRIPTION¶

This blend mode is used for any drawing that involves this texture.

If the blend mode is not supported, the closest supported mode is chosen and this function returns false.

FUNCTION PARAMETERS¶

texture

the texture to update.

blendMode

the SDL_BlendMode to use for texture blending.

RETURN VALUE¶

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

THREAD SAFETY¶

This function should only be called on the main thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_GetTextureBlendMode(3), SDL_SetRenderDrawBlendMode(3)