Miles Sound System SDK 7.2a

AIL_sample_3D_cone

The function AIL_sample_3D_cone retrieves the current sound emission cone of a sample.

void AIL_sample_3D_cone(
  HSAMPLE S,
  F32 *inner_angle,
  F32 *outer_angle,
  F32 *outer_volume
);

inner_angle: returns the inner angle of the sound cone in degrees (0 to 360). If the listener is within this angle of this sample, then the sound is at its normal volume (based on the initial volume, distance, occlusion, etc).
outer_angle: returns the outer angle of the sound cone in degrees (0 to 360). If the listener is outside the inner angle but still inside the outer angle, then the volume is scaled linearly from no scaling (when close to the inner angle) to the outer volume scale (when close or greater than the outer angle).
outer_volume: returns the amount to scale the normal volume to when outside the outer angle. A value of 0 means the normal volume is scaled all the way to zero. A volume of 1.0 means that the normal volume isn't scaled at all (and you wouldn't hear the difference when inside or outside of the cone).

You can pass in NULL for any parameter that you aren't interested in.

By default, every sound is omni-directional - the inner and outer angles are 360 degrees and the outer volume is 1.0.

The inner angle is always smaller than the outer angle.

Example files that use this function: examms.cpp

Group: Digital Audio Services
Related Functions: AIL_sample_3D_distances, AIL_set_sample_3D_cone
Related Basic Types: F32, HSAMPLE, void