MIXUpdateSettings

Syntax

#include <cafe.h>
#include <cafe/mix.h>

void MIXUpdateSettings(void);

Parameters

None.

Return Values

None.

Description

Applies latest mixing values to AX voice parameters. Invoke this function from the AX user callback to ensure that mixing values are applied at audio frame boundaries. For example:

AXUserCallback callbackForAudioFrame(void)
{
  ...
  // tell the mixer to update settings to AX
  MIXUpdateSettings();
}

void main(void)
{
  ...

  AXInit();
  MIXInit();
  AXRegisterFrameCallback(&callbackAudioFrame);

  ...

  MIXQuit();
  AXQuit();
  ...
}

NOTE:
Do not call MIXUpdateSettings multiple times from the audio frame callback function. Calling multiple times just hogs the CPU and provides no more control than one call. Make all the changes to mix settings in the loop per voice and then call MIXUpdateSettings outside the loop.

Availability

Library Version Availability
Sound 2.0 Yes
Sound 1.0 Yes

Do Not Call From

None.

See Also

AXRegisterFrameCallback
MIXInit
MIXQuit

Revision History

2013-05-08 Automated cleanup pass.
2012-01-26 Update to Audio API v2.0.
2011-02-21 Initial Version


CONFIDENTIAL