Initializes the FMOD Sound System.
signed char F_API FSOUND_Init(
unsigned int flags
: Output rate in hz between 4000 and 65535. Any thing outside this will cause
the function to fail and return FALSE.
PS2 Note. Only rates of 24000 and 48000 are supported.
SmartPhone Note. Use 22050 or the operating system may crash outside of the control of fmod.
: Maximum number of SOFTWARE channels available.
The number of HARDWARE channels is autodetected. The total number of channels available (hardware and software) after initialization can be found with FSOUND_GetMaxChannels.
Having a large number of maxchannels does not adversely affect cpu usage, but it means it has the POTENTIAL to mix a large number of channels, which can have an adverse effect on cpu usage.
1024 is the highest number that can be set. Anything higher will return an error.
: See FSOUND_INIT_FLAGS. Controls some global or initialization time aspects of playback.
On success, TRUE is returned.
On failure, FALSE is returned.
You do not have control over how many hardware channels are available to you. In a lot of
cases it may be 0 (the sound card does not have the ability to supply hardware channels).
This is why it is usually a good idea to supply FSOUND_Init with a good number of software
channels to fall back onto, for example 32.
Hardware channels are 3D hardware channels only. There is no benefit in supporting hardware
for 2d playback of sound effects. With todays machines and FMOD's superior mixing routines,
FMOD's software engine can sometimes be faster than the driver's hardware support!
Shuts down the WHOLE FMOD Sound System.
void F_API FSOUND_Close(
This also closes down the sample management system, freeing all MANAGED samples loaded (unless they were allocated with the FSOUND_UNMANAGED flag).
Streams are not freed. You must close them yourself.
CD Tracks are stopped.
To load a module or bank with a given filename. FMUSIC Supports loading of
- .MOD (protracker/fasttracker modules)
- .S3M (screamtracker 3 modules)
- .XM (fasttracker 2 modules)
- .IT (impulse tracker modules)
- .MID (MIDI files)
- .RMI (MIDI files)
- .SGT (DirectMusic segment files)
- .FSB (FMOD Sample Bank files)
FMUSIC_MODULE * F_API FMUSIC_LoadSong(
const char *name
: Filename of module to load.
On success, a pointer to a FMUSIC_MODULE handle is returned.
On failure, NULL is returned.
This function autodetects the format type, regardless of filename.
The MIDI loader does not support user file callbacks. For WAD type data structures with embedded MIDI files FMUSIC_LoadSongEx will have to be used with memory loading.
Various other functionality is not provided in MIDI. See relevant FMUSIC functions to see if a feature
is supported or not.
Starts a song playing.
signed char F_API FMUSIC_PlaySong(
: Pointer to the song to be played.
TRUE song succeeded playing
FALSE song failed playing
(Auszug aus der Function Dump dumpdll.txt )
Dump of file .\dll\fmod.dll
File Type: DLL
Section contains the following exports for fmod.dll
40E2318D time date stamp Wed Jun 30 05:20:45 2004
1 ordinal base
230 number of functions
230 number of names
ordinal hint RVA name
25 18 0001FD7A _FMUSIC_LoadSong@4
28 1B 0002004E _FMUSIC_PlaySong@4
68 43 00021EE8 _FSOUND_Close@0
130 81 000218AE _FSOUND_Init@12