Previous Topic Index Next Topic
[API function]

FMUSIC_LoadSong

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.

See Also

FMUSIC_FreeSong , FMUSIC_LoadSong , FMUSIC_LoadSongMemory , FSOUND_File_SetCallbacks

This document copyright ©Firelight Multimedia, 1999-2001. All rights reserved.
Generated Thu Sep 13 00:18:08 2001 by SourceDoc v0.10, the automated source code documenter.