Miles Sound System SDK 7.2a

AIL_set_digital_master_reverb_levels

The function AIL_set_digital_master_reverb_levels establishes the overall "master reverb" levels which are used to scale the levels of the reverb of all subsequent digital audio samples.

void AIL_set_digital_master_reverb_levels(
  HDIGDRIVER dig,
  F32 dry_level,
  F32 wet_level
);

In Parameters

dig: indicates the driver for which the new reverb level is to be specified.
dry_level: specifies a scaling factor for the dry sound signal (the non-reverbed sound). The range is 0.0 for no output, 1.0 for full output.
wet_level: specifies a scaling factor for the wet sound signal (the reverberations). The range is 0.0 for no output, 1.0 for full output.

Discussion

This function controls a driver-wide scaling factor which is applied to all digital samples in software.

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.

By default, both the wet and dry scaling factors are set to 1.0.

The AIL_set_room_type function sets the master reverb levels to emulate EAX compatible room settings.

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: Digital Audio Services
Related Functions: AIL_digital_master_reverb_levels, AIL_sample_reverb_levels, AIL_set_room_type, AIL_set_sample_reverb_levels
Related Basic Types: F32, HDIGDRIVER, MSS_MC_SPEC, 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?