SDL_UpdateWindowSurfaceRects - Man Page
Copy areas of the window surface to the screen.
Header File
Defined in SDL3/SDL_video.h
Synopsis
#include "SDL3/SDL.h" bool SDL_UpdateWindowSurfaceRects(SDL_Window *window, const SDL_Rect *rects, int numrects);
Description
This is the function you use to reflect changes to portions of the surface on the screen.
This function is equivalent to the SDL 1.2 API
SDL_UpdateRects ().
Note that this function will update _at least_ the rectangles specified, but this is only intended as an optimization; in practice, this might update more of the screen (or all of the screen!), depending on what method SDL uses to send pixels to the system.
Function Parameters
- window
the window to update.
- rects
an array of SDL_Rect
structures representing areas of the surface to copy, in pixels.- numrects
the number of rectangles.
Return Value
Returns true on success or false on failure; call
SDL_GetError () for more information.
Thread Safety
This function should only be called on the main thread.
Availability
This function is available since SDL 3.2.0.
See Also
·(3), SDL_GetWindowSurface(3), ·(3), SDL_UpdateWindowSurface(3)
Referenced By
SDL_GetWindowSurface(3), SDL_UpdateWindowSurface(3).