Clear the current rendering target with the drawing color.
int SDL_RenderClear(SDL_Renderer *renderer);
renderer | the rendering context |
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
This function clears the entire rendering target, ignoring the viewport and the clip rectangle.
This function is available since SDL 3.0.0.
#include "SDL.h"
int main(int argc, char* argv[])
{
SDL_Window* window;
SDL_Renderer* renderer;
/* Initialize SDL. */
if (SDL_Init(SDL_INIT_VIDEO) < 0)
return 1;
/* Create the window where we will draw. */
"SDL_RenderClear",
window = SDL_CreateWindow(
SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,512, 512,
0);
/* We must call SDL_CreateRenderer in order for draw calls to affect this window. */
0);
renderer = SDL_CreateRenderer(window, NULL,
/* Select the color for drawing. It is set to red here. */
255, 0, 0, 255);
SDL_SetRenderDrawColor(renderer,
/* Clear the entire screen to our selected color. */
SDL_RenderClear(renderer);
/* Up until now everything was drawn behind the scenes.
This will show the new, red contents of the window. */
SDL_RenderPresent(renderer);
/* Give us time to see the window. */
5000);
SDL_Delay(
/* Always be sure to clean up */
SDL_Quit();return 0;
}