Share via

Listener3DSettings.RolloffFactor Property (Microsoft.DirectX.DirectSound)

  • Article

Retrieves and sets the ratio of attenuation over distance to that in the real world.

Definition

Visual Basic Public Property RolloffFactor As Single
C# public float RolloffFactor { get; set; }
C++ public:
property float RolloffFactor {
        float get();
        void set(float value);
}
JScript public function get RolloffFactor() : float
public function set RolloffFactor(float);

Property Value

System.Single
The ratio of attenuation over distance to that in the real world.

This property is read/write. 

Remarks

This property has a range of 0.0 (no rolloff) to 10.0 (10 times the rolloff found in the real world). The default value is 1.0.

Rolloff factor is global. To change the effect of distance for an individual sound buffer, you can set the minimum distance for the buffer.