SDL_BlitSurfaceTiledWithScale3
Perform a scaled and tiled blit to a destination surface, which may be of a different format.
Usage
#include "SDL3/SDL.h"
bool SDL_BlitSurfaceTiledWithScale(SDL_Surface *src, const SDL_Rect *srcrect, float scale, SDL_ScaleMode scaleMode, SDL_Surface *dst, const SDL_Rect *dstrect);
Header file
Defined in SDL3/SDL_surface.h
Overview
The pixels in srcrect will be scaled and repeated as many times as needed to completely fill dstrect .
Function parameters
- src
-
the
SDL_Surface
structure to be copied from.
- srcrect
-
the
SDL_Rect
structure representing the rectangle to be copied, or NULL to copy the entire surface.
- 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.
- scaleMode
-
scale algorithm to be used.
- dst
-
the
SDL_Surface
structure that is the blit target.
- dstrect
-
the
SDL_Rect
structure representing the target rectangle in the destination surface, or NULL to fill the entire surface.
Return value
Returns true on success or false on failure; call
SDL_GetError () for more information.
Thread safety
Only one thread should be using the src and dst surfaces at any given time.