Firelight Technologies FMOD Studio API

ChannelGroup::setMixLevelsInput

Sets the incoming volume level for each channel, this is a helper to avoid calling ChannelControl::setMixMatrix. This means if you have multichannel audio you can turn channels on and off, a mono signal has 1 input channel, stereo has 2, etc.

C++ Syntax

FMOD_RESULT ChannelGroup::setMixLevelsInput(
  float *levels,
  int numlevels
);

C Syntax

FMOD_RESULT FMOD_ChannelGroup_SetMixLevelsInput(
  FMOD_CHANNELGROUP *channelgroup,
  float *levels,
  int numlevels
);

Parameters

levels

Array of volume levels for each incoming channel.

numlevels

Number of levels in the array, from 0 to 32 inclusive.

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.

See Also

• ChannelControl::setMixMatrix
• ChannelControl::getMixMatrix

Version 1.03.06 Built on Apr 17, 2014