Wiki Page Content

Differences between revisions 5 and 6
Revision 5 as of 2010-01-21 18:51:55
Size: 1134
Editor: SheenaSmith
Comment: Update TextureID > Texture*
Revision 6 as of 2010-09-03 22:55:07
Size: 1101
Editor: SheenaSmith
Comment: update content - standard return value
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
Returns 0 on success or -1 if the texture is not valid or the blend mode is not supported; call [[SDL_GetError]]() for more information. Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.

SDL_SetTextureBlendMode

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

Syntax

int SDL_SetTextureBlendMode(SDL_Texture* texture,
                            int          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 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.


CategoryAPI, CategoryVideo

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

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