|
Effects.ChorusApply method |
  
|
|
Effects.ChorusApply method |
|
Remarks
Applies a chorus effect to the given portion of sound under editing.
True vintage chorus works the same way as flanging. It mixes a varying delayed signal with the original to produce a large number of harmonically related notches in the frequency response. Chorus uses a longer delay than flanging, so there is a perception of "spaciousness", although the delay is too short to hear as a distinct slap-back echo. There is also little or no feedback, so the effect is more subtle.
During the execution of the editing session the CallbackEditPerc delegate is invoked in order to notify about the percentage of advancement.
For further details about callback delegates see the How to synchronize the container application with the API tutorial.
For further details about methods related to the use of special effects refer to the EffectsMan class.
Syntax
[Visual Basic] Public Function ChorusApply ( nStartPosition as Int32, nEndPosition as Int32, nAffectedChannel as enumChannelMasks, fDryMix as Single, fWetMix as Single, fFeedback as Single, fMinSweep as Single, fMaxSweep as Single, fRate as Single ) as enumErrorCodes |
[C#] public enumErrorCodes ChorusApply ( Int32 nStartPosition, Int32 nEndPosition, enumChannelMasks nAffectedChannel, float fDryMix, float fWetMix, float fFeedback, float fMinSweep, float fMaxSweep, float fRate ); |
[C++] public: enumErrorCodes ChorusApply ( Int32 nStartPosition, Int32 nEndPosition, enumChannelMasks nAffectedChannel, float fDryMix, float fWetMix, float fFeedback, float fMinSweep, float fMaxSweep, float fRate ); |
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. |
||||||||||||||||||||||||||||||||||||
nAffectedChannel |
Numeric value that determines the combination of affected channels. Supported values are the following:
|
||||||||||||||||||||||||||||||||||||
fDryMix |
Numeric value representing the Dry (unaffected) signal mix. Supported values are in the range from -2 to +2. |
||||||||||||||||||||||||||||||||||||
fWetMix |
Numeric value representing the Wet (affected) signal mix. Supported values are in the range from -2 to +2. |
||||||||||||||||||||||||||||||||||||
fFeedback |
Numeric value representing the output signal to feed back into input. Supported values are in the range from -1 to +1. |
||||||||||||||||||||||||||||||||||||
fMinSweep |
Numeric value representing the minimum delay expressed in milliseconds. Supported values are in the range from 0 to 6000. |
||||||||||||||||||||||||||||||||||||
fMaxSweep |
Numeric value representing the maximum delay expressed in milliseconds. Supported values are in the range from 0 to 6000. |
||||||||||||||||||||||||||||||||||||
fRate |
Numeric value representing the rate of delay change in milliseconds per second. Supported values are in the range from 0 to 1000. |
The fDryMix is the volume of input signal and the fWetMix is the volume of delayed signal. The fFeedback sets feedback of chorus. The fRate, fMinSweep and fMaxSweep parameters control how fast and far the frequency notches move. The fRate is the rate of delay change in milliseconds per second, fMaxSweep-fMinSweep is the range or width of sweep in milliseconds.
Below some sample:
Effect type |
fDryMix |
fWetMix |
fFeedback |
fMinSweep |
fMaxSweep |
fRate |
|
|
|
|
|
|
|
Flanger |
1.0 |
0.35 |
0.5 |
1.0 |
5.0 |
1.0 |
Exaggerated chorus leads to multiple pitch shifted voices |
0.7 |
0.25 |
0.5 |
1.0 |
200.0 |
50.0 |
Motorcycle |
0.9 |
0.45 |
0.5 |
1.0 |
100.0 |
25.0 |
Devil |
0.9 |
0.35 |
0.5 |
1.0 |
50.0 |
200.0 |
Who say that there are not many voices? |
0.9 |
0.35 |
0.5 |
1.0 |
400.0 |
200.0 |
Back chipmunk |
0.9 |
-0.2 |
0.5 |
1.0 |
400.0 |
400.0 |
Water |
0.9 |
-0.4 |
0.5 |
1.0 |
2.0 |
1.0 |
This is the airplane |
0.3 |
0.4 |
0.5 |
1.0 |
10.0 |
5.0 |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.NOERROR (0) |
The method call was successful. |
