VideoPlayer.LoadForTempoChange method
Remarks
Loads a video from the specified file and predispose it for use with tempo, playback rate and pitch change.
Video loading and rendering is performed through DirectShow so, in order to load a certain video format (like MPEG, MP4, AVI, etc.) the specific codec must be available on the target system or calls to this method would fail. One of the best packages containing most audio and video codecs for DirectShow is
K-Lite Codec Pack and can be downloaded for free from the following
link.
NOTE ABOUT TEMPO AND PLAYBACK RATE CHANGE: It's important to note that not all of the video codecs are able to manage playback rate change correctly: for example certain kind of AVI codecs will loose synchronism between audio and video when calling the
SetTempoPerc or the
SetRatePerc methods: this is not a limitation of our control but a defect of the codec when running the video at a speed different than normal. Furthermore, other video codecs are not fast enough in order to provide enough PCM sound data for tempo and/or playback rate change so you could experience "stuttering" during playback: when dealing with codecs that cause stuttering during playback it would be a better solution using the
VideoPlayer.Load method.
A successful call to this method will fire the
SoundLoaded event.
For further details about the use of the embedded video player see the
VideoPlayer object section.
Syntax
|
[Visual Basic]
control.VideoPlayer.LoadForTempoChange (
nPlayer as Integer,
strFilename as String
|
|
[C++]
short control.VideoPlayer.LoadForTempoChange (
short nPlayer,
LPCTSTR strFilename
);
|
|
Parameter
|
Description
|
|
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will use the video player.
|
|
strFilename
|
String containing the name of the song file to load. It can be a full path name (ex. c:\mysounds\sound.mp3) or a filename (ex: sound.mp3) if the SoundsDirectory property has already been specified.
|
Return value
|
Value
|
Meaning
|
|
|
|
|
Negative value
|
An error occurred, check the LastError property value in order to get the error code |
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful
|
