Classes > EffectsMan class > Methods > Effects.TempoApply method

Remarks

Applies a Tempo change to the given portion of sound under editing. Changing tempo will cause the sound to play at faster or slower speed than original without affecting the sound pitch so voices won't result altered. The duration of the song will change accordingly.

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 TempoApply (

nStartPosition as Int32,

nEndPosition as Int32,

fTempoPerc as Single

) as enumErrorCodes

[C#]

public enumErrorCodes TempoApply (

Int32 nStartPosition,

Int32 nEndPosition,

float fTempoPerc

);

[C++]

public: enumErrorCodes TempoApply (

Int32 nStartPosition,

Int32 nEndPosition,

float fTempoPerc

);

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.
fTempoPerc	Tempo 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.