mirror of
https://git.do.srb2.org/STJr/SRB2.git
synced 2024-11-24 13:21:20 +00:00
249 lines
8.6 KiB
Text
249 lines
8.6 KiB
Text
|
SDL Mixer X (aka SDL Mixer 2.0 Modded or SDL_mixer_ext),
|
||
|
|
by Vitaly Novichkov <Wohlstand>,
|
||
|
|
forked from SDL Mixer 2.0 by Sam Lantinga <slouken@libsdl.org>
|
||
|
|
|
||
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
||
|
|
WARNING: The licenses for libmad, ADLMIDI, OPNMIDI, and GME is GPL,
|
||
|
|
which means that in order to use it your application must
|
||
|
|
also be GPL!
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
|
||
|
|
The latest original version of this library is available from:
|
||
|
|
http://www.libsdl.org/projects/SDL_mixer/
|
||
|
|
|
||
|
|
Sources of modified library version is available in the PGE Project's sources:
|
||
|
|
https://github.com/Wohlhabend-Networks/PGE-Project/
|
||
|
|
in the folder: _Libs/SDL2_mixer_modified/
|
||
|
|
or:
|
||
|
|
https://bitbucket.org/Wohlstand/pge-project
|
||
|
|
in the folder: _Libs/SDL2_mixer_modified/
|
||
|
|
|
||
|
|
=============================================================================
|
||
|
|
Difference between original and this library:
|
||
|
|
-----------------------------------------------------------------------------
|
||
|
|
+ Added new codecs:
|
||
|
|
- Game Music Emulators (LGPL v2.1) which adds support of chip tunes
|
||
|
|
like NSF, VGM, SPC, HES, etc.
|
||
|
|
- libADLMIDI (GPL v3, LGPL v3) (remake from ADLMIDI) to play MIDI with
|
||
|
|
emulated OPL3 synthesiser, also supports loop points
|
||
|
|
"loopStart" and "loopEnd"
|
||
|
|
- libOPNMIDI (GPL v3, LGPL v3) to play MIDI with
|
||
|
|
emulated OPN2 synthesiser, also supports loop points
|
||
|
|
"loopStart" and "loopEnd"
|
||
|
|
+ Added some new functions
|
||
|
|
+ Added support of loop points for OGG files (via "LOOPSTART" and "LOOPEND"
|
||
|
|
(or "LOOPLENGTH" to be compatible with RPG Maker) vorbis comments)
|
||
|
|
+ Reorganized music codecs processing system
|
||
|
|
+ Added support to get current position and track lenght for a seekable codecs
|
||
|
|
|
||
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
||
|
|
IMPORTANT: To choice a track number of NSF, GBM, HES, etc file,
|
||
|
|
you must append "|xxx" to end of file path for
|
||
|
|
Mix_LoadMUS function.
|
||
|
|
Where xxx - actual number of chip track, (from 0 to N-1)
|
||
|
|
Examples: "file.nsf|12", "file.hes|2"
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
||
|
|
Arguments are passing like argument for a GME-based files (NSF, HES, etc.):
|
||
|
|
Syntax for MIDI is:
|
||
|
|
myfile.mid|xyy;xyy;xyy;...;
|
||
|
|
where x - parameter type
|
||
|
|
where y - value (every value must be ended with semicolon!)
|
||
|
|
|
||
|
|
available parameters:
|
||
|
|
s - use a specific synthesiser
|
||
|
|
0 - ADLMIDI
|
||
|
|
1 - Native MIDI [Win32/OSX/Haiku only]
|
||
|
|
2 - Timidity
|
||
|
|
3 - Fluidsynth
|
||
|
|
b - value from 0 to 66 - number of ADLMIDI bank
|
||
|
|
t - (0 or 1) enable deep tremolo on ADLMIDI
|
||
|
|
v - (0 or 1) enable deep vibrato on ADLMIDI
|
||
|
|
m - (0 or 1) enable scalable modulation on ADLMIDI
|
||
|
|
a - (0 or 1) enable AdLib mode of percussion on ADLMIDI
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
=============================================================================
|
||
|
|
Added music codecs:
|
||
|
|
-----------------------------------------------------------------------------
|
||
|
|
General:
|
||
|
|
- MUS_GME - Game Music Emulatirs
|
||
|
|
|
||
|
|
MIDI Playing:
|
||
|
|
- ADLMIDI - A software synthesizer is based on Yamaha OPL3 (YMF262) chip emulator
|
||
|
|
- OPNMIDI - A software synthesizer is based on Yamaha OPL3 (YM2612) chip emulator
|
||
|
|
|
||
|
|
=============================================================================
|
||
|
|
Added functions:
|
||
|
|
-----------------------------------------------------------------------------
|
||
|
|
/*
|
||
|
|
Allows you to set up custom path for Timidify patches
|
||
|
|
*/
|
||
|
|
void MIX_Timidity_addToPathList(const char *path);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get music title from meta-tag if possible. If title tag is empty, filename will be returned
|
||
|
|
*/
|
||
|
|
const char* Mix_GetMusicTitle(const Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get music title from meta-tag if possible
|
||
|
|
*/
|
||
|
|
const char* Mix_GetMusicTitleTag(const Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get music artist from meta-tag if possible
|
||
|
|
*/
|
||
|
|
const char* Mix_GetMusicArtistTag(const Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get music album from meta-tag if possible
|
||
|
|
*/
|
||
|
|
const char* Mix_GetMusicAlbumTag(const Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get music copyright from meta-tag if possible
|
||
|
|
*/
|
||
|
|
const char* Mix_GetMusicCopyrightTag(const Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Load music from memory with passing of extra arguments
|
||
|
|
*/
|
||
|
|
Mix_Music * SDLCALLCC Mix_LoadMUS_RW_ARG(SDL_RWops *src, int freesrc, char *args)
|
||
|
|
|
||
|
|
/*
|
||
|
|
Load music from memory with passing NSF/HES/etc. track number (accepts integer unlike SDLCALLCC Mix_LoadMUS_RW_ARG)
|
||
|
|
*/
|
||
|
|
Mix_Music * SDLCALLCC Mix_LoadMUS_RW_GME(SDL_RWops *src, int freesrc, int trackID)
|
||
|
|
|
||
|
|
typedef enum
|
||
|
|
{
|
||
|
|
MIDI_ADLMIDI,
|
||
|
|
MIDI_Native,
|
||
|
|
MIDI_Timidity,
|
||
|
|
MIDI_OPNMIDI,
|
||
|
|
MIDI_Fluidsynth,
|
||
|
|
MIDI_KnuwnDevices /* Count of MIDI device types */
|
||
|
|
} Mix_MIDI_Device;
|
||
|
|
|
||
|
|
/*
|
||
|
|
Allows you to toggle MIDI Devices!
|
||
|
|
(change will be applied on re-opening of MIDI file)
|
||
|
|
Attempt to toggle unsupported MIDI device takes no effect
|
||
|
|
(for case when library built without linking of required library)
|
||
|
|
*/
|
||
|
|
int Mix_SetMidiDevice(int device);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Returns current ADLMIDI bank number
|
||
|
|
*/
|
||
|
|
int MIX_ADLMIDI_getBankID();
|
||
|
|
|
||
|
|
/*
|
||
|
|
Changes ADLMIDI bank number (changes applying on MIDI file reopen)
|
||
|
|
*/
|
||
|
|
void MIX_ADLMIDI_setBankID(int bnk);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Returns current state of ADLMIDI deep tremolo flag
|
||
|
|
*/
|
||
|
|
int MIX_ADLMIDI_getTremolo();
|
||
|
|
|
||
|
|
/*
|
||
|
|
Changes ADLMIDI deep tremolo flag (changes applying on MIDI file reopen)
|
||
|
|
*/
|
||
|
|
void MIX_ADLMIDI_setTremolo(int tr);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Returns current state of ADLMIDI deep vibrato flag
|
||
|
|
*/
|
||
|
|
int MIX_ADLMIDI_getVibrato();
|
||
|
|
|
||
|
|
/*
|
||
|
|
Changes ADLMIDI deep vibrato flag (changes applying on MIDI file reopen)
|
||
|
|
*/
|
||
|
|
void MIX_ADLMIDI_setVibrato(int vib);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Returns current state of ADLMIDI deep scaling modulation flag
|
||
|
|
*/
|
||
|
|
int MIX_ADLMIDI_getScaleMod();
|
||
|
|
|
||
|
|
/*
|
||
|
|
Changes ADLMIDI scaling modulation flag (changes applying on MIDI file reopen)
|
||
|
|
*/
|
||
|
|
void MIX_ADLMIDI_setScaleMod(int sc);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Resets ADLMIDI flags and settings to default state
|
||
|
|
*/
|
||
|
|
void MIX_ADLMIDI_setSetDefaults();
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get the time current position of music stream
|
||
|
|
returns -1.0 if this feature is not supported for some codec
|
||
|
|
*/
|
||
|
|
double Mix_GetMusicPosition(Mix_Music *music);
|
||
|
|
/*
|
||
|
|
Get the total time length of music stream
|
||
|
|
returns -1.0 if this feature is not supported for some codec
|
||
|
|
*/
|
||
|
|
double Mix_GetMusicTotalTime(Mix_Music *music);
|
||
|
|
|
||
|
|
/*
|
||
|
|
Get the loop start time position of music stream
|
||
|
|
returns -1.0 if this feature is not used for this music or not supported for some codec
|
||
|
|
*/
|
||
|
|
double Mix_GetMusicLoopStartTime(Mix_Music *music);
|
||
|
|
/*
|
||
|
|
Get the loop end time position of music stream
|
||
|
|
returns -1.0 if this feature is not used for this music or not supported for some codec
|
||
|
|
*/
|
||
|
|
double Mix_GetMusicLoopEndTime(Mix_Music *music);
|
||
|
|
/*
|
||
|
|
Get the loop time length of music stream
|
||
|
|
returns -1.0 if this feature is not used for this music or not supported for some codec
|
||
|
|
*/
|
||
|
|
double Mix_GetMusicLoopLengthTime(Mix_Music *music);
|
||
|
|
|
||
|
|
=============================================================================
|
||
|
|
|
||
|
|
Due to popular demand, here is a simple multi-channel audio mixer.
|
||
|
|
It supports 8 channels of 16 bit stereo audio, plus a single channel
|
||
|
|
of music, mixed by the Modplug MOD, Timidity MIDI, ADLMIDI, GME
|
||
|
|
and LibMAD MP3 libraries.
|
||
|
|
|
||
|
|
See the header file SDL_mixer_ext.h for documentation on this mixer library.
|
||
|
|
|
||
|
|
The mixer can currently load Microsoft WAVE files and Creative Labs VOC
|
||
|
|
files as audio samples, and can load MIDI files via Timidity and the
|
||
|
|
following music formats via MikMod: .MOD .S3M .IT .XM. It can load
|
||
|
|
Ogg Vorbis streams as music if built with Ogg Vorbis or Tremor libraries,
|
||
|
|
and finally it can load MP3 music using the SMPEG or libmad libraries.
|
||
|
|
|
||
|
|
Tremor decoding is disabled by default; you can enable it by passing
|
||
|
|
--enable-music-ogg-tremor
|
||
|
|
to configure, or by defining OGG_MUSIC and OGG_USE_TREMOR.
|
||
|
|
|
||
|
|
libmad decoding is disabled by default; you can enable it by passing
|
||
|
|
--enable-music-mp3-mad
|
||
|
|
to configure, or by defining MP3_MAD_MUSIC
|
||
|
|
vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
||
|
|
WARNING: The license for libmad is GPL, which means that in order to
|
||
|
|
use it your application must also be GPL!
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
|
||
|
|
The process of mixing MIDI files to wave output is very CPU intensive,
|
||
|
|
so if playing regular WAVE files sound great, but playing MIDI files
|
||
|
|
sound choppy on slow computers, try using 8-bit audio, mono audio,
|
||
|
|
or lower frequencies.
|
||
|
|
|
||
|
|
To play MIDI files via Timidity, you'll need to get a complete set of GUS patches
|
||
|
|
from:
|
||
|
|
http://www.libsdl.org/projects/mixer/timidity/timidity.tar.gz
|
||
|
|
and unpack them in /usr/local/lib under UNIX, and C:\ under Win32.
|
||
|
|
|
||
|
|
This library is under the zlib license, see the file "COPYING.txt" for details.
|
||
|
|
|
||
|
|
|
||
|
|
|