Wiki Page Content

Differences between revisions 11 and 12
Revision 11 as of 2011-01-03 19:53:58
Size: 1368
Editor: SheenaSmith
Comment: update content - w/ Sam
Revision 12 as of 2011-01-04 18:42:42
Size: 1369
Editor: SheenaSmith
Comment: minor change for consistency
Deletions are marked like this. Additions are marked like this.
Line 28: Line 28:
<<Anchor(blendMode)>> '''blendMode''' can be one of these values: <<Anchor(blendMode)>> '''blendMode''' may be one of the following:

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.

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