FrameReady

Description

This event is fired each time a decoded frame is submitted for display.

Syntax

[VB]
Private Sub objActiveDcam_FrameReady()

[C/C++]
HRESULT Fire_FrameReady();


Parameters [C/C++]

None

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This MFC fragment uses the FrameReady event to perform a post-processing of the color video:

....

m_ActiveGige.SetDisplay(FALSE)

....

void CGcamProDlg::OnFrameReadyActivedcam1()

{

BYTE *ptr=m_ActiveDcam.GetImagePointer(0, m_ActiveDcam.GetSizeY()-1);

int nSize=m_ActiveDcam.GetSizeX()*m_ActiveDcam.GetSizeY();

int max=255;

for(int y=0;y<nSize;y++,ptr++)

*ptr=(*ptr+16)*2;

m_ActiveDcam.SetDraw(TRUE);

}

Remarks

The FrameReady event is fired from ActiveDcams display thread which is running separately from the acquisition thread. This allows your post-processing routine to take advantage of a multi-processor or multi-core architecture. Note that If the post-processing procedure is not fast enough, it will only affect the display frame rate and will not result in missed frames in the acquisition thread.

In order to synchronize the post-processing with image display, the Display property should be set to False and Draw method used in the end of the event handler.

One of the following conditions must be met, before the FrameReady event will be fired:

The Acquire property has been set to TRUE

The Grab method has been called.