MusFxBankSetCurrent()

Set the default sound effect bank.

Syntax

  void MusFxBankSetCurrent(void *ifxbank);

Arguments

• ifxbank is the address of an initialized sound effect bank

Explanation
Set 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]);
  }