Firelight Technologies FMOD Studio API

Channel::get3DDistanceFilter

Retrieve the settings for the 3D distance filter properties for a Channel or Channel Group.

C++ Syntax

FMOD_RESULT Channel::get3DDistanceFilter(
  bool *custom,
  float *customLevel,
  float *centerFreq
);

C Syntax

FMOD_RESULT FMOD_Channel_Get3DDistanceFilter(
  FMOD_CHANNEL *channel,
  FMOD_BOOL *custom,
  float *customLevel,
  float *centerFreq
);

Parameters

custom

Address of a variable to receive the enabled/disabled state of the FMOD distance rolloff calculation. Default = false.

customLevel

Address of a variable to receive the manual user attenuation, where 1.0 = no attenuation and 0 = complete attenuation. Default = 1.0.

centerFreq

Address of a variable to receive center frequency for the high-pass filter used to simulate distance attenuation.

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.

See Also

• ChannelControl::set3DDistanceFilter

Version 1.03.06 Built on Apr 17, 2014