Miles Sound System SDK 7.2a

AIL_set_sample_reverb_levels

The function AIL_set_sample_reverb_levels changes the reverb levels of a digital audio sample.

void AIL_set_sample_reverb_levels(
  HSAMPLE S,
  F32 dry_level,
  F32 wet_level
);

In Parameters

S: indicates the sample whose reverb is to be set.
dry_level: specifies the level of the dry sound signal (the non-reverbed sound). The range is 0.0 for no output, 1.0 for full output.
wet_level: specifies the level of the wet sound signal (the reverberations). The range is 0.0 for no output, 1.0 for full output.

Discussion

This function controls the reverb levels applied by the AIL_set_digital_master_reverb. These levels are linear scalars, where each doubling of the level value represents a 6-dB change in the wet or dry level. For instance, a wet_level or dry_level value of 0.5 is 6 dB quieter than a value of 1.0, and 0.25 would be 12 dB quieter than 1.0.

Reverb requires CPU time to apply, but it's pretty minimal. You can monitor the CPU use with the AIL_digital_CPU_percent function.

You can use this function even if you haven't started playback yet.

Group: Digital Audio Services
Related Functions: AIL_calculate_3D_channel_levels, AIL_digital_CPU_percent, AIL_digital_master_reverb_levels, AIL_sample_reverb_levels, AIL_sample_volume_levels, AIL_set_digital_master_reverb, AIL_set_digital_master_reverb_levels, AIL_set_room_type, AIL_set_sample_51_volume_levels, AIL_set_sample_51_volume_pan, AIL_set_sample_volume_levels, AIL_set_sample_volume_pan
Related Basic Types: F32, HSAMPLE, void
Related FAQs: How do I set an environmental reverb room style?, What's the best way to port my older Miles application to MSS 7?