Mercurial > sdl-ios-xcode
annotate docs/html/sdlinit.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 | 55f1f1b3e27d |
| children | 355632dca928 |
| rev | line source |
|---|---|
| 0 | 1 <HTML |
| 2 ><HEAD | |
| 3 ><TITLE | |
| 4 >SDL_Init</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="General" | |
| 14 HREF="general.html"><LINK | |
| 15 REL="PREVIOUS" | |
| 16 TITLE="General" | |
| 17 HREF="general.html"><LINK | |
| 18 REL="NEXT" | |
| 19 TITLE="SDL_InitSubSystem" | |
| 20 HREF="sdlinitsubsystem.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="general.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="sdlinitsubsystem.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="SDLINIT" | |
| 71 >SDL_Init</A | |
| 72 ></H1 | |
| 73 ><DIV | |
| 74 CLASS="REFNAMEDIV" | |
| 75 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
76 NAME="AEN440" |
| 0 | 77 ></A |
| 78 ><H2 | |
| 79 >Name</H2 | |
| 80 >SDL_Init -- Initializes SDL</DIV | |
| 81 ><DIV | |
| 82 CLASS="REFSYNOPSISDIV" | |
| 83 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
84 NAME="AEN443" |
| 0 | 85 ></A |
| 86 ><H2 | |
| 87 >Synopsis</H2 | |
| 88 ><DIV | |
| 89 CLASS="FUNCSYNOPSIS" | |
| 90 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
91 NAME="AEN444" |
| 0 | 92 ></A |
| 93 ><P | |
| 94 ></P | |
| 95 ><PRE | |
| 96 CLASS="FUNCSYNOPSISINFO" | |
| 97 >#include "SDL.h"</PRE | |
| 98 ><P | |
| 99 ><CODE | |
| 100 ><CODE | |
| 101 CLASS="FUNCDEF" | |
| 102 >int <B | |
| 103 CLASS="FSFUNC" | |
| 104 >SDL_Init</B | |
| 105 ></CODE | |
| 106 >(Uint32 flags);</CODE | |
| 107 ></P | |
| 108 ><P | |
| 109 ></P | |
| 110 ></DIV | |
| 111 ></DIV | |
| 112 ><DIV | |
| 113 CLASS="REFSECT1" | |
| 114 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
115 NAME="AEN450" |
| 0 | 116 ></A |
| 117 ><H2 | |
| 118 >Description</H2 | |
| 119 ><P | |
| 120 >Initializes SDL. This should be called before all other SDL functions. The <TT | |
| 121 CLASS="PARAMETER" | |
| 122 ><I | |
| 123 >flags</I | |
| 124 ></TT | |
| 125 > parameter specifies what part(s) of SDL to initialize.</P | |
| 126 ><DIV | |
| 127 CLASS="INFORMALTABLE" | |
| 128 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
129 NAME="AEN454" |
| 0 | 130 ></A |
| 131 ><P | |
| 132 ></P | |
| 133 ><TABLE | |
| 134 BORDER="1" | |
| 135 CLASS="CALSTABLE" | |
| 136 ><TBODY | |
| 137 ><TR | |
| 138 ><TD | |
| 139 ALIGN="LEFT" | |
| 140 VALIGN="TOP" | |
| 141 ><TT | |
| 142 CLASS="LITERAL" | |
| 143 >SDL_INIT_TIMER</TT | |
| 144 ></TD | |
| 145 ><TD | |
| 146 ALIGN="LEFT" | |
| 147 VALIGN="TOP" | |
| 148 >Initializes the <A | |
| 149 HREF="time.html" | |
| 150 >timer</A | |
| 151 > subsystem.</TD | |
| 152 ></TR | |
| 153 ><TR | |
| 154 ><TD | |
| 155 ALIGN="LEFT" | |
| 156 VALIGN="TOP" | |
| 157 ><TT | |
| 158 CLASS="LITERAL" | |
| 159 >SDL_INIT_AUDIO</TT | |
| 160 ></TD | |
| 161 ><TD | |
| 162 ALIGN="LEFT" | |
| 163 VALIGN="TOP" | |
| 164 >Initializes the <A | |
| 165 HREF="audio.html" | |
| 166 >audio</A | |
| 167 > subsystem.</TD | |
| 168 ></TR | |
| 169 ><TR | |
| 170 ><TD | |
| 171 ALIGN="LEFT" | |
| 172 VALIGN="TOP" | |
| 173 ><TT | |
| 174 CLASS="LITERAL" | |
| 175 >SDL_INIT_VIDEO</TT | |
| 176 ></TD | |
| 177 ><TD | |
| 178 ALIGN="LEFT" | |
| 179 VALIGN="TOP" | |
| 180 >Initializes the <A | |
| 181 HREF="video.html" | |
| 182 >video</A | |
| 183 > subsystem.</TD | |
| 184 ></TR | |
| 185 ><TR | |
| 186 ><TD | |
| 187 ALIGN="LEFT" | |
| 188 VALIGN="TOP" | |
| 189 ><TT | |
| 190 CLASS="LITERAL" | |
| 191 >SDL_INIT_CDROM</TT | |
| 192 ></TD | |
| 193 ><TD | |
| 194 ALIGN="LEFT" | |
| 195 VALIGN="TOP" | |
| 196 >Initializes the <A | |
| 197 HREF="cdrom.html" | |
| 198 >cdrom</A | |
| 199 > subsystem.</TD | |
| 200 ></TR | |
| 201 ><TR | |
| 202 ><TD | |
| 203 ALIGN="LEFT" | |
| 204 VALIGN="TOP" | |
| 205 ><TT | |
| 206 CLASS="LITERAL" | |
| 207 >SDL_INIT_JOYSTICK</TT | |
| 208 ></TD | |
| 209 ><TD | |
| 210 ALIGN="LEFT" | |
| 211 VALIGN="TOP" | |
| 212 >Initializes the <A | |
| 213 HREF="joystick.html" | |
| 214 >joystick</A | |
| 215 > subsystem.</TD | |
| 216 ></TR | |
| 217 ><TR | |
| 218 ><TD | |
| 219 ALIGN="LEFT" | |
| 220 VALIGN="TOP" | |
| 221 ><TT | |
| 222 CLASS="LITERAL" | |
| 223 >SDL_INIT_EVERYTHING</TT | |
| 224 ></TD | |
| 225 ><TD | |
| 226 ALIGN="LEFT" | |
| 227 VALIGN="TOP" | |
| 228 >Initialize all of the above.</TD | |
| 229 ></TR | |
| 230 ><TR | |
| 231 ><TD | |
| 232 ALIGN="LEFT" | |
| 233 VALIGN="TOP" | |
| 234 ><TT | |
| 235 CLASS="LITERAL" | |
| 236 >SDL_INIT_NOPARACHUTE</TT | |
| 237 ></TD | |
| 238 ><TD | |
| 239 ALIGN="LEFT" | |
| 240 VALIGN="TOP" | |
| 241 >Prevents SDL from catching fatal signals.</TD | |
| 242 ></TR | |
| 243 ><TR | |
| 244 ><TD | |
| 245 ALIGN="LEFT" | |
| 246 VALIGN="TOP" | |
| 247 ><TT | |
| 248 CLASS="LITERAL" | |
| 249 >SDL_INIT_EVENTTHREAD</TT | |
| 250 ></TD | |
| 251 ><TD | |
| 252 ALIGN="LEFT" | |
| 253 VALIGN="TOP" | |
| 254 > </TD | |
| 255 ></TR | |
| 256 ></TBODY | |
| 257 ></TABLE | |
| 258 ><P | |
| 259 ></P | |
| 260 ></DIV | |
| 261 ></DIV | |
| 262 ><DIV | |
| 263 CLASS="REFSECT1" | |
| 264 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
265 NAME="AEN494" |
| 0 | 266 ></A |
| 267 ><H2 | |
| 268 >Return Value</H2 | |
| 269 ><P | |
| 270 >Returns <SPAN | |
| 271 CLASS="RETURNVALUE" | |
| 272 >-1</SPAN | |
| 273 > on an error or <SPAN | |
| 274 CLASS="RETURNVALUE" | |
| 275 >0</SPAN | |
| 276 > on success.</P | |
| 277 ></DIV | |
| 278 ><DIV | |
| 279 CLASS="REFSECT1" | |
| 280 ><A | |
|
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
281 NAME="AEN499" |
| 0 | 282 ></A |
| 283 ><H2 | |
| 284 >See Also</H2 | |
| 285 ><P | |
| 286 ><A | |
| 287 HREF="sdlquit.html" | |
| 288 ><TT | |
| 289 CLASS="FUNCTION" | |
| 290 >SDL_Quit</TT | |
| 291 ></A | |
| 292 >, | |
| 293 <A | |
| 294 HREF="sdlinitsubsystem.html" | |
| 295 ><TT | |
| 296 CLASS="FUNCTION" | |
| 297 >SDL_InitSubSystem</TT | |
| 298 ></A | |
| 299 ></P | |
| 300 ></DIV | |
| 301 ><DIV | |
| 302 CLASS="NAVFOOTER" | |
| 303 ><HR | |
| 304 ALIGN="LEFT" | |
| 305 WIDTH="100%"><TABLE | |
| 306 WIDTH="100%" | |
| 307 BORDER="0" | |
| 308 CELLPADDING="0" | |
| 309 CELLSPACING="0" | |
| 310 ><TR | |
| 311 ><TD | |
| 312 WIDTH="33%" | |
| 313 ALIGN="left" | |
| 314 VALIGN="top" | |
| 315 ><A | |
| 316 HREF="general.html" | |
| 317 >Prev</A | |
| 318 ></TD | |
| 319 ><TD | |
| 320 WIDTH="34%" | |
| 321 ALIGN="center" | |
| 322 VALIGN="top" | |
| 323 ><A | |
| 324 HREF="index.html" | |
| 325 >Home</A | |
| 326 ></TD | |
| 327 ><TD | |
| 328 WIDTH="33%" | |
| 329 ALIGN="right" | |
| 330 VALIGN="top" | |
| 331 ><A | |
| 332 HREF="sdlinitsubsystem.html" | |
| 333 >Next</A | |
| 334 ></TD | |
| 335 ></TR | |
| 336 ><TR | |
| 337 ><TD | |
| 338 WIDTH="33%" | |
| 339 ALIGN="left" | |
| 340 VALIGN="top" | |
| 341 >General</TD | |
| 342 ><TD | |
| 343 WIDTH="34%" | |
| 344 ALIGN="center" | |
| 345 VALIGN="top" | |
| 346 ><A | |
| 347 HREF="general.html" | |
| 348 >Up</A | |
| 349 ></TD | |
| 350 ><TD | |
| 351 WIDTH="33%" | |
| 352 ALIGN="right" | |
| 353 VALIGN="top" | |
| 354 >SDL_InitSubSystem</TD | |
| 355 ></TR | |
| 356 ></TABLE | |
| 357 ></DIV | |
| 358 ></BODY | |
| 359 ></HTML | |
| 360 > |