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 Effects COM object.
Syntax
[Visual Basic]
control.Effects.VolumeAutomationLevelApply (
nStartPosition as Long,
nEndPosition as Long,
nAffectedChannel as enumChannelsMask
) as enumErrorCodes
|
|
[C++]
short control.Effects.VolumeAutomationLevelApply (
long nStartPosition,
long nEndPosition,
short nAffectedChannel
);
|
|
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:
Mnemonic constant
|
Value
|
Meaning
|
CHANNEL_MASK_0
|
1 (0x01)
|
Channel 0 or left channel
|
CHANNEL_MASK_1
|
2 (0x02)
|
Channel 1 or right channel
|
CHANNEL_MASK_2
|
4 (0x04)
|
Channel 2
|
CHANNEL_MASK_3
|
8 (0x08)
|
Channel 3
|
CHANNEL_MASK_4
|
16 (0x10)
|
Channel 4
|
CHANNEL_MASK_5
|
32 (0x20)
|
Channel 5
|
CHANNEL_MASK_6
|
64 (0x40)
|
Channel 6
|
CHANNEL_MASK_7
|
128 (0x80)
|
Channel 7
|
CHANNEL_MASK_LEFTS
|
85 (0x55)
|
All left channels
|
CHANNEL_MASK_RIGHTS
|
170 (0xAA)
|
All right channels
|
CHANNEL_MASK_ALL
|
255 (0xFF)
|
All available channels
|
|
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.
|
|
