Datastead TVideoGrabber SDK

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

Declaration
function OpenPlayerAtFramePositions (StartFrame: LargeInteger; StopFrame: LargeInteger; KeepBounds: Boolean; CloseAndReopenIfAlreadyOpened: Boolean): Boolean;

bool __fastcall OpenPlayerAtFramePositions(__int64 StartFrame, __int64 StopFrame, bool KeepBounds, bool CloseAndReopenIfAlreadyOpened)

Function OpenPlayerAtFramePositions(StartFrame As Double, StopFrame As Double, KeepBounds as Boolean, CloseAndReopenIfAlreadyOpened as Boolean)As Boolean

Description

Opens a video clip that will start and stop playing within boundaries between specified start and stop frames.

StartFrame:
opens the clip starting from this frame number (0 = from beginning)

StopFrame:
stops playing the clip at this frame number (0 = until the end)

KeepBounds:
- true:
. when invoking StopPlayer the position returns to the StartFrame location
. when the clip is paused, it is not possible to set a position before StartFrame or after StopFrame
- false:
. when invoking StopPlayer the position returns at the frame number 1
. when the clip is paused, it is possible to set a position before StartFrame or after StopFrame


CloseAndReopenIfAlreadyOpened:
- true:
if OpenPlayerAtFramePositions is invoked again the clip is reopened
- false:
if OpenPlayerAtFramePositions 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 frame and let the clip play until the end, set StopFrame = 0
- to specify only a stop frame and let the clip play from the beginning, set StartFrame = 0
- to reset the normal clip boundaries, set StopFrame = 0 and StartFrame = 0

E.g. OpenPlayerAtFramePositions (100, 900) plays the clip within the 100th and the 900th frames.

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 OpenPlayerAtTimePositions 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