NAME

       SDL_StretchSurfaceRect - Perform a stretch blit between two surfaces of the same format.

SYNOPSIS

        #include <SDL_stretch.h>

       extern DECLSPEC int SDL_StretchSurfaceRect(SDL_Surface *src, SDL_Rect *srcrect,
                                                  SDL_Surface *dst, SDL_Rect *dstrect);

DESCRIPTION

       NOTE: The SDL_StretchSurfaceRect function is not safe to call from multiple threads!

       The SDL_StretchSurfaceRect function will stretch a srcrect smoothly to the full area of
       the dst surface. If no srcrect is given then the full area of the src surface is stretched
       smoothly to the full dst surface. The dstrect is ignored always.

       The SDL_StretchSurfaceRect function will also watch for a clip rectangle on the src
       surface. This may speed up handling in your programs by creating a larger src surface with
       an associated viewframe, and the srcrect argument needs not be recomputed.