SDL_SetSurfaceClipRect - Man Page

Set the clipping rectangle for a surface.

Synopsis

#include <SDL3/SDL_surface.h>

bool SDL_SetSurfaceClipRect(SDL_Surface *surface, const SDL_Rect *rect);

Description

When surface is the destination of a blit, only the area within the clip rectangle is drawn into.

Note that blits are automatically clipped to the edges of the source and destination surfaces.

Function Parameters

surface

the SDL_Surface structure to be clipped.

rect

the SDL_Rect structure representing the clipping rectangle, or NULL to disable clipping.

Return Value

Returns true if the rectangle intersects the surface, otherwise false and blits will be completely clipped.

Thread Safety

This function is not thread safe.

Availability

This function is available since SDL 3.2.0.

See Also

SDL_GetSurfaceClipRect(3)

Referenced By

SDL_GetSurfaceClipRect(3).

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS