Remarks
Applies a filter that removes the main component of the lead vocal from 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 methods related to the use of special effects refer to the Effects COM object.
Syntax
[Visual Basic]
control.Effects.VocalRemovalApply (
nStartPosition as Long,
nEndPosition as Long,
nVoiceAttenuation as Integer,
nSoundGain as Integer,
nCutoffFrequency as Long
) as enumErrorCodes
|
|
[C++]
short control.Effects.VocalRemovalApply (
long nStartPosition,
long nEndPosition,
short nVoiceAttenuation,
short nSoundGain,
long nCutoffFrequency
);
|
|
Parameter
|
Description
|
|
|
nStartPosition
|
Start position, expressed in milliseconds, of the affected sound range.
|
nEndPosition
|
End position, expressed in milliseconds, of the affected sound range.. If set to -1 the end position will be set to the end of the sound.
|
nVoiceAttenuation
|
Numeric value representing the filter name.
Numeric value representing the voice attenuation factor expressed in percentage.
This parameter can assume values from 0 to 100 where 0 means that no attenuation is performed on the lead vocal while 100 means that the lead vocal is totally attenuated: a background reverb of the lead voice could be still heard because, trying to remove this reverb, could cause the song to be attenuated in other components that need to remain as they are.
|
nSoundGain
|
Numeric value representing the gain applied to the filtered sound expressed in percentage. Typically this parameter should be set to 100 which leaves the original sound level unchanged during filtering; values under 100 reduce the sound level while values above 100 amplify the sound level.
|
nCutoffFrequency
|
Numeric value representing the cutoff frequency, expressed in Hz, under which the algorithm is not applied. For obtaining best results, typically this parameter should be set to values around 200.
|
Return value
Value
|
Meaning
|
|
|
Negative value
|
An error occurred (see the LastError property for further error details)
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful.
|
|
