SDL Wiki
(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)


Copy areas of the window surface to the screen.

Header File

Defined in SDL_video.h


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

Function Parameters

SDL_Window * window the window to update.
const SDL_Rect * rects an array of SDL_Rect structures representing areas of the surface to copy, in pixels.
int numrects the number of rectangles.

Return Value

(int) Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.


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.


This function is available since SDL 2.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryVideo

[ 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.