Wiki Page Content

Differences between revisions 7 and 8
Revision 7 as of 2010-09-03 23:26:38
Size: 1366
Editor: SheenaSmith
Comment: update content (w/ Sam); remove 'draft' note
Revision 8 as of 2010-10-09 05:52:54
Size: 1370
Editor: SheenaSmith
Comment: update content - pointers, structs
Deletions are marked like this. Additions are marked like this.
Line 16: Line 16:
||'''texture'''||the texture to update|| ||'''texture'''||the SDL_Texture to update||

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 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.


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