|
SoundComposer.ItemSoundFileDurationStretch method |
  
|
|
SoundComposer.ItemSoundFileDurationStretch method |
|
Remarks
Stretches the duration of the sound file by modifying its tempo and without changing the original pitch. After the time stretch, the updated duration can be obtained through the SoundComposer.ItemSoundFileDurationGet method.
The tempo change algorithm is always applied on the full sound file: a call to this method will return an error if the loading range should have been modified through the SoundComposer.ItemSoundFileLoadRangeSet method.
This setting is ignored when more than one loop is requested through the SoundComposer.ItemSoundFileLoopSet method.
For further details about sound composing see the the SoundComposerMan class and the How to compose a sound tutorial.
Syntax
[Visual Basic] Public Function ItemSoundFileDurationStretch ( nUniqueId as Int32, nDurationMs as Int32 ) as enumErrorCodes |
[C#] public enumErrorCodes ItemSoundFileDurationStretch ( Int32 nUniqueId, Int32 nDurationMs ); |
[C++] public: enumErrorCodes ItemSoundFileDurationStretch ( Int32 nUniqueId, Int32 nDurationMs ); |
Parameter |
Description |
|
|
nUniqueId |
The unique identifier of the sound file item previously returned by the call to one of the following methods: SoundComposer.ItemSoundFileAdd, SoundComposer.ItemSoundFileMemoryAdd, SoundComposer.ItemSoundFileRawAdd, SoundComposer.ItemSoundFileMemoryRawAdd, SoundComposer.ItemSoundFileFromEditorAdd, or SoundComposer.ItemSoundFileFromRecorderAdd. |
nDurationMs |
The modified duration expressed in milliseconds |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.NOERROR (0) |
The method call was successful. |
