Microsoft DirectX 8.1 (Visual Basic) |
The SetRolloffFactor method sets the rolloff factor, which determines the rate of attenuation over distance.
Syntax
object.SetRolloffFactor( _
rolloffFactor As Single, _
applyFlag As CONST_DS3DAPPLYFLAGS)
Parts
object
Resolves to a DirectSound3DListener8 object.
rolloffFactor
Rolloff factor.
applyFlag
Value that specifies when the setting should be applied. Must be one of the constants of the CONST_DS3DAPPLYFLAGS enumeration.
Error Codes
If the method fails, an error is raised and Err.Number may be set to DSERR_INVALIDPARAM.
Remarks
The rolloff factor has a range of DS3D_MINROLLOFFFACTOR (no rolloff) to DS3D_MAXROLLOFFFACTOR (defined as 10 times the rolloff found in the real world). The default value is DS3D_DEFAULTROLLOFFFACTOR (1.0).
See Also