1<HTML 2><HEAD 3><TITLE 4>SDL_UpdateRect</TITLE 5><META 6NAME="GENERATOR" 7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8"><LINK 9REL="HOME" 10TITLE="SDL Library Documentation" 11HREF="index.html"><LINK 12REL="UP" 13TITLE="Video" 14HREF="video.html"><LINK 15REL="PREVIOUS" 16TITLE="SDL_SetVideoMode" 17HREF="sdlsetvideomode.html"><LINK 18REL="NEXT" 19TITLE="SDL_UpdateRects" 20HREF="sdlupdaterects.html"></HEAD 21><BODY 22CLASS="REFENTRY" 23BGCOLOR="#FFF8DC" 24TEXT="#000000" 25LINK="#0000ee" 26VLINK="#551a8b" 27ALINK="#ff0000" 28><DIV 29CLASS="NAVHEADER" 30><TABLE 31SUMMARY="Header navigation table" 32WIDTH="100%" 33BORDER="0" 34CELLPADDING="0" 35CELLSPACING="0" 36><TR 37><TH 38COLSPAN="3" 39ALIGN="center" 40>SDL Library Documentation</TH 41></TR 42><TR 43><TD 44WIDTH="10%" 45ALIGN="left" 46VALIGN="bottom" 47><A 48HREF="sdlsetvideomode.html" 49ACCESSKEY="P" 50>Prev</A 51></TD 52><TD 53WIDTH="80%" 54ALIGN="center" 55VALIGN="bottom" 56></TD 57><TD 58WIDTH="10%" 59ALIGN="right" 60VALIGN="bottom" 61><A 62HREF="sdlupdaterects.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLUPDATERECT" 74></A 75>SDL_UpdateRect</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN1355" 80></A 81><H2 82>Name</H2 83>SDL_UpdateRect -- Makes sure the given area is updated on the given screen.</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN1358" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN1359" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL.h"</PRE 101><P 102><CODE 103><CODE 104CLASS="FUNCDEF" 105>void <B 106CLASS="FSFUNC" 107>SDL_UpdateRect</B 108></CODE 109>(SDL_Surface *screen, Sint32 x, Sint32 y, Sint32 w, Sint32 h);</CODE 110></P 111><P 112></P 113></DIV 114></DIV 115><DIV 116CLASS="REFSECT1" 117><A 118NAME="AEN1365" 119></A 120><H2 121>Description</H2 122><P 123>Makes sure the given area is updated on the given screen. The rectangle must 124be confined within the screen boundaries (no clipping is done).</P 125><P 126>If '<TT 127CLASS="PARAMETER" 128><I 129>x</I 130></TT 131>', '<TT 132CLASS="PARAMETER" 133><I 134>y</I 135></TT 136>', '<TT 137CLASS="PARAMETER" 138><I 139>w</I 140></TT 141>' 142and '<TT 143CLASS="PARAMETER" 144><I 145>h</I 146></TT 147>' are all 0, 148<TT 149CLASS="FUNCTION" 150>SDL_UpdateRect</TT 151> will update the 152entire screen.</P 153><P 154>This function should not be called while '<TT 155CLASS="PARAMETER" 156><I 157>screen</I 158></TT 159>' is 160<A 161HREF="sdllocksurface.html" 162>locked</A 163>.</P 164></DIV 165><DIV 166CLASS="REFSECT1" 167><A 168NAME="AEN1377" 169></A 170><H2 171>See Also</H2 172><P 173><A 174HREF="sdlupdaterects.html" 175><TT 176CLASS="FUNCTION" 177>SDL_UpdateRects</TT 178></A 179>, 180<A 181HREF="sdlrect.html" 182><SPAN 183CLASS="STRUCTNAME" 184>SDL_Rect</SPAN 185></A 186>, 187<A 188HREF="sdlsurface.html" 189><SPAN 190CLASS="STRUCTNAME" 191>SDL_Surface</SPAN 192></A 193>, 194<A 195HREF="sdllocksurface.html" 196><TT 197CLASS="FUNCTION" 198>SDL_LockSurface</TT 199></A 200></P 201></DIV 202><DIV 203CLASS="NAVFOOTER" 204><HR 205ALIGN="LEFT" 206WIDTH="100%"><TABLE 207SUMMARY="Footer navigation table" 208WIDTH="100%" 209BORDER="0" 210CELLPADDING="0" 211CELLSPACING="0" 212><TR 213><TD 214WIDTH="33%" 215ALIGN="left" 216VALIGN="top" 217><A 218HREF="sdlsetvideomode.html" 219ACCESSKEY="P" 220>Prev</A 221></TD 222><TD 223WIDTH="34%" 224ALIGN="center" 225VALIGN="top" 226><A 227HREF="index.html" 228ACCESSKEY="H" 229>Home</A 230></TD 231><TD 232WIDTH="33%" 233ALIGN="right" 234VALIGN="top" 235><A 236HREF="sdlupdaterects.html" 237ACCESSKEY="N" 238>Next</A 239></TD 240></TR 241><TR 242><TD 243WIDTH="33%" 244ALIGN="left" 245VALIGN="top" 246>SDL_SetVideoMode</TD 247><TD 248WIDTH="34%" 249ALIGN="center" 250VALIGN="top" 251><A 252HREF="video.html" 253ACCESSKEY="U" 254>Up</A 255></TD 256><TD 257WIDTH="33%" 258ALIGN="right" 259VALIGN="top" 260>SDL_UpdateRects</TD 261></TR 262></TABLE 263></DIV 264></BODY 265></HTML 266>