Miles Sound System SDK 7.2a

AIL_set_3D_rolloff_factor

The function AIL_set_3D_rolloff_factor sets the driver's global 3D rolloff factor.

void AIL_set_3D_rolloff_factor(
  HDIGDRIVER dig,
  F32 factor
);

In Parameters

dig: indicates the driver to set.
factor: indicates new rolloff factor to use.

Discussion

The rolloff factor controls how fast 3D audio will fall off with distance. The default is 1.0, which implies no change to the "real-world" falloff speed. You can double the falloff rate by using 2.0, and you can turn off the falloff completely by using 0.0.

Use the AIL_set_sample_3D_distances function to control the falloff curve for each sample.

Group: Digital Audio Services
Related Functions: AILFALLOFFCB, AIL_3D_rolloff_factor, AIL_active_sample_count, AIL_calculate_3D_channel_levels, AIL_set_sample_3D_distances
Related Basic Types: F32, HDIGDRIVER, void
Related FAQs: What's the best way to port my older Miles application to MSS 7?