Roblox UtilitiesDevlHub Roblox Documentation

Enum

DistanceAttenuationMode

Determines how an AudioEmitter attenuates (fades out) as the distance between the AudioEmitter and an interacting AudioListener increases.

Determines how an AudioEmitter attenuates (fades out) as the distance between the AudioEmitter and an interacting AudioListener increases. Most values refer to a preset rolloff curve that the AudioEmitter will apply over the range given by DistanceAttenuationBounds. When set to DistanceAttenuationMode.Custom, the emitter instead uses a developer-supplied curve given by AudioEmitter:SetDistanceAttenuation().

Items 5#

NameValueSummary
Custom0Uses the developer-supplied DistanceAttenuation curve for gain rolloff.
InverseTapered1Volume attenuates according to a hybrid model which follows the DistanceAttenuationMode.Inverse model when close to the lower bound of AudioEmitter.DistanceAttenuationBounds and the DistanceAttenuationMode.LinearSquared model when close to the upper bound of AudioEmitter.DistanceAttenuationBounds. This is done by taking the lesser of these two curves, such that the curve mostly follows an inverse relationship but tapers to silence at the maximum distance.
Linear2Volume attenuates between the bounds of AudioEmitter.DistanceAttenuationBounds with a linear relationship. This is done by computing (maxDistance - distance) / (maxDistance - minDistance), where distance is the Vector3.Magnitude between the AudioEmitter's position and the AudioListener's position.
LinearSquared3Volume attenuates between the bounds of AudioEmitter.DistanceAttenuationBounds with a linear-squared relationship. This is done by squaring the formula used to determine the volume when using DistanceAttenuationMode.Linear, which creates a parabolic curve with a steeper fade.
Inverse4Volume attenuates from the lower bound of AudioEmitter.DistanceAttenuationBounds in an inverse manner, mirroring how sounds attenuate in the real world. This is done by computing (minDistance/distance), where distance is the Vector2.Magnitude between the AudioEmitter's position and the AudioListener's position.