devela::_dep::sdl3::sys::video

Function SDL_UpdateWindowSurfaceRects

pub unsafe extern "C" fn SDL_UpdateWindowSurfaceRects(
    window: *mut SDL_Window,
    rects: *const SDL_Rect,
    numrects: i32,
) -> bool
Available on crate feature dep_sdl3 only.
Expand description

Copy areas of the window surface to the screen.

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.

§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