Copyright © 2008-2019 MultiMedia Soft

Effects.DeClickFilterApply method

Previous pageReturn to chapter overviewNext page



Applies the DeClick filter to the given portion of sound under editing.


A successful call to this method will fire the SoundEditStarted event followed by a number of SoundEditPerc events and finally by the SoundEditDone event.


For further details about noise removal refer to the How to perform noise removal tutorial.

For further details about methods related to the use of special effects refer to the Effects COM object.





[Visual Basic]

control.Effects.DeClickFilterApply (

nStartPosition as Long,

nEndPosition as Long,

nSensitivity as Long,

nGroupSensitivity as Long,

bSavePitch as enumBoolean

) as enumErrorCodes



short control.Effects.DeClickFilterApply (

long nStartPosition,

long nEndPosition,

long nSensitivity,

long nGroupSensitivity,

short bSavePitch









Start position, expressed in milliseconds, of the sound range where the filter will be applied


End position, expressed in milliseconds, of the sound range where the filter will be applied


This parameter, which can range from 0 to 100, determines many filter’s inner values like window size, threshold etc. Here threshold (value of threshold decreases as sensitivity increases) is internally used parameter; it means the absolute audio level above which signal is suspected as a click or pop. If sensitivity is set to zero then filter is disabled, thus output will not be affected by this filter. Higher values of sensitivity obviously make filter more sensitive giving better results. Also higher sensitivity values make filter more complex thus runs relatively slower. Table 1 lists internal parameters affected by sensitivity and resulting filter performance.


The table below summarizes effects on internal parameters when sensitivity value is increased:

Affected Internal Parameter



Window Size


Filter searches more audio samples to detect clicks/pops. Detect decision is more accurate.



Due to decreased threshold small spikes can be detected easily

Search Factor


Filter decided a portion of audio as click/pop from small number of spikes.


This is second parameter, which can range from 0 to 100, affecting the detection of clicks/pops. You can consider detection process a

two stage search. In the first stage filter search for individual clicks and/or too close clicks. In the second stage it groups the clicks which are not too far and may be removed in single step. This results a relatively larger audio portion to be restored (interpolated). Benefit of this grouping is lesser number of interpolators are required to restore/interpolate audio thus giving better output. Different audio types will require different settings for this parameter.


A value of 0 for this parameter will disable grouping process. If input audio contains many clicks near each other and you have disabled grouping, it is possible that interpolation process will use previously self interpolated signal. This may cause discontinuities in output.

Value of 100 will try to group as much clicks as possible. For input audio containing relatively far clicks and few clicks, a value of 100 may result in grouping of too far clicks, thus causing valuable portion of input audio to be replaced by interpolated one.


Work of this parameter largely depends on the nature of input audio and clicks/pops in it.


Boolean value that specifies if filter will try to recover damaged pitch in the process of interpolation. Please note that it is not necessary that pitch is always damaged in interpolation.


Supported values are the following:

Mnemonic constant





The filter will not try to recover damaged pitch



The filter will try to recover damaged pitch in the process of interpolation



Return value






Negative value

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

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.