home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue2 / SDL.ARC / sdlhtmldox / sdlupdater < prev    next >
Encoding:
Text File  |  2001-05-09  |  3.2 KB  |  245 lines
  1. <HTML
  2. ><HEAD
  3. ><TITLE
  4. >SDL_UpdateRects</TITLE
  5. ><META
  6. NAME="GENERATOR"
  7. CONTENT="Modular DocBook HTML Stylesheet Version 1.64
  8. "><LINK
  9. REL="HOME"
  10. TITLE="SDL Library Documentation"
  11. HREF="index.html"><LINK
  12. REL="UP"
  13. TITLE="Video"
  14. HREF="video.html"><LINK
  15. REL="PREVIOUS"
  16. TITLE="SDL_UpdateRect"
  17. HREF="sdlupdaterect.html"><LINK
  18. REL="NEXT"
  19. TITLE="SDL_Flip"
  20. HREF="sdlflip.html"></HEAD
  21. ><BODY
  22. CLASS="REFENTRY"
  23. BGCOLOR="#FFF8DC"
  24. TEXT="#000000"
  25. LINK="#0000ee"
  26. VLINK="#551a8b"
  27. ALINK="#ff0000"
  28. ><DIV
  29. CLASS="NAVHEADER"
  30. ><TABLE
  31. WIDTH="100%"
  32. BORDER="0"
  33. CELLPADDING="0"
  34. CELLSPACING="0"
  35. ><TR
  36. ><TH
  37. COLSPAN="3"
  38. ALIGN="center"
  39. >SDL Library Documentation</TH
  40. ></TR
  41. ><TR
  42. ><TD
  43. WIDTH="10%"
  44. ALIGN="left"
  45. VALIGN="bottom"
  46. ><A
  47. HREF="sdlupdaterect.html"
  48. >Prev</A
  49. ></TD
  50. ><TD
  51. WIDTH="80%"
  52. ALIGN="center"
  53. VALIGN="bottom"
  54. ></TD
  55. ><TD
  56. WIDTH="10%"
  57. ALIGN="right"
  58. VALIGN="bottom"
  59. ><A
  60. HREF="sdlflip.html"
  61. >Next</A
  62. ></TD
  63. ></TR
  64. ></TABLE
  65. ><HR
  66. ALIGN="LEFT"
  67. WIDTH="100%"></DIV
  68. ><H1
  69. ><A
  70. NAME="SDLUPDATERECTS"
  71. >SDL_UpdateRects</A
  72. ></H1
  73. ><DIV
  74. CLASS="REFNAMEDIV"
  75. ><A
  76. NAME="AEN1010"
  77. ></A
  78. ><H2
  79. >Name</H2
  80. >SDL_UpdateRects -- Makes sure the given list of rectangles is updated on the given screen.</DIV
  81. ><DIV
  82. CLASS="REFSYNOPSISDIV"
  83. ><A
  84. NAME="AEN1013"
  85. ></A
  86. ><H2
  87. >Synopsis</H2
  88. ><DIV
  89. CLASS="FUNCSYNOPSIS"
  90. ><A
  91. NAME="AEN1014"
  92. ></A
  93. ><P
  94. ></P
  95. ><PRE
  96. CLASS="FUNCSYNOPSISINFO"
  97. >#include "SDL.h"</PRE
  98. ><P
  99. ><CODE
  100. ><CODE
  101. CLASS="FUNCDEF"
  102. >void <B
  103. CLASS="FSFUNC"
  104. >SDL_UpdateRects</B
  105. ></CODE
  106. >(SDL_Surface *screen, int numrects, SDL_Rect *rects);</CODE
  107. ></P
  108. ><P
  109. ></P
  110. ></DIV
  111. ></DIV
  112. ><DIV
  113. CLASS="REFSECT1"
  114. ><A
  115. NAME="AEN1020"
  116. ></A
  117. ><H2
  118. >Description</H2
  119. ><P
  120. >Makes sure the given list of rectangles is updated on the given screen.</P
  121. ><P
  122. >This function should not be called while <TT
  123. CLASS="PARAMETER"
  124. ><I
  125. >screen</I
  126. ></TT
  127. > is
  128. <A
  129. HREF="sdllocksurface.html"
  130. >locked</A
  131. >.</P
  132. ><DIV
  133. CLASS="NOTE"
  134. ><BLOCKQUOTE
  135. CLASS="NOTE"
  136. ><P
  137. ><B
  138. >Note: </B
  139. >It is adviced to call this function only once per frame, since each
  140. call has some processing overhead. This is no restriction since you
  141. can pass any number of rectangles each time.</P
  142. ><P
  143. >The rectangles are not automatically merged or checked for overlap. In
  144. general, the programmer can use his knowledge about his particular
  145. rectangles to merge them in an efficient way, to avoid overdraw.</P
  146. ></BLOCKQUOTE
  147. ></DIV
  148. ></DIV
  149. ><DIV
  150. CLASS="REFSECT1"
  151. ><A
  152. NAME="AEN1029"
  153. ></A
  154. ><H2
  155. >See Also</H2
  156. ><P
  157. ><A
  158. HREF="sdlupdaterect.html"
  159. ><TT
  160. CLASS="FUNCTION"
  161. >SDL_UpdateRect</TT
  162. ></A
  163. >,
  164. <A
  165. HREF="sdlrect.html"
  166. ><SPAN
  167. CLASS="STRUCTNAME"
  168. >SDL_Rect</SPAN
  169. ></A
  170. >,
  171. <A
  172. HREF="sdlsurface.html"
  173. ><SPAN
  174. CLASS="STRUCTNAME"
  175. >SDL_Surface</SPAN
  176. ></A
  177. >,
  178. <A
  179. HREF="sdllocksurface.html"
  180. ><TT
  181. CLASS="FUNCTION"
  182. >SDL_LockSurface</TT
  183. ></A
  184. ></P
  185. ></DIV
  186. ><DIV
  187. CLASS="NAVFOOTER"
  188. ><HR
  189. ALIGN="LEFT"
  190. WIDTH="100%"><TABLE
  191. WIDTH="100%"
  192. BORDER="0"
  193. CELLPADDING="0"
  194. CELLSPACING="0"
  195. ><TR
  196. ><TD
  197. WIDTH="33%"
  198. ALIGN="left"
  199. VALIGN="top"
  200. ><A
  201. HREF="sdlupdaterect.html"
  202. >Prev</A
  203. ></TD
  204. ><TD
  205. WIDTH="34%"
  206. ALIGN="center"
  207. VALIGN="top"
  208. ><A
  209. HREF="index.html"
  210. >Home</A
  211. ></TD
  212. ><TD
  213. WIDTH="33%"
  214. ALIGN="right"
  215. VALIGN="top"
  216. ><A
  217. HREF="sdlflip.html"
  218. >Next</A
  219. ></TD
  220. ></TR
  221. ><TR
  222. ><TD
  223. WIDTH="33%"
  224. ALIGN="left"
  225. VALIGN="top"
  226. >SDL_UpdateRect</TD
  227. ><TD
  228. WIDTH="34%"
  229. ALIGN="center"
  230. VALIGN="top"
  231. ><A
  232. HREF="video.html"
  233. >Up</A
  234. ></TD
  235. ><TD
  236. WIDTH="33%"
  237. ALIGN="right"
  238. VALIGN="top"
  239. >SDL_Flip</TD
  240. ></TR
  241. ></TABLE
  242. ></DIV
  243. ></BODY
  244. ></HTML
  245. >