Home | History | Annotate | Download | only in html 
      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 >&nbsp;--&nbsp;Audio Specification Structure</DT
     94 ><DT
     95 ><A
     96 HREF="sdlopenaudio.html"
     97 >SDL_OpenAudio</A
     98 >&nbsp;--&nbsp;Opens the audio device with the desired parameters.</DT
     99 ><DT
    100 ><A
    101 HREF="sdlpauseaudio.html"
    102 >SDL_PauseAudio</A
    103 >&nbsp;--&nbsp;Pauses and unpauses the audio callback processing</DT
    104 ><DT
    105 ><A
    106 HREF="sdlgetaudiostatus.html"
    107 >SDL_GetAudioStatus</A
    108 >&nbsp;--&nbsp;Get the current audio state</DT
    109 ><DT
    110 ><A
    111 HREF="sdlloadwav.html"
    112 >SDL_LoadWAV</A
    113 >&nbsp;--&nbsp;Load a WAVE file</DT
    114 ><DT
    115 ><A
    116 HREF="sdlfreewav.html"
    117 >SDL_FreeWAV</A
    118 >&nbsp;--&nbsp;Frees previously opened WAV data</DT
    119 ><DT
    120 ><A
    121 HREF="sdlaudiocvt.html"
    122 >SDL_AudioCVT</A
    123 >&nbsp;--&nbsp;Audio Conversion Structure</DT
    124 ><DT
    125 ><A
    126 HREF="sdlbuildaudiocvt.html"
    127 >SDL_BuildAudioCVT</A
    128 >&nbsp;--&nbsp;Initializes a SDL_AudioCVT structure for conversion</DT
    129 ><DT
    130 ><A
    131 HREF="sdlconvertaudio.html"
    132 >SDL_ConvertAudio</A
    133 >&nbsp;--&nbsp;Convert audio data to a desired audio format.</DT
    134 ><DT
    135 ><A
    136 HREF="sdlmixaudio.html"
    137 >SDL_MixAudio</A
    138 >&nbsp;--&nbsp;Mix audio data</DT
    139 ><DT
    140 ><A
    141 HREF="sdllockaudio.html"
    142 >SDL_LockAudio</A
    143 >&nbsp;--&nbsp;Lock out the callback function</DT
    144 ><DT
    145 ><A
    146 HREF="sdlunlockaudio.html"
    147 >SDL_UnlockAudio</A
    148 >&nbsp;--&nbsp;Unlock the callback function</DT
    149 ><DT
    150 ><A
    151 HREF="sdlcloseaudio.html"
    152 >SDL_CloseAudio</A
    153 >&nbsp;--&nbsp;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 >