SDL_UpdateWindowSurfaceRects - Man Page

#include <SDL3/SDL_video.h>

bool SDL_UpdateWindowSurfaceRects(SDL_Window *window, const SDL_Rect *rects, int numrects);

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.

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.

Returns true on success or false on failure; call SDL_GetError() for more information.

This function should only be called on the main thread.

This function is available since SDL 3.2.0.

SDL_GetWindowSurface(3), SDL_UpdateWindowSurface(3)

SDL_GetWindowSurface(3), SDL_UpdateWindowSurface(3).