Remarks
Applies a Playback Rate change to the given portion of sound under editing. A change to the playback rate will cause a change to both sound tempo and pitch, as if an LP disc was played at wrong RPM rate. The use of this method will speed up/down the sound playback, the sound duration will be altered and voices will result altered also; if you don't want to alter voices, use the Effects.TempoApply method.
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 EffectsMan class.
Syntax
[Visual Basic]
Public Function PlaybackRateApply (
nStartPosition as Int32,
nEndPosition as Int32,
fPlaybackRatePerc as Single
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes PlaybackRateApply (
Int32 nStartPosition,
Int32 nEndPosition,
float fPlaybackRatePerc
);
|
|
[C++]
public: enumErrorCodes PlaybackRateApply (
Int32 nStartPosition,
Int32 nEndPosition,
float fPlaybackRatePerc
);
|
|
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.
|
fPlaybackRatePerc
|
Playback Rate increment/decrement expressed in percentage. Supported values are from -90 to 90.
|
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.
|
|