Remarks
Applies a previously set volume automation procedure to the given song's range.
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 defining a volume automation procedure refer to the How to define a volume automation procedure section.
For further details about methods related to the use of special effects refer to the EffectsMan class.
Syntax
[Visual Basic]
Public Function VolumeAutomationApply (
nStartPosition as Int32,
nEndPosition as Int32,
nAffectedChannel as enumChannels
) as enumErrorCodes
|
|
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 stereo channel affected by the volume change
Supported values are the following:
Mnemonic constant
|
Value
|
Meaning
|
CHANNELS_BOTH
|
0
|
Both left and right channels will be affected
|
CHANNELS_LEFT
|
1
|
Only left channel will be affected
|
CHANNELS_RIGHT
|
2
|
Only right channel will be affected
|
|
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.
|
|
