Remarks
Executes a frames grabbing session whose output will be stored inside a set of memory bitmaps. After completing the grabbing session, you can enumerate all of the grabbed frames through the combination of the VideoPlayer.FrameGrabberResultsGetBitmapsCount and VideoPlayer.FrameGrabberResultsGetBitmap methods.
For further details about frames grabbing see the How to grab frames from video files tutorial.
For further details about the use of the embedded video player see the VideoPlayer object section.
For details about video clips rendering refer to the How to play video files through DirectShow tutorial.
Syntax
[Visual Basic]
control.VideoPlayer.FrameGrabberExecToMemory (
nPlayer as Integer,
nStopType as enumVideoGrabberStopTypes,
nStartPosition as Long,
nEndPosition as Long,
nNumberOfFrames as Long
) as Long
|
|
[C++]
long control.VideoPlayer.FrameGrabberExecToMemory (
short nPlayer,
short nStopType,
long nStartPosition,
long nEndPosition,
long nNumberOfFrames
);
|
|
Parameter
|
Description
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will use the video player.
|
nStopType
|
Condition under which the stop of the grabbing session will occur.
Supported values are the following:
Mnemonic value
|
Value
|
Meaning
|
VIDEOGRABBER_STOP_POSITION
|
0
|
When this option is selected, the beginning of the grabbing is defined by the value set into the nStartPosition and the end of the grabbing is defined by the value set into the nEndPosition parameter. In this case the nNumberOfFrames parameter is ignored.
|
VIDEOGRABBER_STOP_FRAMES_NUM
|
1
|
When this option is selected, the beginning of the grabbing is defined by the value set into the nStartPosition and the end of the grabbing will occur after grabbing the number of frames set into the nNumberOfFrames parameter. In this case the nEndPosition parameter is ignored.
|
|
nStartPosition
|
Start position, expressed in milliseconds, where the grabbing session will begin. The value 0 represents the sound's beginning.
|
nEndPosition
|
Stop position, expressed in milliseconds, where the grabbing session will end. The value -1 represents the end of the video clip.
This parameter is ignored if the nStopType parameter is set to VIDEOGRABBER_STOP_FRAMES_NUM.
|
nNumberOfFrames
|
Number of frames to grab before stopping the grabbing session.
This parameter is ignored if the nStopType parameter is set to VIDEOGRABBER_STOP_POSITION.
|
Return value
Value
|
Meaning
|
|
|
0
|
An error occurred (check the LastError property for error details)
|
Other values
|
The method call was successful and the returned value represents the handle (HBITMAP) of the waveform's bitmap stored in memory
|
|
