====== (This is the documentation for SDL3, which is under heavy development and the API is changing! [https://wiki.libsdl.org/SDL2/ SDL2] is the current stable version!) ======
= SDL_SetSurfaceBlendMode =
Set the blend mode used for blit operations.
== Syntax ==
int SDL_SetSurfaceBlendMode(SDL_Surface *surface,
SDL_BlendMode blendMode);
== Function Parameters ==
{|
|'''surface'''
|the [[SDL_Surface]] structure to update
|-
|'''blendMode'''
|the [[SDL_BlendMode]] to use for blit blending
|}
== Return Value ==
Returns 0 on success or a negative error code on failure; call
[[SDL_GetError]]() for more information.
== Remarks ==
To copy a surface to another surface (or texture) without blending with the
existing data, the blendmode of the SOURCE surface should be set to
[[SDL_BLENDMODE_NONE]]
.
== Version ==
This function is available since SDL 3.0.0.
== Related Functions ==
:[[SDL_GetSurfaceBlendMode]]
----
[[CategoryAPI]], [[CategorySurface]]