SDL_SetTextureBlendMode
Use this function to set the blend mode for a texture, used by SDL_RenderCopy().
Contents
Syntax
int SDL_SetTextureBlendMode(SDL_Texture* texture,
int blendMode)
Function Parameters
texture |
the SDL_Texture to update |
blendMode |
the SDL_BlendMode to use for texture blending; see Remarks for details |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
You can add your code example here
Remarks
blendMode can be one of these values:
SDL_BLENDMODE_NONE |
no blending |
|
dstRGBA = srcRGBA |
SDL_BLENDMODE_BLEND |
alpha blending |
|
dstRGB = (srcRGB * srcA) + (dstRGB * (1-srcA)) |
|
dstA = srcA + (dstA * (1-srcA)) |
SDL_BLENDMODE_ADD |
additive blending |
|
dstRGB = (srcRGB * srcA) + dstRGB |
|
dstA = dstA |
SDL_BLENDMODE_MOD |
color modulate |
|
dstRGB = srcRGB * dstRGB |
|
dstA = dstA |
If the blend mode is not supported, the closest supported mode is chosen and this function returns -1.
You can call SDL_GetRendererInfo() to fill in an SDL_RendererInfo structure with the information about the current renderer. This structure will have a mask of supported SDL_BlendMode values in the blend_modes member.
