Firelight Technologies FMOD Studio API
FMOD_DSP_NORMALIZE
Parameter types for the FMOD_DSP_TYPE_NORMALIZE filter.
C/C++ Syntax
typedef enum {
FMOD_DSP_NORMALIZE_FADETIME,
FMOD_DSP_NORMALIZE_THRESHHOLD,
FMOD_DSP_NORMALIZE_MAXAMP
} FMOD_DSP_NORMALIZE;
JavaScript Syntax
FMOD.DSP_NORMALIZE_FADETIME
FMOD.DSP_NORMALIZE_THRESHHOLD
FMOD.DSP_NORMALIZE_MAXAMP
Values
FMOD_DSP_NORMALIZE_FADETIME
(Type:float) - Time to ramp the silence to full in ms. 0.0 to 20000.0. Default = 5000.0.
FMOD_DSP_NORMALIZE_THRESHHOLD
(Type:float) - Lower volume range threshold to ignore. 0.0 to 1.0. Default = 0.1. Raise higher to stop amplification of very quiet signals.
FMOD_DSP_NORMALIZE_MAXAMP
(Type:float) - Maximum amplification allowed. 1.0 to 100000.0. Default = 20.0. 1.0 = no amplifaction, higher values allow more boost.
Remarks
Normalize amplifies the sound based on the maximum peaks within the signal.
For example if the maximum peaks in the signal were 50% of the bandwidth, it would scale the whole sound by 2.
The lower threshold value makes the normalizer ignores peaks below a certain point, to avoid over-amplification if a loud signal suddenly came in, and also to avoid amplifying to maximum things like background hiss.
Because FMOD is a realtime audio processor, it doesn't have the luxury of knowing the peak for the whole sound (ie it can't see into the future), so it has to process data as it comes in.
To avoid very sudden changes in volume level based on small samples of new data, fmod fades towards the desired amplification which makes for smooth gain control. The fadetime parameter can control this.
See Also
Version 1.10.03 Built on Feb 1, 2018