BASS_SetA3DHFAbsorbtion

Sets the A3D high frequency absorption factor.

BOOL WINAPI BASS_SetA3DHFAbsorbtion(
    float factor
);

Parameters
factorHF absorbtion factor... 0.0 = disable, 1.0 = normal (default), less than 1.0 = diminish, higher than 1.0 = exaggerate.

Return value
If succesful, then TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes
BASS_ERROR_NOA3DThe current device does not support A3D, or BASS_DEVICE_A3D was not specified with BASS_Init.
BASS_ERROR_ILLPARAMThe factor is invalid.

Remarks
The HF factor can be manipulated to simulate different atmospheric environments, such as thick fog or underwater. The default HF factor is 1.0, which provides normal HF attenuation for air. Setting the HF factor to 0.0 disables the HF absorption.

See also
BASS_GetA3DHFAbsorbtion