[API function]
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.