|
78
|
1 SDL_sound. An abstract soundfile decoder.
|
|
|
2
|
|
|
3 Check here, until I get to write more of this README:
|
|
232
|
4 http://icculus.org/SDL_sound/
|
|
78
|
5
|
|
239
|
6 SDL_sound _REQUIRES_ Simple Directmedia Layer (SDL) to function, and cannot
|
|
|
7 be built without it. You can get SDL from http://www.libsdl.org/. SDL_sound
|
|
|
8 has only been tried with the SDL 1.2 series, but may work on older versions.
|
|
|
9 Reports of success or failure are welcome.
|
|
|
10
|
|
232
|
11 Some optional external libraries that SDL_sound can use and where to find them:
|
|
239
|
12 SMPEG (used to decode MP3s): http://www.lokigames.com/development/smpeg.php3
|
|
|
13 libvorbis (used to decode OGGs): http://www.xiph.org/ogg/vorbis/
|
|
|
14 libFLAC (used to decode FLACs): http://flac.sourceforge.net/
|
|
|
15 libModPlug (used to decode MODs, etc): http://modplug-xmms.sourceforge.net/
|
|
|
16 libMikMod (used to decode MODs, etc, too): http://www.mikmod.org/
|
|
232
|
17
|
|
|
18 These external libraries are OPTIONAL. SDL_sound will build and function
|
|
|
19 without them, but various sound file formats are not supported unless these
|
|
|
20 libraries are available. Unless explicitly disabled during initial build
|
|
239
|
21 configuration, SDL_sound always supports these file formats internally:
|
|
232
|
22
|
|
239
|
23 - Microsoft .WAV files (uncompressed and MS-ADPCM encoded).
|
|
|
24 - Creative Labs .VOC files
|
|
|
25 - Shorten (.SHN) files
|
|
|
26 - Audio Interchange format (AIFF) files
|
|
|
27 - Sun Audio (.AU) files
|
|
|
28 - MIDI files
|
|
|
29 - Raw waveform data
|
|
232
|
30
|
|
|
31
|
|
|
32 Building/Installing:
|
|
78
|
33
|
|
248
|
34 MacOS X users:
|
|
|
35 If you want to use the command line tools, read the next section. If you
|
|
|
36 prefer to use PowerBuilder, download this file:
|
|
|
37 http://icculus.org/SDL_sound/downloads/PBProjects.tar.gz
|
|
|
38 ...and extract it into your SDL_sound directory. The PowerBuilder project
|
|
|
39 files include several of the external libraries, whereas you will have to
|
|
|
40 find and install those libraries yourself with the command line tools.
|
|
|
41
|
|
|
42 MacOS 9 users:
|
|
|
43 Included with the source is CWProject.sit, which contains project files for
|
|
|
44 CodeWarrior 5.0 and later.
|
|
|
45
|
|
|
46 Linux, Unix, BeOS, MacOS X command line, BSD users:
|
|
228
|
47 If you pulled from CVS, run "./bootstrap" first.
|
|
|
48 Then, run ./configure with your favorite options, "make", "make install".
|
|
78
|
49
|
|
128
|
50 Win32 users:
|
|
|
51 Download http://icculus.org/SDL_sound/downloads/SDL_sound_win32.zip and
|
|
|
52 unzip it in the root of the source tree (the directory with SDL_sound.c,
|
|
|
53 etc). This will give you Visual C++ project files and some other needed
|
|
|
54 code.
|
|
|
55
|
|
228
|
56 There will be a shared library and a binary called "playsound".
|
|
|
57
|
|
78
|
58
|
|
232
|
59 Reporting bugs/commenting:
|
|
|
60 There is a mailing list available. To subscribe, send a blank email to
|
|
|
61 sdlsound-subscribe@icculus.org. This is the best way to get in touch with
|
|
|
62 SDL_sound developers.
|
|
|
63
|
