SDL_StretchSurfaceRect(3) Perform a stretch blit between two surfaces of the same format.


#include <SDL_stretch.h>

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


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.