|
Size: 1564
Comment: update content - 2/16 changeset 5318 (as of 5147)
|
Size: 1615
Comment: Added renderer instance to example code
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 38: | Line 38: |
| SDL_CreateRenderer(window, -1, 0); | SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, 0); |
| Line 41: | Line 41: |
| SDL_SetRenderDrawColor(255, 0, 0, 0); | SDL_SetRenderDrawColor(renderer, 255, 0, 0, 0); |
| Line 44: | Line 44: |
| SDL_RenderClear(); | SDL_RenderClear(renderer); |
| Line 48: | Line 48: |
| SDL_RenderPresent(); | SDL_RenderPresent(renderer); |
SDL_RenderClear
Use this function to clear the current rendering target with the drawing color.
Contents
Syntax
int SDL_RenderClear(SDL_Renderer* renderer)
Function Parameters
renderer |
the rendering context |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
#include <SDL/SDL.h>
int main(int argc, char** argv)
{
// Initialize SDL.
if (SDL_Init(SDL_INIT_VIDEO) < 0)
return 1;
// Create the window were we will draw.
SDL_Window* window =
SDL_CreateWindow("SDL_RenderClear",
SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
512, 512,
SDL_WINDOW_SHOWN);
// We must call SDL_CreateRenderer in order for draw calls to affect this window.
SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, 0);
// Select the color for drawing. It is set to red here.
SDL_SetRenderDrawColor(renderer, 255, 0, 0, 0);
// 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.
SDL_Delay(5000);
// Always be sure to clean up
SDL_Quit();
return 0;
}
Remarks
You can add useful comments here
