Subversion Repositories Kolibri OS

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
5131 clevermous 1
2
>
3
>
4
>SDL_Overlay
5
>
6
NAME="GENERATOR"
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
8
">
9
REL="HOME"
10
TITLE="SDL Library Documentation"
11
HREF="index.html">
12
REL="UP"
13
TITLE="Video"
14
HREF="video.html">
15
REL="PREVIOUS"
16
TITLE="SDL_VideoInfo"
17
HREF="sdlvideoinfo.html">
18
REL="NEXT"
19
TITLE="Window Management"
20
HREF="wm.html">
21
>
22
CLASS="REFENTRY"
23
BGCOLOR="#FFF8DC"
24
TEXT="#000000"
25
LINK="#0000ee"
26
VLINK="#551a8b"
27
ALINK="#ff0000"
28
>
29
CLASS="NAVHEADER"
30
>
31
WIDTH="100%"
32
BORDER="0"
33
CELLPADDING="0"
34
CELLSPACING="0"
35
>
36
>
37
COLSPAN="3"
38
ALIGN="center"
39
>SDL Library Documentation
40
>
41
>
42
>
43
WIDTH="10%"
44
ALIGN="left"
45
VALIGN="bottom"
46
>
47
HREF="sdlvideoinfo.html"
48
>Prev
49
>
50
>
51
WIDTH="80%"
52
ALIGN="center"
53
VALIGN="bottom"
54
>
55
>
56
WIDTH="10%"
57
ALIGN="right"
58
VALIGN="bottom"
59
>
60
HREF="wm.html"
61
>Next
62
>
63
>
64
>
65
>
66
ALIGN="LEFT"
67
WIDTH="100%">
68
>
69
>
70
NAME="SDLOVERLAY"
71
>SDL_Overlay
72
>
73
>
74
CLASS="REFNAMEDIV"
75
>
76
NAME="AEN3042"
77
>
78
>
79
>Name
80
>SDL_Overlay -- YUV video overlay
81
>
82
CLASS="REFSECT1"
83
>
84
NAME="AEN3045"
85
>
86
>
87
>Structure Definition
88
>
89
CLASS="PROGRAMLISTING"
90
>typedef struct{
91
  Uint32 format;
92
  int w, h;
93
  int planes;
94
  Uint16 *pitches;
95
  Uint8 **pixels;
96
  Uint32 hw_overlay:1;
97
} SDL_Overlay;
98
>
99
>
100
CLASS="REFSECT1"
101
>
102
NAME="AEN3048"
103
>
104
>
105
>Structure Data
106
>
107
CLASS="INFORMALTABLE"
108
>
109
NAME="AEN3050"
110
>
111
>
112
>
113
>
114
BORDER="0"
115
CLASS="CALSTABLE"
116
>
117
>
118
>
119
ALIGN="LEFT"
120
VALIGN="TOP"
121
>
122
CLASS="STRUCTFIELD"
123
>
124
>format
125
>
126
>
127
>
128
ALIGN="LEFT"
129
VALIGN="TOP"
130
>Overlay format (see below)
131
>
132
>
133
>
134
ALIGN="LEFT"
135
VALIGN="TOP"
136
>
137
CLASS="STRUCTFIELD"
138
>
139
>w, h
140
>
141
>
142
>
143
ALIGN="LEFT"
144
VALIGN="TOP"
145
>Width and height of overlay
146
>
147
>
148
>
149
ALIGN="LEFT"
150
VALIGN="TOP"
151
>
152
CLASS="STRUCTFIELD"
153
>
154
>planes
155
>
156
>
157
>
158
ALIGN="LEFT"
159
VALIGN="TOP"
160
>Number of planes in the overlay. Usually either 1 or 3
161
>
162
>
163
>
164
ALIGN="LEFT"
165
VALIGN="TOP"
166
>
167
CLASS="STRUCTFIELD"
168
>
169
>pitches
170
>
171
>
172
>
173
ALIGN="LEFT"
174
VALIGN="TOP"
175
>An array of pitches, one for each plane. Pitch is the length of a row in bytes.
176
>
177
>
178
>
179
ALIGN="LEFT"
180
VALIGN="TOP"
181
>
182
CLASS="STRUCTFIELD"
183
>
184
>pixels
185
>
186
>
187
>
188
ALIGN="LEFT"
189
VALIGN="TOP"
190
>An array of pointers to teh data of each plane. The overlay should be locked before these pointers are used.
191
>
192
>
193
>
194
ALIGN="LEFT"
195
VALIGN="TOP"
196
>
197
CLASS="STRUCTFIELD"
198
>
199
>hw_overlay
200
>
201
>
202
>
203
ALIGN="LEFT"
204
VALIGN="TOP"
205
>This will be set to 1 if the overlay is hardware accelerated.
206
>
207
>
208
>
209
>
210
>
211
>
212
>
213
>
214
CLASS="REFSECT1"
215
>
216
NAME="AEN3077"
217
>
218
>
219
>Description
220
>
221
>A 
222
CLASS="STRUCTNAME"
223
>SDL_Overlay
224
> is similar to a 
225
HREF="sdlsurface.html"
226
>
227
CLASS="STRUCTNAME"
228
>SDL_Surface
229
>
230
> except it stores a YUV overlay. All the fields are read only, except for 
231
CLASS="STRUCTFIELD"
232
>
233
>pixels
234
>
235
> which should be 
236
HREF="sdllockyuvoverlay.html"
237
>locked
238
> before use. The 
239
CLASS="STRUCTFIELD"
240
>
241
>format
242
>
243
> field stores the format of the overlay which is one of the following:
244
245
CLASS="PROGRAMLISTING"
246
>#define SDL_YV12_OVERLAY  0x32315659  /* Planar mode: Y + V + U */
247
#define SDL_IYUV_OVERLAY  0x56555949  /* Planar mode: Y + U + V */
248
#define SDL_YUY2_OVERLAY  0x32595559  /* Packed mode: Y0+U0+Y1+V0 */
249
#define SDL_UYVY_OVERLAY  0x59565955  /* Packed mode: U0+Y0+V0+Y1 */
250
#define SDL_YVYU_OVERLAY  0x55595659  /* Packed mode: Y0+V0+Y1+U0 */
251
>
252
More information on YUV formats can be found at 
253
HREF="http://www.webartz.com/fourcc/indexyuv.htm"
254
TARGET="_top"
255
>http://www.webartz.com/fourcc/indexyuv.htm
256
>.
257
>
258
>
259
CLASS="REFSECT1"
260
>
261
NAME="AEN3088"
262
>
263
>
264
>See Also
265
>
266
>
267
HREF="sdlcreateyuvoverlay.html"
268
>
269
CLASS="FUNCTION"
270
>SDL_CreateYUVOverlay
271
>
272
>,
273
274
HREF="sdllockyuvoverlay.html"
275
>
276
CLASS="FUNCTION"
277
>SDL_LockYUVOverlay
278
>
279
>,
280
281
HREF="sdlunlockyuvoverlay.html"
282
>
283
CLASS="FUNCTION"
284
>SDL_UnlockYUVOverlay
285
>
286
>,
287
288
HREF="sdlfreeyuvoverlay.html"
289
>
290
CLASS="FUNCTION"
291
>SDL_FreeYUVOverlay
292
>
293
>
294
>
295
>
296
CLASS="NAVFOOTER"
297
>
298
ALIGN="LEFT"
299
WIDTH="100%">
300
WIDTH="100%"
301
BORDER="0"
302
CELLPADDING="0"
303
CELLSPACING="0"
304
>
305
>
306
WIDTH="33%"
307
ALIGN="left"
308
VALIGN="top"
309
>
310
HREF="sdlvideoinfo.html"
311
>Prev
312
>
313
>
314
WIDTH="34%"
315
ALIGN="center"
316
VALIGN="top"
317
>
318
HREF="index.html"
319
>Home
320
>
321
>
322
WIDTH="33%"
323
ALIGN="right"
324
VALIGN="top"
325
>
326
HREF="wm.html"
327
>Next
328
>
329
>
330
>
331
>
332
WIDTH="33%"
333
ALIGN="left"
334
VALIGN="top"
335
>SDL_VideoInfo
336
>
337
WIDTH="34%"
338
ALIGN="center"
339
VALIGN="top"
340
>
341
HREF="video.html"
342
>Up
343
>
344
>
345
WIDTH="33%"
346
ALIGN="right"
347
VALIGN="top"
348
>Window Management
349
>
350
>
351
>
352
>
353
>
354
>