SDL_BlitSurface9Grid - Perform a scaled blit using the 9-grid algorithm to a destination surface, which
Contents
Availability
This function is available since SDL 3.2.0.
Description
The pixels in the source surface are split into a 3x3 grid, using the different corner sizes for each
corner, and the sides and center making up the remaining pixels. The corners are then scaled using scale
and fit into the corners of the destination rectangle. The sides and center are then stretched into place
to cover the remaining destination rectangle.
Function Parameters
src the SDL_Surface structure to be copied from.
srcrect
the SDL_Rect structure representing the rectangle to be used for the 9-grid, or NULL to use the
entire surface.
left_width
the width, in pixels, of the left corners in srcrect.
right_width
the width, in pixels, of the right corners in srcrect.
top_height
the height, in pixels, of the top corners in srcrect.
bottom_height
the height, in pixels, of the bottom corners in srcrect.
scale the scale used to transform the corner of srcrect into the corner of dstrect, or 0.0f for an
unscaled blit.
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.
Name
SDL_BlitSurface9Grid - Perform a scaled blit using the 9-grid algorithm to a destination surface, which
may be of a different format.
Return Value
for more information.
See Also
SDL_BlitSurface(3) Simple Directmedia Layer SDL 3.2.20 SDL_BlitSurface9Grid(3)
Synopsis
#include<SDL3/SDL_surface.h>boolSDL_BlitSurface9Grid(SDL_Surface*src,constSDL_Rect*srcrect,intleft_width,intright_width,inttop_height,intbottom_height,floatscale,SDL_ScaleModescaleMode,SDL_Surface*dst,constSDL_Rect*dstrect);
Thread Safety
Only one thread should be using the src and dst surfaces at any given time.
