# SDL_StretchSurface Perform a stretched pixel copy from one surface to another. ## Header File Defined in [](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_surface.h) ## Syntax ```c bool SDL_StretchSurface(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode); ``` ## Function Parameters | | | | | ------------------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------- | | [SDL_Surface](SDL_Surface) * | **src** | the [SDL_Surface](SDL_Surface) structure to be copied from. | | const [SDL_Rect](SDL_Rect) * | **srcrect** | the [SDL_Rect](SDL_Rect) structure representing the rectangle to be copied, may not be NULL. | | [SDL_Surface](SDL_Surface) * | **dst** | the [SDL_Surface](SDL_Surface) structure that is the blit target. | | const [SDL_Rect](SDL_Rect) * | **dstrect** | the [SDL_Rect](SDL_Rect) structure representing the target rectangle in the destination surface, may not be NULL. | | [SDL_ScaleMode](SDL_ScaleMode) | **scaleMode** | the [SDL_ScaleMode](SDL_ScaleMode) to be used. | ## Return Value (bool) Returns true on success or false on failure; call [SDL_GetError](SDL_GetError)() for more information. ## Thread Safety Only one thread should be using the `src` and `dst` surfaces at any given time. ## Version This function is available since SDL 3.4.0. ## See Also - [SDL_BlitSurfaceScaled](SDL_BlitSurfaceScaled) ---- [CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategorySurface](CategorySurface)