FMOD_DSP_NORMALIZE

Parameter types for the FMOD_DSP_TYPE_NORMALIZE filter.

Enumeration

typedef enum {
  FMOD_DSP_NORMALIZE_FADETIME,
  FMOD_DSP_NORMALIZE_THRESHHOLD,
  FMOD_DSP_NORMALIZE_MAXAMP
} FMOD_DSP_NORMALIZE;

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.

FMOD_DSP_NORMALIZE

Enumeration

Values

Remarks

See Also