Copyright © 2001-2018 MultiMedia Soft

Effects.EqualizerBandAdd method

Previous pageReturn to chapter overviewNext page



Adds a new band to the equalizer.


For further details about defining the equalizer settings refer to the How to create and use an Equalizer section.

See the How to apply special effects to a playing sound section for further details.





[Visual Basic]

control.Effects.EqualizerBandAdd (

nPlayer as Integer,

fFrequency as Single,

fBandWidth as Single,

fGain as Single

) as enumErrorCodes



short control.Effects.EqualizerBandAdd (

short nPlayer,

float fFrequency,

float fBandWidth,

float fGain









Number representing the zero-based index of the involved player


Center frequency of the band expressed in Hertz. Accepted values can be in the range from 1 to 16000 Hz.

A band's frequency cannot exceed one-third of the frequency of the sound under editing so, if you have loaded a sound with a frequency of 44100 Hz, the maximum allowed band's frequency will be 14700 Hz (14700 * 3 = 44100); in order to reach a band's frequency of 16000 Hz, you must load sounds whose frequency is at least 48000 Hz.

If a band for this specific frequency should already exist, it would be automatically replaced.


Width of the band expressed in semi-tones


Gain of the band expressed in dB. Typical values are in the range from -15 to 15 dB but you can also enter values outside of this range.



Return value






Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.NOERROR (0)

The method call was successful.