Miles Sound System SDK 7.2a

AIL_set_3D_distance_factor

The function AIL_set_3D_distance_factor sets the driver's global 3D distance factor.

void AIL_set_3D_distance_factor(
  HDIGDRIVER driver,
  F32 factor
);

In Parameters

driver: indicates the driver to set.
factor: indicates the new distance factor to use.

Discussion

Internally, the 3D units used in Miles are meters, but you can switch to your game's own units by using this function. For example, if your game's units were feet, then you would specify 0.3048 for the distance factor (1 foot = 0.3048 meters).

It's actually rare that you need to use this function, since the AIL_set_sample_3D_distances function acts as the distance scale. So, the only time the distance factor is really used is in the Doppler calculations.

Group: Digital Audio Services
Related Functions: AIL_3D_distance_factor, AIL_set_3D_doppler_factor, 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?