Miles Sound System SDK 7.2a

AIL_quick_set_reverb_levels

The function AIL_quick_set_reverb_levels changes the reverb levels of a digital audio sample, or a MIDI playing through the software synthesizer.

void AIL_quick_set_reverb_levels(
  HAUDIO audio,
  F32 dry_level,
  F32 wet_level
);

In Parameters

audio: specifies the audio handle that you wish to control.
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. This function will have no effect with per-voice hardware drivers that don't support reverb in hardware. Currently, this applies only to the MSS_MC_DIRECTSOUND3D value from the MSS_MC_SPEC list, since the EAX providers handle reverb directly and the software-mixing options emulate EAX.

Group: Quick Integration Services
Related Functions: AIL_digital_CPU_percent, AIL_set_digital_master_reverb
Related Basic Types: F32, HAUDIO, MSS_MC_SPEC, void