opensolaris man page for sdl_updaterects

SDL_UpdateRects(3)						 SDL API Reference						SDL_UpdateRects(3)

NAME
       SDL_UpdateRects - Makes sure the given list of rectangles is updated on the given screen.

SYNOPSIS
       #include "SDL.h"

       void SDL_UpdateRects(SDL_Surface *screen, int numrects, SDL_Rect *rects);

DESCRIPTION
       Makes  sure  the  given list of rectangles is updated on the given screen. The rectangles must all be confined within the screen boundaries
       (no clipping is done).

       This function should not be called while screen is locked.

	      Note:

	      It is adviced to call this function only once per frame, since each call has some processing overhead. This is no restriction  since
	      you can pass any number of rectangles each time.

	      The  rectangles are not automatically merged or checked for overlap. In general, the programmer can use his knowledge about his par-
	      ticular rectangles to merge them in an efficient way, to avoid overdraw.

SEE ALSO
       SDL_UpdateRect, SDL_Rect, SDL_Surface, SDL_LockSurface

SDL
							      Tue 11 Sep 2001, 23:01						SDL_UpdateRects(3)