e14743d1 |
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 | > |