Firelight Technologies FMOD Studio API

Channel::set3DDistanceFilter

Control the behaviour of a 3D distance filter, whether to enable or disable it, and frequency characteristics.

C++ Syntax

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

C Syntax

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

Parameters

custom

Specify true to disable FMOD distance rolloff calculation. Default = false.

customLevel

Specify a attenuation factor manually here, where 1.0 = no attenuation and 0 = complete attenuation. Default = 1.0.

centerFreq

Specify a 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::get3DDistanceFilter

Version 1.03.06 Built on Apr 17, 2014