(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_SetRenderDrawColor

Set the color used for drawing operations (Rect, Line and Clear).

Header File

Defined in SDL_render.h

Syntax

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.

Remarks

Set the color for drawing or filling rectangles, lines, and points, and for SDL_RenderClear().

Version

This function is available since SDL 2.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryRender