Mercurial > sdl-ios-xcode
annotate docs/html/sdloverlay.html @ 641:df178851293b
Date: 28 Jun 2003 22:42:52 +0100
From: Alan Swanson
Subject: Re: [SDL] New XFree 4.3 Video Mode Patch
I have a wee amendment that moves the qsort in set_best_resolution
to only occur after failing to find an exact match only. This would
make absolutely sure we get a user set mode.
While I've never had any problems for my normal resolutions (1280x1024,
1024x768, 800x600 & 640,480) while closely examining the output from
qsort I've noticed it doesn't seem to sort the modes fully. These is
one definite wrong at 1152x768 and a few that just look wrong to me.
From a program (attached) I made to examine this more easily. X has
sorted its mode list using the same method as ours (plus frequency),
and our user modes get inserted without any other movement.
On the patch I've made I've also changed cmpmodes to sort on vertical
resolution and then horizontal. Ie vertical is now most significant
bit.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Sat, 28 Jun 2003 21:52:26 +0000 |
| parents | e5bc29de3f0a |
| children | 355632dca928 |
| rev | line source |
|---|---|
| 0 | 1 <HTML |
| 2 ><HEAD | |
| 3 ><TITLE | |
| 4 >SDL_Overlay</TITLE | |
| 5 ><META | |
| 6 NAME="GENERATOR" | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64 |
| 0 | 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_VideoInfo" | |
| 17 HREF="sdlvideoinfo.html"><LINK | |
| 18 REL="NEXT" | |
| 19 TITLE="Window Management" | |
| 20 HREF="wm.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="sdlvideoinfo.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="wm.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="SDLOVERLAY" | |
| 71 >SDL_Overlay</A | |
| 72 ></H1 | |
| 73 ><DIV | |
| 74 CLASS="REFNAMEDIV" | |
| 75 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
76 NAME="AEN3080" |
| 0 | 77 ></A |
| 78 ><H2 | |
| 79 >Name</H2 | |
| 80 >SDL_Overlay -- YUV video overlay</DIV | |
| 81 ><DIV | |
| 82 CLASS="REFSECT1" | |
| 83 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
84 NAME="AEN3083" |
| 0 | 85 ></A |
| 86 ><H2 | |
| 87 >Structure Definition</H2 | |
| 88 ><PRE | |
| 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;</PRE | |
| 98 ></DIV | |
| 99 ><DIV | |
| 100 CLASS="REFSECT1" | |
| 101 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
102 NAME="AEN3086" |
| 0 | 103 ></A |
| 104 ><H2 | |
| 105 >Structure Data</H2 | |
| 106 ><DIV | |
| 107 CLASS="INFORMALTABLE" | |
| 108 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
109 NAME="AEN3088" |
| 0 | 110 ></A |
| 111 ><P | |
| 112 ></P | |
| 113 ><TABLE | |
| 114 BORDER="0" | |
| 115 CLASS="CALSTABLE" | |
| 116 ><TBODY | |
| 117 ><TR | |
| 118 ><TD | |
| 119 ALIGN="LEFT" | |
| 120 VALIGN="TOP" | |
| 121 ><TT | |
| 122 CLASS="STRUCTFIELD" | |
| 123 ><I | |
| 124 >format</I | |
| 125 ></TT | |
| 126 ></TD | |
| 127 ><TD | |
| 128 ALIGN="LEFT" | |
| 129 VALIGN="TOP" | |
| 130 >Overlay format (see below)</TD | |
| 131 ></TR | |
| 132 ><TR | |
| 133 ><TD | |
| 134 ALIGN="LEFT" | |
| 135 VALIGN="TOP" | |
| 136 ><TT | |
| 137 CLASS="STRUCTFIELD" | |
| 138 ><I | |
| 139 >w, h</I | |
| 140 ></TT | |
| 141 ></TD | |
| 142 ><TD | |
| 143 ALIGN="LEFT" | |
| 144 VALIGN="TOP" | |
| 145 >Width and height of overlay</TD | |
| 146 ></TR | |
| 147 ><TR | |
| 148 ><TD | |
| 149 ALIGN="LEFT" | |
| 150 VALIGN="TOP" | |
| 151 ><TT | |
| 152 CLASS="STRUCTFIELD" | |
| 153 ><I | |
| 154 >planes</I | |
| 155 ></TT | |
| 156 ></TD | |
| 157 ><TD | |
| 158 ALIGN="LEFT" | |
| 159 VALIGN="TOP" | |
| 160 >Number of planes in the overlay. Usually either 1 or 3</TD | |
| 161 ></TR | |
| 162 ><TR | |
| 163 ><TD | |
| 164 ALIGN="LEFT" | |
| 165 VALIGN="TOP" | |
| 166 ><TT | |
| 167 CLASS="STRUCTFIELD" | |
| 168 ><I | |
| 169 >pitches</I | |
| 170 ></TT | |
| 171 ></TD | |
| 172 ><TD | |
| 173 ALIGN="LEFT" | |
| 174 VALIGN="TOP" | |
| 175 >An array of pitches, one for each plane. Pitch is the length of a row in bytes.</TD | |
| 176 ></TR | |
| 177 ><TR | |
| 178 ><TD | |
| 179 ALIGN="LEFT" | |
| 180 VALIGN="TOP" | |
| 181 ><TT | |
| 182 CLASS="STRUCTFIELD" | |
| 183 ><I | |
| 184 >pixels</I | |
| 185 ></TT | |
| 186 ></TD | |
| 187 ><TD | |
| 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.</TD | |
| 191 ></TR | |
| 192 ><TR | |
| 193 ><TD | |
| 194 ALIGN="LEFT" | |
| 195 VALIGN="TOP" | |
| 196 ><TT | |
| 197 CLASS="STRUCTFIELD" | |
| 198 ><I | |
| 199 >hw_overlay</I | |
| 200 ></TT | |
| 201 ></TD | |
| 202 ><TD | |
| 203 ALIGN="LEFT" | |
| 204 VALIGN="TOP" | |
| 205 >This will be set to 1 if the overlay is hardware accelerated.</TD | |
| 206 ></TR | |
| 207 ></TBODY | |
| 208 ></TABLE | |
| 209 ><P | |
| 210 ></P | |
| 211 ></DIV | |
| 212 ></DIV | |
| 213 ><DIV | |
| 214 CLASS="REFSECT1" | |
| 215 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
216 NAME="AEN3115" |
| 0 | 217 ></A |
| 218 ><H2 | |
| 219 >Description</H2 | |
| 220 ><P | |
| 221 >A <SPAN | |
| 222 CLASS="STRUCTNAME" | |
| 223 >SDL_Overlay</SPAN | |
| 224 > is similar to a <A | |
| 225 HREF="sdlsurface.html" | |
| 226 ><SPAN | |
| 227 CLASS="STRUCTNAME" | |
| 228 >SDL_Surface</SPAN | |
| 229 ></A | |
| 230 > except it stores a YUV overlay. All the fields are read only, except for <TT | |
| 231 CLASS="STRUCTFIELD" | |
| 232 ><I | |
| 233 >pixels</I | |
| 234 ></TT | |
| 235 > which should be <A | |
| 236 HREF="sdllockyuvoverlay.html" | |
| 237 >locked</A | |
| 238 > before use. The <TT | |
| 239 CLASS="STRUCTFIELD" | |
| 240 ><I | |
| 241 >format</I | |
| 242 ></TT | |
| 243 > field stores the format of the overlay which is one of the following: | |
| 244 <PRE | |
| 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 */</PRE | |
| 251 > | |
| 252 More information on YUV formats can be found at <A | |
| 253 HREF="http://www.webartz.com/fourcc/indexyuv.htm" | |
| 254 TARGET="_top" | |
| 255 >http://www.webartz.com/fourcc/indexyuv.htm</A | |
| 256 >.</P | |
| 257 ></DIV | |
| 258 ><DIV | |
| 259 CLASS="REFSECT1" | |
| 260 ><A | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
261 NAME="AEN3126" |
| 0 | 262 ></A |
| 263 ><H2 | |
| 264 >See Also</H2 | |
| 265 ><P | |
| 266 ><A | |
| 267 HREF="sdlcreateyuvoverlay.html" | |
| 268 ><TT | |
| 269 CLASS="FUNCTION" | |
| 270 >SDL_CreateYUVOverlay</TT | |
| 271 ></A | |
| 272 >, | |
| 273 <A | |
| 274 HREF="sdllockyuvoverlay.html" | |
| 275 ><TT | |
| 276 CLASS="FUNCTION" | |
| 277 >SDL_LockYUVOverlay</TT | |
| 278 ></A | |
| 279 >, | |
| 280 <A | |
| 281 HREF="sdlunlockyuvoverlay.html" | |
| 282 ><TT | |
| 283 CLASS="FUNCTION" | |
| 284 >SDL_UnlockYUVOverlay</TT | |
| 285 ></A | |
| 286 >, | |
| 287 <A | |
| 288 HREF="sdlfreeyuvoverlay.html" | |
| 289 ><TT | |
| 290 CLASS="FUNCTION" | |
| 291 >SDL_FreeYUVOverlay</TT | |
| 292 ></A | |
| 293 ></P | |
| 294 ></DIV | |
| 295 ><DIV | |
| 296 CLASS="NAVFOOTER" | |
| 297 ><HR | |
| 298 ALIGN="LEFT" | |
| 299 WIDTH="100%"><TABLE | |
| 300 WIDTH="100%" | |
| 301 BORDER="0" | |
| 302 CELLPADDING="0" | |
| 303 CELLSPACING="0" | |
| 304 ><TR | |
| 305 ><TD | |
| 306 WIDTH="33%" | |
| 307 ALIGN="left" | |
| 308 VALIGN="top" | |
| 309 ><A | |
| 310 HREF="sdlvideoinfo.html" | |
| 311 >Prev</A | |
| 312 ></TD | |
| 313 ><TD | |
| 314 WIDTH="34%" | |
| 315 ALIGN="center" | |
| 316 VALIGN="top" | |
| 317 ><A | |
| 318 HREF="index.html" | |
| 319 >Home</A | |
| 320 ></TD | |
| 321 ><TD | |
| 322 WIDTH="33%" | |
| 323 ALIGN="right" | |
| 324 VALIGN="top" | |
| 325 ><A | |
| 326 HREF="wm.html" | |
| 327 >Next</A | |
| 328 ></TD | |
| 329 ></TR | |
| 330 ><TR | |
| 331 ><TD | |
| 332 WIDTH="33%" | |
| 333 ALIGN="left" | |
| 334 VALIGN="top" | |
| 335 >SDL_VideoInfo</TD | |
| 336 ><TD | |
| 337 WIDTH="34%" | |
| 338 ALIGN="center" | |
| 339 VALIGN="top" | |
| 340 ><A | |
| 341 HREF="video.html" | |
| 342 >Up</A | |
| 343 ></TD | |
| 344 ><TD | |
| 345 WIDTH="33%" | |
| 346 ALIGN="right" | |
| 347 VALIGN="top" | |
| 348 >Window Management</TD | |
| 349 ></TR | |
| 350 ></TABLE | |
| 351 ></DIV | |
| 352 ></BODY | |
| 353 ></HTML | |
| 354 > |