COM Objects > VideoPlayer object > Methods > VideoPlayer.FrameGrabberResultsGetPixelColor method

Remarks

After completing a grabbing session, through a call to one between the VideoPlayer.FrameGrabberExecToFile and VideoPlayer.FrameGrabberExecToMemory methods, given the index of a grabbed frame obtains the color of a pixel at specific coordinates.

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.FrameGrabberResultsGetPixelColor (

nPlayer as Integer,

nFrameIndex as Long,

X as Long,

Y as Long

) as OLE_COLOR

[C++]

OLE_COLOR control.VideoPlayer.FrameGrabberResultsGetPixelColor (

short nPlayer,

long nFrameIndex,

long X,

long Y

);

Parameter

Description

nPlayer

Number representing the zero-based index of the player that will use the video player.

nFrameIndex

Number representing the zero-based index of the grabbed frame. You can obtain the total number of grabbed frames in the following way:

•	if the value returned by the VideoPlayer.FrameGrabberResultsGetAvailableType method is TYPE_OF_GRABBED_FRAME_FILES, call the VideoPlayer.FrameGrabberResultsGetFilesCount method

•	if the value returned by the VideoPlayer.FrameGrabberResultsGetAvailableType method is TYPE_OF_GRABBED_FRAME_BITMAPS, call the VideoPlayer.FrameGrabberResultsGetBitmapsCount method

Horizontal coordinate of the frame expressed in pixels

Vertical coordinate of the frame expressed in pixels

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to get the error code
Other values	The color of the requested pixel