Previous Topic Index Next Topic
[API function]

FSOUND_Reverb_SetMix

Sets a scalar, or the wet/dry mix value for the amount of reverb to be applied to this channel,
or to tell it to automatically calculate the reverb amount based on distance from listener.

signed char F_API FSOUND_Reverb_SetMix(
int channel,
float mix
);

Parameters

channel The channel to have its reverb mix changed. FSOUND_ALL can also be used (see remarks)
mix 0.0 to 1.0. 0 means no reverb for this channel (dry), whereas 1.0 means full reverb (wet).
EAX_REVERBMIX_USEDISTANCE. This will scale the reverb mix automatically based on the distance
from the listener. It is recommended to use this value as it is the most natural sounding.

Return Value

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

Remarks

FSOUND_ALL is supported here. Passing this will set ALL channels to specified reverb mix.
If FSOUND_ALL is used the last channel success flag will be returned. It is not very useful.
-----------------
If no mix value is set, EAX_REVERBMIX_USEDISTANCE is the default.
-----------------
You must be using FSOUND_OUTPUT_DSOUND or FSOUND_OUTPUT_A3D as the output mode for this to work.
In dsound, the reverb will only work if you have an EAX compatible soundcard such as the SBLive,
and your sample was created with the FSOUND_HW3D flag.

See Also

FSOUND_Reverb_GetMix , FSOUND_REVERBMIX_USEDISTANCE

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.