SDL-1.2.14
[sdl_omap.git] / docs / html / sdlcreateyuvoverlay.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >SDL_CreateYUVOverlay</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_GL_SwapBuffers"
17 HREF="sdlglswapbuffers.html"><LINK
18 REL="NEXT"
19 TITLE="SDL_LockYUVOverlay"
20 HREF="sdllockyuvoverlay.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="sdlglswapbuffers.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="sdllockyuvoverlay.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="SDLCREATEYUVOVERLAY"
74 ></A
75 >SDL_CreateYUVOverlay</H1
76 ><DIV
77 CLASS="REFNAMEDIV"
78 ><A
79 NAME="AEN2808"
80 ></A
81 ><H2
82 >Name</H2
83 >SDL_CreateYUVOverlay&nbsp;--&nbsp;Create a YUV video overlay</DIV
84 ><DIV
85 CLASS="REFSYNOPSISDIV"
86 ><A
87 NAME="AEN2811"
88 ></A
89 ><H2
90 >Synopsis</H2
91 ><DIV
92 CLASS="FUNCSYNOPSIS"
93 ><A
94 NAME="AEN2812"
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 >SDL_Overlay *<B
106 CLASS="FSFUNC"
107 >SDL_CreateYUVOverlay</B
108 ></CODE
109 >(int width, int height, Uint32 format, SDL_Surface *display);</CODE
110 ></P
111 ><P
112 ></P
113 ></DIV
114 ></DIV
115 ><DIV
116 CLASS="REFSECT1"
117 ><A
118 NAME="AEN2818"
119 ></A
120 ><H2
121 >Description</H2
122 ><P
123 ><TT
124 CLASS="FUNCTION"
125 >SDL_CreateYUVOverlay</TT
126 > creates a YUV overlay of the specified <TT
127 CLASS="PARAMETER"
128 ><I
129 >width</I
130 ></TT
131 >, <TT
132 CLASS="PARAMETER"
133 ><I
134 >height</I
135 ></TT
136 > and <TT
137 CLASS="PARAMETER"
138 ><I
139 >format</I
140 ></TT
141 > (see <A
142 HREF="sdloverlay.html"
143 ><SPAN
144 CLASS="STRUCTNAME"
145 >SDL_Overlay</SPAN
146 ></A
147 > for a list of available formats), for the provided <TT
148 CLASS="PARAMETER"
149 ><I
150 >display</I
151 ></TT
152 >. A <A
153 HREF="sdloverlay.html"
154 ><SPAN
155 CLASS="STRUCTNAME"
156 >SDL_Overlay</SPAN
157 ></A
158 > structure is returned.</P
159 ><P
160 >The term 'overlay' is a misnomer since, unless the overlay is created in hardware, the contents for the display surface underneath the area where the overlay is shown will be overwritten when the overlay is displayed.</P
161 ></DIV
162 ><DIV
163 CLASS="REFSECT1"
164 ><A
165 NAME="AEN2831"
166 ></A
167 ><H2
168 >See Also</H2
169 ><P
170 ><A
171 HREF="sdloverlay.html"
172 ><SPAN
173 CLASS="STRUCTNAME"
174 >SDL_Overlay</SPAN
175 ></A
176 >,
177 <A
178 HREF="sdldisplayyuvoverlay.html"
179 ><TT
180 CLASS="FUNCTION"
181 >SDL_DisplayYUVOverlay</TT
182 ></A
183 >,
184 <A
185 HREF="sdlfreeyuvoverlay.html"
186 ><TT
187 CLASS="FUNCTION"
188 >SDL_FreeYUVOverlay</TT
189 ></A
190 ></P
191 ></DIV
192 ><DIV
193 CLASS="NAVFOOTER"
194 ><HR
195 ALIGN="LEFT"
196 WIDTH="100%"><TABLE
197 SUMMARY="Footer navigation table"
198 WIDTH="100%"
199 BORDER="0"
200 CELLPADDING="0"
201 CELLSPACING="0"
202 ><TR
203 ><TD
204 WIDTH="33%"
205 ALIGN="left"
206 VALIGN="top"
207 ><A
208 HREF="sdlglswapbuffers.html"
209 ACCESSKEY="P"
210 >Prev</A
211 ></TD
212 ><TD
213 WIDTH="34%"
214 ALIGN="center"
215 VALIGN="top"
216 ><A
217 HREF="index.html"
218 ACCESSKEY="H"
219 >Home</A
220 ></TD
221 ><TD
222 WIDTH="33%"
223 ALIGN="right"
224 VALIGN="top"
225 ><A
226 HREF="sdllockyuvoverlay.html"
227 ACCESSKEY="N"
228 >Next</A
229 ></TD
230 ></TR
231 ><TR
232 ><TD
233 WIDTH="33%"
234 ALIGN="left"
235 VALIGN="top"
236 >SDL_GL_SwapBuffers</TD
237 ><TD
238 WIDTH="34%"
239 ALIGN="center"
240 VALIGN="top"
241 ><A
242 HREF="video.html"
243 ACCESSKEY="U"
244 >Up</A
245 ></TD
246 ><TD
247 WIDTH="33%"
248 ALIGN="right"
249 VALIGN="top"
250 >SDL_LockYUVOverlay</TD
251 ></TR
252 ></TABLE
253 ></DIV
254 ></BODY
255 ></HTML
256 >