[sdl_omap.git] / docs / html / sdlcreateyuvoverlay.html

<HTML
><HEAD
><TITLE
>SDL_CreateYUVOverlay</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="Video"
HREF="video.html"><LINK
REL="PREVIOUS"
TITLE="SDL_GL_SwapBuffers"
HREF="sdlglswapbuffers.html"><LINK
REL="NEXT"
TITLE="SDL_LockYUVOverlay"
HREF="sdllockyuvoverlay.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFF8DC"
TEXT="#000000"
LINK="#0000ee"
VLINK="#551a8b"
ALINK="#ff0000"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>SDL Library Documentation</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="sdlglswapbuffers.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sdllockyuvoverlay.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="SDLCREATEYUVOVERLAY"
></A
>SDL_CreateYUVOverlay</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2808"
></A
><H2
>Name</H2
>SDL_CreateYUVOverlay&nbsp;--&nbsp;Create a YUV video overlay</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2811"
></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN2812"
></A
><P
></P
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include "SDL.h"</PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>SDL_Overlay *<B
CLASS="FSFUNC"
>SDL_CreateYUVOverlay</B
></CODE
>(int width, int height, Uint32 format, SDL_Surface *display);</CODE
></P
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2818"
></A
><H2
>Description</H2
><P
><TT
CLASS="FUNCTION"
>SDL_CreateYUVOverlay</TT
> creates a YUV overlay of the specified <TT
CLASS="PARAMETER"
><I
>width</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>format</I
></TT
> (see <A
HREF="sdloverlay.html"
><SPAN
CLASS="STRUCTNAME"
>SDL_Overlay</SPAN
></A
> for a list of available formats), for the provided <TT
CLASS="PARAMETER"
><I
>display</I
></TT
>. A <A
HREF="sdloverlay.html"
><SPAN
CLASS="STRUCTNAME"
>SDL_Overlay</SPAN
></A
> structure is returned.</P
><P
>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
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2831"
></A
><H2
>See Also</H2
><P
><A
HREF="sdloverlay.html"
><SPAN
CLASS="STRUCTNAME"
>SDL_Overlay</SPAN
></A
>,
<A
HREF="sdldisplayyuvoverlay.html"
><TT
CLASS="FUNCTION"
>SDL_DisplayYUVOverlay</TT
></A
>,
<A
HREF="sdlfreeyuvoverlay.html"
><TT
CLASS="FUNCTION"
>SDL_FreeYUVOverlay</TT
></A
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sdlglswapbuffers.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sdllockyuvoverlay.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>SDL_GL_SwapBuffers</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="video.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>SDL_LockYUVOverlay</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
Commit	Line	Data
e14743d1	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 -- 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	>