[API function]
To load a module 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)
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_LoadSongMemory will have to be used.
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
See Also
FMUSIC_FreeSong
,
FMUSIC_LoadSong
,
FMUSIC_LoadSongMemory
,
FSOUND_File_SetCallbacks
This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Fri Dec 20 16:31:08 2002
by SourceDoc v0.10, the automated source code documenter.