Methods > Players and stream mixers

Remarks

Changes the sound to play at faster or slower speed than original, without affecting the sound pitch so voices won't result altered. The current tempo percentage can be obtained through the GetTempoPerc method. The current effective playback rate ratio, that may be also affected by the SetRatePerc method, can be obtained through the PlaybackRateRatioGet method.

This method doesn't work with sounds with more than 2 channels (5.1 or 7.1) or if the EnableMixingFeatures property has been set to BOOL_FALSE.

When dealing with video clips, calls to this method will have no effect if the video clip has not been loaded with the VideoPlayer.LoadForTempoChange, VideoPlayer.LoadFromMemoryForTempoChange, VideoPlayer.LoadFromMemorySyncForTempoChange or VideoPlayer.LoadSyncForTempoChange methods.

After a successful call to this method, the duration of the song will change: the new duration, expressed in seconds, is notified through the SoundDurationChanged event. The new duration can also be obtained through the SoundDurationGet and SoundDurationStringGet methods by setting the bKeepCountOfRateChange parameter to "BOOL_TRUE".

Further details about songs mixing can be found inside the How to mix your songs section.

Syntax

[Visual Basic]

control.SetTempoPerc (

nPlayer as Integer,

fTempoPerc as single

) as enumErrorCodes

[C++]

short control.SetTempoPerc (

short nPlayer,

float fTempoPerc

);

Parameter	Description

nPlayer	Number representing the zero-based index of the involved player
fTempoPerc	The Tempo variation expressed in percentage; supported values are from -90 to 90. Setting this parameter to 0 will set the original sound tempo value. Usually best mixing results are obtained with values from -15 to 15.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The call was successful.