|
Size: 1372
Comment: update content - changeset 4929 BlendMode
|
Size: 1392
Comment: update formatting - enums, structs, the/an
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 16: | Line 16: |
| ||'''texture'''||the SDL_Texture to update|| ||'''blendMode'''||the [[SDL_BlendMode]] to use for texture blending; see [[#blendMode|Remarks]] for details|| |
||'''texture'''||the texture to update|| ||'''blendMode'''||the [[SDL_BlendMode]] ,,enumeration,, ^value^ to use for texture blending; see [[#blendMode|Remarks]] for details|| |
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,
SDL_BlendMode blendMode)
Function Parameters
texture |
the texture to update |
blendMode |
the SDL_BlendMode enumeration value 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.
