Mercurial > sdl-ios-xcode
annotate docs/html/sdlpauseaudio.html @ 968:4675910b0b7b
Date: Mon, 11 Oct 2004 15:17:27 +0300 (EEST)
From: Hannu Savolainen
Subject: Re: SDL uses obsolete OSS features
I did some work on getting OSS to work better with SDL. There have been
some problems with select which should be fixed now.
I'm having some problems in understanding what is the purpose of the
DSP_WaitAudio() routine. I added a return to the very beginning of this
routine and commendted out the define for USE_BLOCKING_WRITES. At least
lbreakout2 seems to work as well as earlier. The latencies are the same.
An ordinary blocking write does exactly the same thing than DSP_WaitAudio
does. So I would recommend using the USE_BLOCKING_WRITES approach and
removing everything from the DSP_WaitAudio routine. Also enabling
USE_BLOCKING_WRITES makes it possible to simplify DSP_PlayAudio() because
you don't need to handle the partial writes (the do-while loop).
Attached is a patch against SDL-1.2.7. After these changes SDL will use
OSS as it's designed to be used (make it as simple as possible). This code
should work with all OSS implementations because it uses only the very
fundamental features that have been there since the jurassic times.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Fri, 12 Nov 2004 21:39:04 +0000 |
parents | 355632dca928 |
children |
rev | line source |
---|---|
0 | 1 <HTML |
2 ><HEAD | |
3 ><TITLE | |
4 >SDL_PauseAudio</TITLE | |
5 ><META | |
6 NAME="GENERATOR" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
0 | 8 "><LINK |
9 REL="HOME" | |
10 TITLE="SDL Library Documentation" | |
11 HREF="index.html"><LINK | |
12 REL="UP" | |
13 TITLE="Audio" | |
14 HREF="audio.html"><LINK | |
15 REL="PREVIOUS" | |
16 TITLE="SDL_OpenAudio" | |
17 HREF="sdlopenaudio.html"><LINK | |
18 REL="NEXT" | |
19 TITLE="SDL_GetAudioStatus" | |
20 HREF="sdlgetaudiostatus.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 | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
31 SUMMARY="Header navigation table" |
0 | 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="sdlopenaudio.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
49 ACCESSKEY="P" |
0 | 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="sdlgetaudiostatus.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
63 ACCESSKEY="N" |
0 | 64 >Next</A |
65 ></TD | |
66 ></TR | |
67 ></TABLE | |
68 ><HR | |
69 ALIGN="LEFT" | |
70 WIDTH="100%"></DIV | |
71 ><H1 | |
72 ><A | |
73 NAME="SDLPAUSEAUDIO" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
74 ></A |
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
75 >SDL_PauseAudio</H1 |
0 | 76 ><DIV |
77 CLASS="REFNAMEDIV" | |
78 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
79 NAME="AEN6765" |
0 | 80 ></A |
81 ><H2 | |
82 >Name</H2 | |
83 >SDL_PauseAudio -- Pauses and unpauses the audio callback processing</DIV | |
84 ><DIV | |
85 CLASS="REFSYNOPSISDIV" | |
86 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
87 NAME="AEN6768" |
0 | 88 ></A |
89 ><H2 | |
90 >Synopsis</H2 | |
91 ><DIV | |
92 CLASS="FUNCSYNOPSIS" | |
93 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
94 NAME="AEN6769" |
0 | 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 >void <B | |
106 CLASS="FSFUNC" | |
107 >SDL_PauseAudio</B | |
108 ></CODE | |
109 >(int pause_on);</CODE | |
110 ></P | |
111 ><P | |
112 ></P | |
113 ></DIV | |
114 ></DIV | |
115 ><DIV | |
116 CLASS="REFSECT1" | |
117 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
118 NAME="AEN6775" |
0 | 119 ></A |
120 ><H2 | |
121 >Description</H2 | |
122 ><P | |
123 >This function pauses and unpauses the audio callback processing. | |
124 It should be called with <TT | |
125 CLASS="PARAMETER" | |
126 ><I | |
127 >pause_on</I | |
128 ></TT | |
129 >=0 after opening the audio | |
130 device to start playing sound. This is so you can safely initialize | |
131 data for your callback function after opening the audio device. | |
132 Silence will be written to the audio device during the pause.</P | |
133 ></DIV | |
134 ><DIV | |
135 CLASS="REFSECT1" | |
136 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
137 NAME="AEN6779" |
0 | 138 ></A |
139 ><H2 | |
140 >See Also</H2 | |
141 ><P | |
142 ><A | |
143 HREF="sdlgetaudiostatus.html" | |
144 ><TT | |
145 CLASS="FUNCTION" | |
146 >SDL_GetAudioStatus</TT | |
147 ></A | |
148 >, | |
149 <A | |
150 HREF="sdlopenaudio.html" | |
151 ><TT | |
152 CLASS="FUNCTION" | |
153 >SDL_OpenAudio</TT | |
154 ></A | |
155 ></P | |
156 ></DIV | |
157 ><DIV | |
158 CLASS="NAVFOOTER" | |
159 ><HR | |
160 ALIGN="LEFT" | |
161 WIDTH="100%"><TABLE | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
162 SUMMARY="Footer navigation table" |
0 | 163 WIDTH="100%" |
164 BORDER="0" | |
165 CELLPADDING="0" | |
166 CELLSPACING="0" | |
167 ><TR | |
168 ><TD | |
169 WIDTH="33%" | |
170 ALIGN="left" | |
171 VALIGN="top" | |
172 ><A | |
173 HREF="sdlopenaudio.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
174 ACCESSKEY="P" |
0 | 175 >Prev</A |
176 ></TD | |
177 ><TD | |
178 WIDTH="34%" | |
179 ALIGN="center" | |
180 VALIGN="top" | |
181 ><A | |
182 HREF="index.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
183 ACCESSKEY="H" |
0 | 184 >Home</A |
185 ></TD | |
186 ><TD | |
187 WIDTH="33%" | |
188 ALIGN="right" | |
189 VALIGN="top" | |
190 ><A | |
191 HREF="sdlgetaudiostatus.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
192 ACCESSKEY="N" |
0 | 193 >Next</A |
194 ></TD | |
195 ></TR | |
196 ><TR | |
197 ><TD | |
198 WIDTH="33%" | |
199 ALIGN="left" | |
200 VALIGN="top" | |
201 >SDL_OpenAudio</TD | |
202 ><TD | |
203 WIDTH="34%" | |
204 ALIGN="center" | |
205 VALIGN="top" | |
206 ><A | |
207 HREF="audio.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
208 ACCESSKEY="U" |
0 | 209 >Up</A |
210 ></TD | |
211 ><TD | |
212 WIDTH="33%" | |
213 ALIGN="right" | |
214 VALIGN="top" | |
215 >SDL_GetAudioStatus</TD | |
216 ></TR | |
217 ></TABLE | |
218 ></DIV | |
219 ></BODY | |
220 ></HTML | |
221 > |