devela::_dep::sdl3::sys::surface

Function SDL_BlitSurfaceTiledWithScale

pub unsafe extern "C" fn SDL_BlitSurfaceTiledWithScale(
    src: *mut SDL_Surface,
    srcrect: *const SDL_Rect,
    scale: f32,
    scaleMode: SDL_ScaleMode,
    dst: *mut SDL_Surface,
    dstrect: *const SDL_Rect,
) -> bool
Available on crate feature dep_sdl3 only.
Expand description

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

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

§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

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.2.0.

§See also