Mercurial > sdl-ios-xcode
annotate docs/html/sdlinit.html @ 773:da0a2ad35bf4
Date: Sun, 4 Jan 2004 23:48:19 +0100
From: Max Horn
Subject: Re: Again Audio CD patch
Am 04.01.2004 um 22:38 schrieb Sam Lantinga:
>
> Okay, I fixed the buffering problems by simply using a 4 second buffer
> instead of a 1 second buffer. However, using your code I can't play an
> entire CD - the playback stops after the first song.
>
Found the problem: FSReadFork returns eofErr when the file is finished.
However, we check its return value for errors, and if anything but
noErr occurs, the reader thread aborts its current iteration. That is
bad, because it aborts before it can ever set the flag which tells that
the file is over (also, any remaining data which FSRead did return is
lost - so you'd not hear about to 4 seconds from the end of the file.
Furthermore, the computed data size was 8 bytes to high (I forgot to
account for the fact that the size of an (A)IFF chunk always contains
the chunk header & size fields, too). This is enough to make it work.
However, the end condition is rather fragile, so I tuned some other
things to be pessimistic (check for <= 0 instead of == 0, when eofErr
is encountered enforce mReadFilePosition == mFileLength). You never
know...
The attached patch fixes the issue for me.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Mon, 05 Jan 2004 00:57:51 +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 > |