MusFxBankSetCurrent()

Syntax

void MusFxBankSetCurrent(void *ifxbank);

Arguments

ifxbank

the address of an initialized sound effect bank

Description

It sets the current default sound effect bank address.

The default sound effect bank is used when the MusStartEffect() or the MusStartEffect2() function is used to start sound effects, if no sound effect bank override has been defined.

The MusFxBankSetSingle() function can be used to define a sound effect bank override for the next sound effect started.

The ifxbank must contain the address of a sound effect bank initialized with the MusFxBankInitialize() function.

Return Value

None

Example

void StackEffectBank(void *fx_addr)
{
  effect_bank_stack[stack_ptr++]=MusFxBankGetCurrent();
  MusFxBankSetCurrent(fx_addr);
}

void UnStackEffectBank(void)
{
  MusFxBankSetCurrent(effect_bank_stack[--stack_ptr]);
}

See Also

MusFxBankInitialize(), MusFxBankGetCurrent(), MusFxBankSetSingle(), MusStartEffect(), MusStartEffect2()