Scroll to navigation

SDL_SetSurfaceClipRect(3) SDL3 FUNCTIONS SDL_SetSurfaceClipRect(3)

NAME

SDL_SetSurfaceClipRect - Set the clipping rectangle for a surface.

HEADER FILE

Defined in SDL3/SDL_surface.h

SYNOPSIS

#include "SDL3/SDL.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

the SDL_Surface
structure to be clipped.
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.

AVAILABILITY

This function is available since SDL 3.1.3.

SEE ALSO

(3), SDL_GetSurfaceClipRect(3)

SDL 3.1.6 Simple Directmedia Layer