COM Objects > Effects object > Methods > Effects.PlaybackRateApply method

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 Effects COM object.

Syntax

[Visual Basic]

control.Effects.PlaybackRateApply (

nStartPosition as Long,

nEndPosition as Long,

fPlaybackRatePerc as Single

) as enumErrorCodes

[C++]

short control.Effects.PlaybackRateApply (

long nStartPosition,

long 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.