/[projet1]/public/pc/emulators/caloric/libs_windows/SDL/docs/html/sdlblitsurface.html
Defence Force logotype

Annotation of /public/pc/emulators/caloric/libs_windows/SDL/docs/html/sdlblitsurface.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 81 - (hide annotations)
Wed May 27 20:33:03 2009 UTC (10 years, 4 months ago) by Jede
File MIME type: text/html
File size: 5517 byte(s)
Ajouts des libs windows
1 Jede 81 <HTML
2     ><HEAD
3     ><TITLE
4     >SDL_BlitSurface</TITLE
5     ><META
6     NAME="GENERATOR"
7     CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
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_ConvertSurface"
17     HREF="sdlconvertsurface.html"><LINK
18     REL="NEXT"
19     TITLE="SDL_FillRect"
20     HREF="sdlfillrect.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     SUMMARY="Header navigation table"
32     WIDTH="100%"
33     BORDER="0"
34     CELLPADDING="0"
35     CELLSPACING="0"
36     ><TR
37     ><TH
38     COLSPAN="3"
39     ALIGN="center"
40     >SDL Library Documentation</TH
41     ></TR
42     ><TR
43     ><TD
44     WIDTH="10%"
45     ALIGN="left"
46     VALIGN="bottom"
47     ><A
48     HREF="sdlconvertsurface.html"
49     ACCESSKEY="P"
50     >Prev</A
51     ></TD
52     ><TD
53     WIDTH="80%"
54     ALIGN="center"
55     VALIGN="bottom"
56     ></TD
57     ><TD
58     WIDTH="10%"
59     ALIGN="right"
60     VALIGN="bottom"
61     ><A
62     HREF="sdlfillrect.html"
63     ACCESSKEY="N"
64     >Next</A
65     ></TD
66     ></TR
67     ></TABLE
68     ><HR
69     ALIGN="LEFT"
70     WIDTH="100%"></DIV
71     ><H1
72     ><A
73     NAME="SDLBLITSURFACE"
74     ></A
75     >SDL_BlitSurface</H1
76     ><DIV
77     CLASS="REFNAMEDIV"
78     ><A
79     NAME="AEN2299"
80     ></A
81     ><H2
82     >Name</H2
83     >SDL_BlitSurface&nbsp;--&nbsp;This performs a fast blit from the source surface to the destination surface.</DIV
84     ><DIV
85     CLASS="REFSYNOPSISDIV"
86     ><A
87     NAME="AEN2302"
88     ></A
89     ><H2
90     >Synopsis</H2
91     ><DIV
92     CLASS="FUNCSYNOPSIS"
93     ><A
94     NAME="AEN2303"
95     ></A
96     ><P
97     ></P
98     ><PRE
99     CLASS="FUNCSYNOPSISINFO"
100     >#include "SDL.h"</PRE
101     ><P
102     ><CODE
103     ><CODE
104     CLASS="FUNCDEF"
105     >int <B
106     CLASS="FSFUNC"
107     >SDL_BlitSurface</B
108     ></CODE
109     >(SDL_Surface *src, SDL_Rect *srcrect, SDL_Surface *dst, SDL_Rect *dstrect);</CODE
110     ></P
111     ><P
112     ></P
113     ></DIV
114     ></DIV
115     ><DIV
116     CLASS="REFSECT1"
117     ><A
118     NAME="AEN2309"
119     ></A
120     ><H2
121     >Description</H2
122     ><P
123     >This performs a fast blit from the source surface to the destination surface.</P
124     ><P
125     >The width and height in <TT
126     CLASS="PARAMETER"
127     ><I
128     >srcrect</I
129     ></TT
130     > determine the
131     size of the copied rectangle. Only the position is used in the
132     <TT
133     CLASS="PARAMETER"
134     ><I
135     >dstrect</I
136     ></TT
137     > (the width and height are ignored).</P
138     ><P
139     >If <TT
140     CLASS="PARAMETER"
141     ><I
142     >srcrect</I
143     ></TT
144     > is <TT
145     CLASS="LITERAL"
146     >NULL</TT
147     >, the
148     entire surface is copied. If <TT
149     CLASS="PARAMETER"
150     ><I
151     >dstrect</I
152     ></TT
153     > is
154     <TT
155     CLASS="LITERAL"
156     >NULL</TT
157     >, then the destination position (upper left
158     corner) is (0, 0).</P
159     ><P
160     >The final blit rectangle is saved in
161     <TT
162     CLASS="PARAMETER"
163     ><I
164     >dstrect</I
165     ></TT
166     > after all clipping is performed
167     (<TT
168     CLASS="PARAMETER"
169     ><I
170     >srcrect</I
171     ></TT
172     > is not modified).</P
173     ><P
174     >The blit function should not be called on a locked surface.</P
175     ><P
176     >The results of blitting operations vary greatly depending on whether <TT
177     CLASS="LITERAL"
178     >SDL_SRCAPLHA</TT
179     > is set or not. See <A
180     HREF="sdlsetalpha.html"
181     >SDL_SetAlpha</A
182     > for an explaination of how this affects your results. Colorkeying and alpha attributes also interact with surface blitting, as the following pseudo-code should hopefully explain.
183     <PRE
184     CLASS="PROGRAMLISTING"
185     >if (source surface has SDL_SRCALPHA set) {
186     if (source surface has alpha channel (that is, format-&#62;Amask != 0))
187     blit using per-pixel alpha, ignoring any colour key
188     else {
189     if (source surface has SDL_SRCCOLORKEY set)
190     blit using the colour key AND the per-surface alpha value
191     else
192     blit using the per-surface alpha value
193     }
194     } else {
195     if (source surface has SDL_SRCCOLORKEY set)
196     blit using the colour key
197     else
198     ordinary opaque rectangular blit
199     }</PRE
200     ></P
201     ></DIV
202     ><DIV
203     CLASS="REFSECT1"
204     ><A
205     NAME="AEN2328"
206     ></A
207     ><H2
208     >Return Value</H2
209     ><P
210     >If the blit is successful, it returns <SPAN
211     CLASS="RETURNVALUE"
212     >0</SPAN
213     >,
214     otherwise it returns <SPAN
215     CLASS="RETURNVALUE"
216     >-1</SPAN
217     >.</P
218     ><P
219     >If either of the surfaces were in video memory, and the blit returns
220     <SPAN
221     CLASS="RETURNVALUE"
222     >-2</SPAN
223     >, the video memory was lost, so it should be
224     reloaded with artwork and re-blitted:
225     <PRE
226     CLASS="PROGRAMLISTING"
227     > while ( SDL_BlitSurface(image, imgrect, screen, dstrect) == -2 ) {
228     while ( SDL_LockSurface(image)) &#60; 0 )
229     SDL_Delay(10);
230     -- Write image pixels to image-&#62;pixels --
231     SDL_UnlockSurface(image);
232     }</PRE
233     >
234     This happens under DirectX 5.0 when the system switches away from your
235     fullscreen application. Locking the surface will also fail until you
236     have access to the video memory again.</P
237     ></DIV
238     ><DIV
239     CLASS="REFSECT1"
240     ><A
241     NAME="AEN2336"
242     ></A
243     ><H2
244     >See Also</H2
245     ><P
246     ><A
247     HREF="sdllocksurface.html"
248     ><TT
249     CLASS="FUNCTION"
250     >SDL_LockSurface</TT
251     ></A
252     >,
253     <A
254     HREF="sdlfillrect.html"
255     ><TT
256     CLASS="FUNCTION"
257     >SDL_FillRect</TT
258     ></A
259     >,
260     <A
261     HREF="sdlsurface.html"
262     ><SPAN
263     CLASS="STRUCTNAME"
264     >SDL_Surface</SPAN
265     ></A
266     >,
267     <A
268     HREF="sdlrect.html"
269     ><SPAN
270     CLASS="STRUCTNAME"
271     >SDL_Rect</SPAN
272     ></A
273     ></P
274     ></DIV
275     ><DIV
276     CLASS="NAVFOOTER"
277     ><HR
278     ALIGN="LEFT"
279     WIDTH="100%"><TABLE
280     SUMMARY="Footer navigation table"
281     WIDTH="100%"
282     BORDER="0"
283     CELLPADDING="0"
284     CELLSPACING="0"
285     ><TR
286     ><TD
287     WIDTH="33%"
288     ALIGN="left"
289     VALIGN="top"
290     ><A
291     HREF="sdlconvertsurface.html"
292     ACCESSKEY="P"
293     >Prev</A
294     ></TD
295     ><TD
296     WIDTH="34%"
297     ALIGN="center"
298     VALIGN="top"
299     ><A
300     HREF="index.html"
301     ACCESSKEY="H"
302     >Home</A
303     ></TD
304     ><TD
305     WIDTH="33%"
306     ALIGN="right"
307     VALIGN="top"
308     ><A
309     HREF="sdlfillrect.html"
310     ACCESSKEY="N"
311     >Next</A
312     ></TD
313     ></TR
314     ><TR
315     ><TD
316     WIDTH="33%"
317     ALIGN="left"
318     VALIGN="top"
319     >SDL_ConvertSurface</TD
320     ><TD
321     WIDTH="34%"
322     ALIGN="center"
323     VALIGN="top"
324     ><A
325     HREF="video.html"
326     ACCESSKEY="U"
327     >Up</A
328     ></TD
329     ><TD
330     WIDTH="33%"
331     ALIGN="right"
332     VALIGN="top"
333     >SDL_FillRect</TD
334     ></TR
335     ></TABLE
336     ></DIV
337     ></BODY
338     ></HTML
339     >

  ViewVC Help
Powered by ViewVC 1.1.26