BASS_ATTRIB_VOL attribute


The volume level of a channel.

BASS_ChannelSetAttribute(
    DWORD handle,
    BASS_ATTRIB_VOL,
    float volume
);

Parameters

handleThe channel handle.
volumeThe volume level... 0 = silent, 1.0 = normal, above 1.0 = amplification.

Remarks

This attribute applies to playback of the channel and does not affect the channel's sample data, so has no direct effect on decoding channels. It is still adjustable then though, so that it can be used by the BASSmix add-on and anything else that wants to use it. The BASS_FX_VOLUME effect can be used via BASS_ChannelSetFX to change the level of a channel's sample data.

When using BASS_ChannelSlideAttribute to slide this attribute, a negative volume value can be used to fade-out and then stop the channel. When the linear volume curve is in use, the BASS_SLIDE_LOG flag can also be used to make a slide logarithmic rather than linear.

Platform-specific

When using DirectSound output on Windows, amplification is not supported so this attribute will be limited to 1.0. On platforms/architectures without floating-point support (see BASS_CONFIG_FLOAT), amplification is limited to 16x.

See also

BASS_ChannelGetAttribute, BASS_ChannelSetAttribute, BASS_ChannelSlideAttribute, BASS_CONFIG_CURVE_VOL