Scroll to navigation

SDL_StretchSurface(3) SDL3 FUNCTIONS SDL_StretchSurface(3)

NAME

SDL_StretchSurface - Perform a stretched pixel copy from one surface to another.

HEADER FILE

Defined in SDL3/SDL_surface.h

SYNOPSIS

#include "SDL3/SDL.h"
bool SDL_StretchSurface(SDL_Surface *src, const SDL_Rect *srcrect, SDL_Surface *dst, const SDL_Rect *dstrect, SDL_ScaleMode scaleMode);

FUNCTION PARAMETERS

the SDL_Surface
structure to be copied from.
the SDL_Rect
structure representing the rectangle to be copied, may not be NULL.
the SDL_Surface
structure that is the blit target.
the SDL_Rect
structure representing the target rectangle in the destination surface, may not be NULL.
the SDL_ScaleMode
to be used.

RETURN VALUE

Returns true on success or false on failure; call

SDL_GetError () for more information.

THREAD SAFETY

The same destination surface should not be used from two threads at once. It is safe to use the same source surface from multiple threads.

AVAILABILITY

This function is available since SDL 3.4.0.

SEE ALSO

(3), SDL_BlitSurfaceScaled(3)

SDL 3.2.4 Simple Directmedia Layer