slouken@618
|
1 |
|
slouken@619
|
2 |
SDL_mixer 2.0
|
slouken@618
|
3 |
|
slouken@618
|
4 |
The latest version of this library is available from:
|
slouken@618
|
5 |
http://www.libsdl.org/projects/SDL_mixer/
|
slouken@618
|
6 |
|
slouken@618
|
7 |
Due to popular demand, here is a simple multi-channel audio mixer.
|
slouken@618
|
8 |
It supports 8 channels of 16 bit stereo audio, plus a single channel
|
slouken@618
|
9 |
of music, mixed by the popular MikMod MOD, Timidity MIDI and SMPEG MP3
|
slouken@618
|
10 |
libraries.
|
slouken@618
|
11 |
|
slouken@618
|
12 |
See the header file SDL_mixer.h and the examples playwave.c and playmus.c
|
slouken@618
|
13 |
for documentation on this mixer library.
|
slouken@618
|
14 |
|
slouken@618
|
15 |
The mixer can currently load Microsoft WAVE files and Creative Labs VOC
|
slouken@618
|
16 |
files as audio samples, and can load MIDI files via Timidity and the
|
slouken@618
|
17 |
following music formats via MikMod: .MOD .S3M .IT .XM. It can load
|
slouken@618
|
18 |
Ogg Vorbis streams as music if built with Ogg Vorbis or Tremor libraries,
|
slouken@618
|
19 |
and finally it can load MP3 music using the SMPEG or libmad libraries.
|
slouken@618
|
20 |
|
slouken@618
|
21 |
Tremor decoding is disabled by default; you can enable it by passing
|
slouken@618
|
22 |
--enable-music-ogg-tremor
|
slouken@618
|
23 |
to configure, or by defining OGG_MUSIC and OGG_USE_TREMOR.
|
slouken@618
|
24 |
|
slouken@618
|
25 |
libmad decoding is disabled by default; you can enable it by passing
|
slouken@618
|
26 |
--enable-music-mp3-mad
|
slouken@618
|
27 |
to configure, or by defining MP3_MAD_MUSIC
|
slouken@618
|
28 |
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
slouken@618
|
29 |
WARNING: The license for libmad is GPL, which means that in order to
|
slouken@618
|
30 |
use it your application must also be GPL!
|
slouken@618
|
31 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
slouken@618
|
32 |
|
slouken@618
|
33 |
The process of mixing MIDI files to wave output is very CPU intensive,
|
slouken@618
|
34 |
so if playing regular WAVE files sound great, but playing MIDI files
|
slouken@618
|
35 |
sound choppy, try using 8-bit audio, mono audio, or lower frequencies.
|
slouken@618
|
36 |
|
slouken@618
|
37 |
To play MIDI files, you'll need to get a complete set of GUS patches
|
slouken@618
|
38 |
from:
|
slouken@618
|
39 |
http://www.libsdl.org/projects/mixer/timidity/timidity.tar.gz
|
slouken@618
|
40 |
and unpack them in /usr/local/lib under UNIX, and C:\ under Win32.
|
slouken@618
|
41 |
|
slouken@618
|
42 |
This library is under the zlib license, see the file "COPYING" for details.
|
slouken@618
|
43 |
|