Wiki Page Content

Differences between revisions 9 and 10
Revision 9 as of 2011-01-07 17:51:39
Size: 1227
Editor: SheenaSmith
Comment: update content - w/ Sam; remove draft
Revision 10 as of 2011-01-07 17:55:55
Size: 1067
Editor: SheenaSmith
Comment: update content - w/ Sam
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
If the clip rectangle doesn't intersect the surface, the function will return SDL_FALSE and blits will be completely clipped. Otherwise the function returns SDL_TRUE and blits to the surface will be clipped to the intersection of the surface area and the clipping rectangle. Returns SDL_TRUE if the rectangle intersects the surface or SDL_FALSE and blits will be completely clipped if not.

SDL_SetClipRect

Use this function to set the clipping rectangle for a surface.

Syntax

SDL_bool SDL_SetClipRect(SDL_Surface*    surface,
                         const SDL_Rect* rect)

Function Parameters

surface

the SDL_Surface structure to be clipped

rect

the SDL_Rect structure defining the clipping rectangle, or NULL to disable clipping

Return Value

Returns SDL_TRUE if the rectangle intersects the surface or SDL_FALSE and blits will be completely clipped if not.

Code Examples

You can add your code example here

Remarks

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.


CategoryAPI, CategorySurface

None: SDL_SetClipRect (last edited 2011-04-05 20:54:56 by SheenaSmith)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit