#pragma section-numbers off
#pragma camelcase off

= SDL_SetRenderDrawColor =
Use this function to set the color used for drawing operations (Rect, Line and Clear).

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_SetRenderDrawColor(SDL_Renderer* renderer,
                           Uint8         r,
                           Uint8         g,
                           Uint8         b,
                           Uint8         a)
}}}

== Function Parameters ==
||'''renderer'''||the rendering context||
||'''r'''||the red value used to draw on the rendering target||
||'''g'''||the green value used to draw on the rendering target||
||'''b'''||the blue value used to draw on the rendering target||
||'''a'''||the alpha value used to draw on the rendering target; usually SDL_ALPHA_OPAQUE (255). Use [[SDL_SetRenderDrawBlendMode]] to specify how the alpha channel is used||

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

== Code Examples ==
{{{#!highlight cpp
SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
SDL_Rect rectangle;

rectangle.x = 0;
rectangle.y = 0;
rectangle.w = 50;
rectangle.h = 50;
SDL_RenderFillRect(renderer, &rectangle);
}}}

== Remarks ==
Use this function to set the color for drawing or filling rectangles, lines, and points, and for [[SDL_RenderClear]]().

== Related Functions ==
 .[[SDL_GetRenderDrawColor]]
 .[[SDL_RenderClear]]
 .[[SDL_RenderDrawLine]]
 .[[SDL_RenderDrawLines]]
 .[[SDL_RenderDrawPoint]]
 .[[SDL_RenderDrawPoints]]
 .[[SDL_RenderDrawRect]]
 .[[SDL_RenderDrawRects]]
 .[[SDL_RenderFillRect]]
 .[[SDL_RenderFillRects]]

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