README.txt
author Ozkan Sezer <sezeroz@gmail.com>
Wed, 03 Oct 2018 21:55:00 +0300
changeset 863 b81eb791d10d
parent 819 17ddbf810d08
child 901 253f50984a9a
permissions -rw-r--r--
readmidi.c (groom_list): avoid integer overflow when recomputing time.

from libtimidity -- see:
https://sourceforge.net/p/libtimidity/libtimidity/ci/11be98a89eac229111420e6a3d521edbfddb0dbc/
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@801
     9
of music.
slouken@618
    10
slouken@618
    11
See the header file SDL_mixer.h and the examples playwave.c and playmus.c
slouken@618
    12
for documentation on this mixer library.
slouken@618
    13
slouken@618
    14
The mixer can currently load Microsoft WAVE files and Creative Labs VOC
slouken@801
    15
files as audio samples, it can load FLAC files with libFLAC, it can load
slouken@801
    16
Ogg Vorbis files with Ogg Vorbis or Tremor libraries, it can load MP3 files
slouken@801
    17
using mpg123, SMPEG or libmad, and it can load MIDI files with Timidity,
slouken@801
    18
FluidSynth, and natively on Windows, Mac OSX, and Linux, and finally it can
slouken@801
    19
load the following file formats via ModPlug or MikMod: .MOD .S3M .IT .XM.
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@777
    23
to configure, or by defining MUSIC_OGG 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@777
    27
to configure, or by defining MUSIC_MP3_MAD
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@801
    37
To play MIDI files using FluidSynth, you'll need to set the SDL_SOUNDFONTS
slouken@801
    38
environment variable to a Sound Font 2 (.sf2) file containing the musical
slouken@801
    39
instruments you want to use for MIDI playback.
slouken@801
    40
(On some Linux distributions you can install the fluid-soundfont-gm package)
slouken@801
    41
slouken@801
    42
To play MIDI files using Timidity, you'll need to get a complete set of
slouken@801
    43
GUS patches from:
slouken@618
    44
http://www.libsdl.org/projects/mixer/timidity/timidity.tar.gz
slouken@618
    45
and unpack them in /usr/local/lib under UNIX, and C:\ under Win32.
slouken@618
    46
slouken@819
    47
iOS:
slouken@819
    48
In order to use this library on iOS, you should include the SDL.xcodeproj
slouken@819
    49
and Xcode-iOS/SDL_mixer.xcodeproj in your application, add the SDL/include
slouken@819
    50
and SDL_mixer directories to your "Header Search Paths" setting, then add the
slouken@819
    51
libSDL2.a and libSDL2_mixer.a to your "Link Binary with Libraries" setting.
slouken@819
    52
slouken@646
    53
This library is under the zlib license, see the file "COPYING.txt" for details.
slouken@618
    54