Wiki Page Content

Differences between revisions 3 and 5 (spanning 2 versions)
Revision 3 as of 2010-08-09 17:57:33
Size: 1221
Editor: SheenaSmith
Comment: update content (old wiki)
Revision 5 as of 2010-09-22 23:58:59
Size: 1284
Editor: SheenaSmith
Comment: update content - rectangle
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
||'''surface'''||the surface / [[SDL_Surface]] to be updated||
||'''rect'''||a pointer to the [[SDL_Rect]] to be applied||
||'''surface'''||a pointer to the surface of type [[SDL_Surface]] to be updated||
||'''rect'''||a pointer to a rectangle of type [[SDL_Rect]]'', or NULL for the entire render target''||

DRAFT

SDL_SetClipRect

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

Syntax

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

Function Parameters

surface

a pointer to the surface of type SDL_Surface to be updated

rect

a pointer to a rectangle of type SDL_Rect, or NULL for the entire render target

Return Value

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.

Code Examples

You can add your code example here

Remarks

If the clip rectangle is NULL, clipping will be disabled.

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