Miles Sound System SDK 7.2a

AIL_set_sample_obstruction

The function AIL_set_sample_obstruction sets the obstruction for the specified 3D sample.

void AIL_set_sample_obstruction(
  HSAMPLE S,
  F32 obstruction
);

In Parameters

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

Discussion

Obstructions mean that the direct path of the sound is blocked, but an indirect path is still available - a sound playing from behind a crate, for example.

By default, samples are completely non-obstructed.

With most output options, obstructions are emulated with volume control. On the EAX 2/3/4 providers, however, obstructions are performed in hardware and sound really cool (you can still hear reflections because they bounce around the obstruction).

Example files that use this function: examms.cpp

Group: Digital Audio Services
Related Sections: Creative's EAX 2 Properties
Related Functions: AIL_sample_obstruction, AIL_set_sample_exclusion, 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?