Miles Sound System SDK 7.2a

AIL_set_digital_master_volume_level

The function AIL_set_digital_master_volume_level establishes an overall "master volume" value which is used to scale the volumes of all subsequent digital audio samples.

void AIL_set_digital_master_volume_level(
  HDIGDRIVER dig,
  F32 master_volume
);

In Parameters

dig: indicates the driver for which the new master volume setting is to be specified.
master_volume: specifies a linear volume scaling level (0-1.0, with 0 corresponding to complete silence, 0.5 corresponding to a 6-dB reduction in volume, and 1.0 corresponding to zero attenuation).

Discussion

This function controls an attenuation factor which is applied to all digital samples in software. Like other MSS level-control functions, it has no effect on any hardware mixer settings.

By default, the digital master volume value is initialized to 1.0 (no attenuation).

Group: Digital Audio Services
Related Functions: AIL_digital_master_volume_level, AIL_sample_volume_pan, AIL_set_sample_volume_pan
Related Basic Types: F32, HDIGDRIVER, void