Wiki Page Content

Differences between revisions 12 and 13
Revision 12 as of 2011-01-07 17:58:32
Size: 1068
Editor: SheenaSmith
Comment: minor change
Revision 13 as of 2011-04-05 20:54:56
Size: 1072
Editor: SheenaSmith
Comment: minor change for consistency
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
||'''rect'''||the [[SDL_Rect]] structure defining the clipping rectangle, or NULL to disable clipping|| ||'''rect'''||the [[SDL_Rect]] structure representing the clipping rectangle, or NULL to disable clipping||

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 representing the clipping rectangle, or NULL to disable clipping

Return Value

Returns SDL_TRUE if the rectangle intersects the surface, otherwise SDL_FALSE and blits will be completely clipped.

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