[API function]
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
);
Parameters
name |
Filename of module to load.
|
Return Value
On success, a pointer to a FMUSIC_MODULE handle is returned.
On failure, NULL is returned.
Remarks
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.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube
See Also
FMUSIC_FreeSong
,
FMUSIC_LoadSong
,
FMUSIC_LoadSongEx
,
FSOUND_File_SetCallbacks
This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Thu Dec 15 17:31:26 2005
by SourceDoc v0.10, the automated source code documenter.