SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


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


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.


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


This function is available since SDL 3.0.0.

Code Examples

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);

CategoryAPI, CategoryRender

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.