#pragma section-numbers off
#pragma disable-camelcase

= SDL_SetTextureColorMod =
Use this function to set an additional color value multiplied into render copy operations.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_SetTextureColorMod(SDL_Texture* texture,
                           Uint8        r,
                           Uint8        g,
                           Uint8        b)
}}}

== Function Parameters ==
||'''texture'''||the texture to update||
||'''r'''||the red color value multiplied into copy operations||
||'''g'''||the green color value multiplied into copy operations||
||'''b'''||the blue color value multiplied into copy operations||

== Return Value ==
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.

== Code Examples ==
{{{#!highlight cpp
...
SDL_Texture* pTexture = SDL_CreateTextureFromSurface( renderer, loadedSurface );
SDL_SetTextureColorMod( pTexture, 64, 64, 64 );
...
}}}

== Remarks ==
When this texture is rendered, during the copy operation each source color channel is modulated by the appropriate color value according to the following formula:
 `srcC = srcC * (color / 255)`

Color modulation is not always supported by the renderer; it will return -1 if color modulation is not supported.

== Related Functions ==
 .[[SDL_GetTextureColorMod]]
 .[[SDL_SetTextureAlphaMod]]

----
[[CategoryAPI]], [[CategoryRender]]