====== (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_SetSurfaceColorMod =
Set an additional color value multiplied into blit operations.
== Syntax ==
int SDL_SetSurfaceColorMod(SDL_Surface *surface,
Uint8 r, Uint8 g, Uint8 b);
== Function Parameters ==
{|
|'''surface'''
|the [[SDL_Surface]] structure to update
|-
|'''r'''
|the red color value multiplied into blit operations
|-
|'''g'''
|the green color value multiplied into blit operations
|-
|'''b'''
|the blue color value multiplied into blit operations
|}
== Return Value ==
Returns 0 on success or a negative error code on failure; call
[[SDL_GetError]]() for more information.
== Remarks ==
When this surface is blitted, during the blit operation each source color
channel is modulated by the appropriate color value according to the
following formula:
srcC = srcC * (color / 255)
== Version ==
This function is available since SDL 3.0.0.
== Related Functions ==
:[[SDL_GetSurfaceColorMod]]
:[[SDL_SetSurfaceAlphaMod]]
----
[[CategoryAPI]], [[CategorySurface]]