docs/html/audio.html
changeset 3352 6dc250ebdd80
parent 3351 8e0182c236d8
child 3353 6b14223dd5c7
equal deleted inserted replaced
3351:8e0182c236d8 3352:6dc250ebdd80
     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 >