Wiki Page Content

SDL_SetTextureBlendMode

Use this function to set the blend mode for a texture, used by SDL_RenderCopy().

Syntax

int SDL_SetTextureBlendMode(SDL_Texture*  texture,
                            SDL_BlendMode blendMode)

Function Parameters

texture

the 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 may be one of the following:

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.


CategoryAPI, CategoryRender

None: SDL_SetTextureBlendMode (last edited 2014-04-02 22:36:56 by mattbentley)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit