Previous Topic Index Next Topic
[API function]

FSOUND_SetVolumeAbsolute

Sets a channels volume linearly.
This function is NOT affected by master volume.
This function is used when you want to quiet everything down using FSOUND_SetSFXMasterVolume, but make
a channel prominent.

signed char F_API FSOUND_SetVolumeAbsolute(
int channel,
int vol
);

Parameters

channel The channel number/handle to change the volume for. FSOUND_ALL can also be used (see remarks)
vol The volume to set. Valid ranges are from 0 (silent) to 255 (full volume)

Return Value

On success, TRUE is returned.
On failure, FALSE is returned.

Remarks

FSOUND_ALL is supported. Passing this will set the absolute volume of ALL channels available.
If FSOUND_ALL is used the last channel success flag will be returned. It is not very useful.
-------------
A good example of this function being used was in a game I was making, and we needed a voice over.
All the background sounds were too loud and drowned out the voice over, and there was no way i could
feasibly go through all the sfx channels and lower the background noise volumes. This way you just
lower the background noise with FSOUND_SetSFXMasterVolume, and use FSOUND_SetVolumeAbsolute to bring
up the volume of the voice over to full! And there you have it!

See Also

FSOUND_GetVolume , FSOUND_SetSFXMasterVolume , FSOUND_SetVolume , FSOUND_SetVolumeAbsolute

This document copyright ©Firelight Multimedia, 1999-2001. All rights reserved.
Generated Thu Sep 13 00:18:09 2001 by SourceDoc v0.10, the automated source code documenter.