(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_LowerBlit

Perform low-level surface blitting only.

Header File

Defined in SDL_surface.h

Syntax

int SDL_LowerBlit
    (SDL_Surface * src, SDL_Rect * srcrect,
     SDL_Surface * dst, SDL_Rect * 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
dst the SDL_Surface structure that is the blit target
dstrect the SDL_Rect structure representing the rectangle that is copied into

Return Value

Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Remarks

This is a semi-private blit function and it performs low-level surface blitting, assuming the input rectangles have already been clipped.

Unless you know what you're doing, you should be using SDL_BlitSurface() instead.

Version

This function is available since SDL 2.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategorySurface