ChannelGroup::setMixLevelsOutput

Sets the speaker volume levels for each speaker individually, this is a helper to avoid calling ChannelControl::setMixMatrix.

C++ Syntax

FMOD_RESULT ChannelGroup::setMixLevelsOutput(
  float frontleft,
  float frontright,
  float center,
  float lfe,
  float surroundleft,
  float surroundright,
  float backleft,
  float backright
);

C Syntax

FMOD_RESULT FMOD_ChannelGroup_SetMixLevelsOutput(
  FMOD_CHANNELGROUP *channelgroup,
  float frontleft,
  float frontright,
  float center,
  float lfe,
  float surroundleft,
  float surroundright,
  float backleft,
  float backright
);

Parameters

frontleft: Volume level for the front left speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
frontright: Volume level for the front right speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
center: Volume level for the center speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
lfe: Volume level for the subwoofer speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
surroundleft: Volume level for the surround left speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
surroundright: Volume level for the surround right speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
backleft: Volume level for the back left speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).
backright: Volume level for the back right speaker of a multichannel speaker setup, 0.0 (silent), 1.0 (normal volume).

Return Values

If the function succeeds then the return value is FMOD_OK.
If the function fails then the return value will be one of the values defined in the FMOD_RESULT enumeration.

Remarks

Levels can be below 0 to invert a signal and above 1 to amplify the signal. Note that increasing the signal level too far may cause audible distortion.

Speakers specified that don't exist will simply be ignored.