Datastead TVideoGrabber SDK

Opens a video clip within a specified start time and stop time.

Declaration
function OpenPlayerAtTimePositions (StartTime: LargeInteger; StopTime: LargeInteger; KeepBounds: Boolean; CloseAndReopenIfAlreadyOpened: Boolean): Boolean;

bool __fastcall OpenPlayerAtTimePositions(__int64 StartTime, __int64 StopTime, bool KeepBounds, bool CloseAndReopenIfAlreadyOpened)

Function OpenPlayerAtTimePositions(StartTime As Double, StopTime As Double, CloseAndReopenIfAlreadyOpened as String) As Boolean

Description

Opens a video clip that will start and stop playing within boundaries between specified start and stop time.
StartTime and StopTime are expressed in 100ns units (e.g. 2.5 seconds = 25000000).


StartTime:
opens the clip starting from this frame time (0 = from beginning)

StopTime:
stops playing the clip at this frame time (0 = until the end)

KeepBounds:
- true:
. when invoking StopPlayer the position returns to the StartTime position
. when the clip is paused, it is not possible to set a position before StartTime or after StopTime
- false:
. when invoking StopPlayer the position returns at the frame time 0
. when the clip is paused, it is possible to set a position before StartTime or after StopTime


CloseAndReopenIfAlreadyOpened:
- true:
if OpenPlayerAtTimePositions is invoked again the clip is reopened
- false:
if OpenPlayerAtTimePositions is invoked again the start and stop positions are updated to the specified positions



Notes:
- when the video clip has already been opened and the CloseAndReopenIfAlreadyOpened parameter is false, invoking this function lets you modify the playing boundaries, without closing/reopening the video clip
- to specify only a start time and let the clip play until the end, set StopTime = 0
- to specify only a stop time and let the clip play from the beginning, set StartTime = 0
- to reset the normal clip boundaries, set StopTime = 0 and StartTime = 0

E.g. OpenPlayerAtFramePositions (30000000, 60000000) plays the clip within 3 seconds and the 6 seconds (starting from the beginning).

See Also
Player features TOnPlayerStateChanged TPlayerState TOnPlayerBufferingData AudioChannelRenderMode AudioStreamNumber AutoStartPlayer AVIDuration AVIHeaderInfo AVIInfo AVIInfo2 ClosePlayer FastForwardPlayer IsPlayerAudioStreamAvailable IsPlayerVideoStreamAvailable Last_Clip_Played OnPlayerBufferingData OnPlayerEndOfStream OnPlayerStateChanged OnPlayerUpdateTrackbarPosition OpenPlayer OpenPlayerAtFramePositions PausePlayer PlayerAudioCodec PlayerAudioRendering PlayerDuration PlayerDVSize PlayerFastSeekSpeedRatio PlayerFileName PlayerForcedCodec PlayerFrameCount PlayerFramePosition PlayerFrameRate PlayerFrameStep PlayerRefreshPausedDisplay PlayerRefreshPausedDisplayFrameRate PlayerSpeedRatio PlayerTimePosition PlayerTrackBar PlayerTrackBarScale PlayerTrackBarSynchrone PlayerVideoCodec RewindPlayer RunPlayer RunPlayerBackwards ShowDialog SourceStream StopPlayer SynchronizationRole Synchronized VideoHeight_PreferredAspectRatio VideoWidth_PreferredAspectRatio