(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_BlitSurfaceTiledWithScale

Perform a scaled and tiled blit to a destination surface, which may be of a different format.

Header File

Syntax

bool SDL_BlitSurfaceTiledWithScale(SDL_Surface *src, const SDL_Rect *srcrect, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);

Function Parameters

SDL_Surface *	src	the SDL_Surface structure to be copied from.
const SDL_Rect *	srcrect	the SDL_Rect structure representing the rectangle to be copied, or NULL to copy the entire surface.
float	scale	the scale used to transform srcrect into the destination rectangle, e.g. a 32x32 texture with a scale of 2 would fill 64x64 tiles.
SDL_ScaleMode	scaleMode	scale algorithm to be used.
SDL_Surface *	dst	the SDL_Surface structure that is the blit target.
const SDL_Rect *	dstrect	the SDL_Rect structure representing the target rectangle in the destination surface, or NULL to fill the entire surface.

Return Value

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

Remarks

The pixels in srcrect will be scaled and repeated as many times as needed to completely fill dstrect.

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.

Version

This function is available since SDL 3.1.3.