NDS: ARM9 Initialization/Main Functions

Functions
void	mmInit (mm_ds_system *system)
	Initializes Maxmod with the settings specified.
void	mmInitDefault (const char *soundbank_file)
	Initialize Maxmod with default settings.
void	mmInitDefaultMem (mm_addr soundbank)
	Initialize Maxmod with default settings.
void	mmLoad (mm_word module_ID)
	Loads a module into memory for playback.
void	mmLoadEffect (mm_word sample_ID)
	Loads a sound effect into memory for playback.
void	mmLockChannels (mm_word bitmask)
	Lock audio channels to prevent Maxmod from using them.
void	mmSelectMode (mm_mode_enum mode)
	Switches the audio mode for Maxmod DS.
void	mmSetCustomSoundBankHandler (mm_callback p_loader)
	Install a custom routine to interface with the soundbank data.
void	mmSetEventHandler (mm_callback handler)
	Install handler to receive song events.
void	mmSoundBankInFiles (char *filename)
	Setup the standard interface for a soundbank that is loaded in the file system.
void	mmSoundBankInMemory (mm_addr address)
	Enable the standard interface for a soundbank that is loaded into memory.
void	mmUnload (mm_word module_ID)
	Unloads and frees memory space occupied by a module.
void	mmUnloadEffect (mm_word sample_ID)
	Unloads a sound effect and frees the memory if the reference count becomes zero.
void	mmUnlockChannels (mm_word bitmask)
	Unlocks audio channels to allow Maxmod to use them.

Detailed Description

Function Documentation

mmInit()

void mmInit

(

mm_ds_system *

system

)

Initializes Maxmod with the settings specified.

Initialize system. Call once at startup.

For DS projects, you must also setup a soundbank interface with one of the mmSoundBank* functions.

Parameters

system

Maxmod setup configuration.

Example:

void maxmodInit( void )
{
    mm_ds_system sys;
 
    // Number of modules in your soundbank (defined in output header)
    sys.mod_count = MSL_NSONGS;
 
    // Number of samples in your soundbank (defined in output header)
    sys.samp_count= MSL_NSAMPS;
 
    // Memory bank, allocate BANKSIZE (or NSONGS+NSAMPS) words
    sys.mem_bank = malloc( MSL_BANKSIZE * 4 );
 
    // Select FIFO channel
    sys.fifo_channel = FIFO_MAXMOD;
 
    // Initialize maxmod
    mmInit( &sys );
 
    mmSoundBankInMemory( (mm_addr)my_soundbank );
 
    // or
    //
    //mmSoundBankInFiles( "my_soundbank.msl" );
}

mmInitDefault()

void mmInitDefault

(

const char *

soundbank_file

)

Initialize Maxmod with default settings.

For DS, this function also sets up the internal soundbank interface to use the file specified.

Parameters

soundbank_file

Filename of soundbank. A soundbank file can be created with the Maxmod Utility.

mmInitDefaultMem()

void mmInitDefaultMem

(

mm_addr

soundbank

)

Initialize Maxmod with default settings.

This function also sets up the internal soundbank interface to use the file that is located somewhere in memory.

Use this when you have the entire soundbank loaded into memory.

Parameters

soundbank

Address of soundbank data.

mmLoad()

void mmLoad

(

mm_word

module_ID

)

Loads a module into memory for playback.

Must be used before starting to play a module with mmStart().

Parameters

module_ID

Index of module to be loaded. Values are defined in the soundbank header output. (prefixed with "MOD_")

mmLoadEffect()

void mmLoadEffect

(

mm_word

sample_ID

)

Loads a sound effect into memory for playback.

May be played with mmEffect()/mmEffectEx() afterwards.

Parameters

sample_ID

Index of sample to be loaded. Values are defined in the soundbank header output (prefixed with "SFX_)

mmLockChannels()

void mmLockChannels

(

mm_word

bitmask

)

Lock audio channels to prevent Maxmod from using them.

This is for when you need to operate on the DS hardware channels directly. Note that if you use this function while music or sound effects are playing, any active notes that are using the channels to be locked will be cut.

Parameters

bitmask

Selection of channels to lock. Bit0 = Channel0, Bit1 = Channel1 ... Bit15 = Channel15

mmSelectMode()

void mmSelectMode

(

mm_mode_enum

mode

)

Switches the audio mode for Maxmod DS.

Hardware mixing offers 16-channel audio with minimal CPU load.

Interpolated mixing extends the capability of the hardware channels by adding linear interpolation in software.

Extended mixing increases the channel count to 30 with software mixing.

Parameters

mode	New audio mode. Pass MM_MODE_A for complete hardware mixing, MM_MODE_B for interpolated mixing, or MM_MODE_C for extended mixing.

mmSetCustomSoundBankHandler()

void mmSetCustomSoundBankHandler

(

mm_callback

p_loader

)

Install a custom routine to interface with the soundbank data.

The routine will be responsible for handling requests from Maxmod to access data in the soundbank.

Parameters

p_loader

Function pointer to soundbank request handler.

mmSetEventHandler()

void mmSetEventHandler

(

mm_callback

handler

)

Install handler to receive song events.

Use this function to receive song events. Song events occur in two situations. One is by special pattern data in a module (which is triggered by SFx/EFx commands). The other occurs when a module finishes playback (in MM_PLAY_ONCE mode).

Parameters

handler

Function pointer to event handler.

mmSoundBankInFiles()

void mmSoundBankInFiles

(

char *

filename

)

Setup the standard interface for a soundbank that is loaded in the file system.

This function should be called after mmInit and before any Load or Unload operations. This function is called by mmInitDefault.

Parameters

filename

Filename of your soundbank binary.

mmSoundBankInMemory()

void mmSoundBankInMemory

(

mm_addr

address

)

Enable the standard interface for a soundbank that is loaded into memory.

This function should be called after mmInit and before any Load or Unload functions. This function is called by mmInitDefaultMem.

Parameters

address

Memory address of soundbank file.

mmUnload()

void mmUnload

(

mm_word

module_ID

)

Unloads and frees memory space occupied by a module.

Caution: Ensure that the module to be unloaded isn't playing!

Parameters

module_ID

Index of module to be unloaded from memory.

mmUnloadEffect()

void mmUnloadEffect

(

mm_word

sample_ID

)

Unloads a sound effect and frees the memory if the reference count becomes zero.

Parameters

sample_ID

Index of sample to be unloaded.

mmUnlockChannels()

void mmUnlockChannels

(

mm_word

bitmask

)

Unlocks audio channels to allow Maxmod to use them.

This function can be used to restore channel usage to Maxmod when you are finished using certain channels.

Note that in the "Interpolated Audio" mode, channels can not be unlocked. To unlock channels in the interpolated mode you must reset the audio system. To reset the audio system, use mmSelectMode.

Parameters

bitmask

Selection of channels to unlock. Bit0 = Channel0, Bit1 = Channel1, Bit2 = Channel2 ... Bit15 = Channel15