|
1 <HTML |
|
2 ><HEAD |
|
3 ><TITLE |
|
4 >Audio</TITLE |
|
5 ><META |
|
6 NAME="GENERATOR" |
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
|
8 "><LINK |
|
9 REL="HOME" |
|
10 TITLE="SDL Library Documentation" |
|
11 HREF="index.html"><LINK |
|
12 REL="UP" |
|
13 TITLE="SDL Reference" |
|
14 HREF="reference.html"><LINK |
|
15 REL="PREVIOUS" |
|
16 TITLE="SDL_JoystickClose" |
|
17 HREF="sdljoystickclose.html"><LINK |
|
18 REL="NEXT" |
|
19 TITLE="SDL_AudioSpec" |
|
20 HREF="sdlaudiospec.html"><META |
|
21 NAME="KEYWORD" |
|
22 CONTENT="audio"><META |
|
23 NAME="KEYWORD" |
|
24 CONTENT="function"></HEAD |
|
25 ><BODY |
|
26 CLASS="CHAPTER" |
|
27 BGCOLOR="#FFF8DC" |
|
28 TEXT="#000000" |
|
29 LINK="#0000ee" |
|
30 VLINK="#551a8b" |
|
31 ALINK="#ff0000" |
|
32 ><DIV |
|
33 CLASS="NAVHEADER" |
|
34 ><TABLE |
|
35 SUMMARY="Header navigation table" |
|
36 WIDTH="100%" |
|
37 BORDER="0" |
|
38 CELLPADDING="0" |
|
39 CELLSPACING="0" |
|
40 ><TR |
|
41 ><TH |
|
42 COLSPAN="3" |
|
43 ALIGN="center" |
|
44 >SDL Library Documentation</TH |
|
45 ></TR |
|
46 ><TR |
|
47 ><TD |
|
48 WIDTH="10%" |
|
49 ALIGN="left" |
|
50 VALIGN="bottom" |
|
51 ><A |
|
52 HREF="sdljoystickclose.html" |
|
53 ACCESSKEY="P" |
|
54 >Prev</A |
|
55 ></TD |
|
56 ><TD |
|
57 WIDTH="80%" |
|
58 ALIGN="center" |
|
59 VALIGN="bottom" |
|
60 ></TD |
|
61 ><TD |
|
62 WIDTH="10%" |
|
63 ALIGN="right" |
|
64 VALIGN="bottom" |
|
65 ><A |
|
66 HREF="sdlaudiospec.html" |
|
67 ACCESSKEY="N" |
|
68 >Next</A |
|
69 ></TD |
|
70 ></TR |
|
71 ></TABLE |
|
72 ><HR |
|
73 ALIGN="LEFT" |
|
74 WIDTH="100%"></DIV |
|
75 ><DIV |
|
76 CLASS="CHAPTER" |
|
77 ><H1 |
|
78 ><A |
|
79 NAME="AUDIO" |
|
80 ></A |
|
81 >Chapter 10. Audio</H1 |
|
82 ><DIV |
|
83 CLASS="TOC" |
|
84 ><DL |
|
85 ><DT |
|
86 ><B |
|
87 >Table of Contents</B |
|
88 ></DT |
|
89 ><DT |
|
90 ><A |
|
91 HREF="sdlaudiospec.html" |
|
92 >SDL_AudioSpec</A |
|
93 > -- Audio Specification Structure</DT |
|
94 ><DT |
|
95 ><A |
|
96 HREF="sdlopenaudio.html" |
|
97 >SDL_OpenAudio</A |
|
98 > -- Opens the audio device with the desired parameters.</DT |
|
99 ><DT |
|
100 ><A |
|
101 HREF="sdlpauseaudio.html" |
|
102 >SDL_PauseAudio</A |
|
103 > -- Pauses and unpauses the audio callback processing</DT |
|
104 ><DT |
|
105 ><A |
|
106 HREF="sdlgetaudiostatus.html" |
|
107 >SDL_GetAudioStatus</A |
|
108 > -- Get the current audio state</DT |
|
109 ><DT |
|
110 ><A |
|
111 HREF="sdlloadwav.html" |
|
112 >SDL_LoadWAV</A |
|
113 > -- Load a WAVE file</DT |
|
114 ><DT |
|
115 ><A |
|
116 HREF="sdlfreewav.html" |
|
117 >SDL_FreeWAV</A |
|
118 > -- Frees previously opened WAV data</DT |
|
119 ><DT |
|
120 ><A |
|
121 HREF="sdlaudiocvt.html" |
|
122 >SDL_AudioCVT</A |
|
123 > -- Audio Conversion Structure</DT |
|
124 ><DT |
|
125 ><A |
|
126 HREF="sdlbuildaudiocvt.html" |
|
127 >SDL_BuildAudioCVT</A |
|
128 > -- Initializes a SDL_AudioCVT structure for conversion</DT |
|
129 ><DT |
|
130 ><A |
|
131 HREF="sdlconvertaudio.html" |
|
132 >SDL_ConvertAudio</A |
|
133 > -- Convert audio data to a desired audio format.</DT |
|
134 ><DT |
|
135 ><A |
|
136 HREF="sdlmixaudio.html" |
|
137 >SDL_MixAudio</A |
|
138 > -- Mix audio data</DT |
|
139 ><DT |
|
140 ><A |
|
141 HREF="sdllockaudio.html" |
|
142 >SDL_LockAudio</A |
|
143 > -- Lock out the callback function</DT |
|
144 ><DT |
|
145 ><A |
|
146 HREF="sdlunlockaudio.html" |
|
147 >SDL_UnlockAudio</A |
|
148 > -- Unlock the callback function</DT |
|
149 ><DT |
|
150 ><A |
|
151 HREF="sdlcloseaudio.html" |
|
152 >SDL_CloseAudio</A |
|
153 > -- Shuts down audio processing and closes the audio device.</DT |
|
154 ></DL |
|
155 ></DIV |
|
156 ><P |
|
157 >Sound on the computer is translated from waves that you hear into a series of |
|
158 values, or samples, each representing the amplitude of the wave. When these |
|
159 samples are sent in a stream to a sound card, an approximation of the original |
|
160 wave can be recreated. The more bits used to represent the amplitude, and the |
|
161 greater frequency these samples are gathered, the closer the approximated |
|
162 sound is to the original, and the better the quality of sound.</P |
|
163 ><P |
|
164 >This library supports both 8 and 16 bit signed and unsigned sound samples, |
|
165 at frequencies ranging from 11025 Hz to 44100 Hz, depending on the |
|
166 underlying hardware. If the hardware doesn't support the desired audio |
|
167 format or frequency, it can be emulated if desired (See |
|
168 <A |
|
169 HREF="sdlopenaudio.html" |
|
170 ><TT |
|
171 CLASS="FUNCTION" |
|
172 >SDL_OpenAudio()</TT |
|
173 ></A |
|
174 >)</P |
|
175 ><P |
|
176 >A commonly supported audio format is 16 bits per sample at 22050 Hz.</P |
|
177 ></DIV |
|
178 ><DIV |
|
179 CLASS="NAVFOOTER" |
|
180 ><HR |
|
181 ALIGN="LEFT" |
|
182 WIDTH="100%"><TABLE |
|
183 SUMMARY="Footer navigation table" |
|
184 WIDTH="100%" |
|
185 BORDER="0" |
|
186 CELLPADDING="0" |
|
187 CELLSPACING="0" |
|
188 ><TR |
|
189 ><TD |
|
190 WIDTH="33%" |
|
191 ALIGN="left" |
|
192 VALIGN="top" |
|
193 ><A |
|
194 HREF="sdljoystickclose.html" |
|
195 ACCESSKEY="P" |
|
196 >Prev</A |
|
197 ></TD |
|
198 ><TD |
|
199 WIDTH="34%" |
|
200 ALIGN="center" |
|
201 VALIGN="top" |
|
202 ><A |
|
203 HREF="index.html" |
|
204 ACCESSKEY="H" |
|
205 >Home</A |
|
206 ></TD |
|
207 ><TD |
|
208 WIDTH="33%" |
|
209 ALIGN="right" |
|
210 VALIGN="top" |
|
211 ><A |
|
212 HREF="sdlaudiospec.html" |
|
213 ACCESSKEY="N" |
|
214 >Next</A |
|
215 ></TD |
|
216 ></TR |
|
217 ><TR |
|
218 ><TD |
|
219 WIDTH="33%" |
|
220 ALIGN="left" |
|
221 VALIGN="top" |
|
222 >SDL_JoystickClose</TD |
|
223 ><TD |
|
224 WIDTH="34%" |
|
225 ALIGN="center" |
|
226 VALIGN="top" |
|
227 ><A |
|
228 HREF="reference.html" |
|
229 ACCESSKEY="U" |
|
230 >Up</A |
|
231 ></TD |
|
232 ><TD |
|
233 WIDTH="33%" |
|
234 ALIGN="right" |
|
235 VALIGN="top" |
|
236 >SDL_AudioSpec</TD |
|
237 ></TR |
|
238 ></TABLE |
|
239 ></DIV |
|
240 ></BODY |
|
241 ></HTML |
|
242 > |