Miles Sound System SDK 7.2a

AIL_set_sample_exclusion

The function AIL_set_sample_exclusion sets the exclusion for the specified 3D sample.

void AIL_set_sample_exclusion(
  HSAMPLE S,
  F32 obstruction
);

In Parameters

S: indicates the sample handle to control.
obstruction: is the amount that the sample is excluded. This is a linear value from completely non-excluded (0.0) to completely excluded (1.0).

Discussion

Exclusion means that the direct path of the sound is available, but the reverbations will be blocked - a sound playing outside a room, but through an open window, for example.

By default, samples are completely non-excluded.

On most providers, exclusions are emulated with the effects level control. On the EAX 3/4 providers, however, exclusions are performed in hardware and sound really nice.

Group: Digital Audio Services
Related Sections: Creative's EAX 3 Properties
Related Functions: AIL_sample_exclusion, AIL_set_sample_obstruction, AIL_set_sample_occlusion
Related Basic Types: F32, HSAMPLE, void
Related FAQs: What's the best way to port my older Miles application to MSS 7?