2018-04-22 15:55:55 +00:00
< HTML >
< HEAD >
< META NAME = "GENERATOR" Content = "SOURCEDOC.EXE" >
< META HTTP-EQUIV = "Content-Type" content = "text/html; charset=iso-8859-1" >
< TITLE > FMUSIC_LoadSong< / TITLE >
< STYLE >
#flush {margin-left: -10p; margin-right: -0p}
#buttonbar {color: white}
< / STYLE >
< / HEAD >
< BODY TOPMARGIN = 0 BGPROPERTIES = "FIXED" BGCOLOR = "white" >
< FONT FACE = "ARIAL" >
< SPAN ID = "flush" >
< A NAME = "SEE ALSO" >
< TABLE WIDTH = "100%" COLS = 2 BORDER = 0 BGCOLOR = "#000000" >
< TR ALIGN = RIGHT >
< TD ALIGN = LEFT >
< IMG SRC = "banner03.gif" WIDTH = "88" HEIGHT = "31" BORDER = 0 >
< / TD >
< TD ALIGN = RIGHT VALIGN = TOP >
< FONT FACE = "ARIAL" SIZE = "2" >
< A ID = buttonbar HREF = "FMUSIC_IsPlaying.html" >
< IMG SRC = "u_prev.gif" WIDTH = "71" HEIGHT = "16" BORDER = 0 ALT = "Previous Topic" >
< / A >
< A ID = buttonbar HREF = "FMUSIC.html" >
< IMG SRC = "u_index.gif" WIDTH = "47" HEIGHT = "16" BORDER = 0 ALT = "Index" >
< / A >
< A ID = buttonbar HREF = "FMUSIC_LoadSongEx.html" >
< IMG SRC = "u_next.gif" WIDTH = "48" HEIGHT = "16" BORDER = 0 ALT = "Next Topic" >
< / A >
< / FONT > < / TD > < TD WIDTH = 15 > < / TD >
< / TR >
< / TABLE >
< / A >
< / SPAN >
< A HREF = "FMUSIC.html#Functions" > < H5 > [API function]< / A > < / H5 >
< H2 > < A NAME = "FMUSIC_LoadSong" > FMUSIC_LoadSong< / A > < / H2 >
To load a module or bank with a given filename. FMUSIC Supports loading of < BR >
- .MOD (protracker/fasttracker modules)< BR >
- .S3M (screamtracker 3 modules)< BR >
- .XM (fasttracker 2 modules)< BR >
- .IT (impulse tracker modules)< BR >
- .MID (MIDI files)< BR >
- .RMI (MIDI files)< BR >
- .SGT (DirectMusic segment files)< BR >
- .FSB (FMOD Sample Bank files)< BR >
< P >
< B > FMUSIC_MODULE * F_API < / B > < B > < / B > < B > FMUSIC_LoadSong< / B > < B > (< / B > < BR >
< B > const char *< / B > < I > name< / I > < BR >
< B > );< / B > < BR >
< H3 > Parameters< / H3 >
< TABLE >
< TR VALIGN = top > < TD > < I > name< / I > < / TD >
< TD > Filename of module to load.< BR >
< / TD > < / TABLE >
< H3 > Return Value< / H3 >
On success, a pointer to a FMUSIC_MODULE handle is returned.< BR >
On failure, NULL is returned.< BR >
< H3 > Remarks< / H3 >
This function autodetects the format type, regardless of filename.< BR >
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.< BR >
Various other functionality is not provided in MIDI. See relevant FMUSIC functions to see if a feature< BR >
is supported or not.< BR >
___________________< BR >
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube< BR >
< H3 > See Also< / H3 >
< A HREF = "FMUSIC_FreeSong.html" > FMUSIC_FreeSong< / A >
,
< A HREF = "FMUSIC_LoadSong.html" > FMUSIC_LoadSong< / A >
,
< A HREF = "FMUSIC_LoadSongEx.html" > FMUSIC_LoadSongEx< / A >
,
< A HREF = "FSOUND_File_SetCallbacks.html" > FSOUND_File_SetCallbacks< / A >
< HR > < BR > < FONT SIZE = "-2" > This document copyright © Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.< / FONT > < BR >
< FONT SIZE = "-2" > Generated Thu Dec 15 17:31:26 2005
by SourceDoc v0.10, the automated source code documenter.< / FONT > < BR >
< / BODY >
< / HTML >
