GetPicture

Description

Returns a Picture object created from the currently acquired frame.


Syntax

[VB]
Value=objActiveGige.GetPicture()

[C/C++]
HRESULT GetPicture(IPictureDisp* *pPicture);


Data Types [VB]

Return value: Picture


Parameters [C/C++]

pPicture

Pointer to the IPictureDisp interface object

Return Values

S_OK

Success

E_FAIL

Failure.

Example


This VB example uses the FrameAcquired event to display a live video in a PictureBox:
Private Sub ActiveGige1_FrameAcquired(ByVal Lines As Integer)
  Picture1.Picture=ActiveGige1.GetPicture
End Sub

Remarks

The GetPicture method provides the most convenient graphic interface to ActiveGige internal image and allows you to display the last acquired frame in popular graphic controls such as PictureBox. Note that a Picture object contains only 8-bit pixel values, even if the current video mode is a 16- or 48-bit one. To access the actual pixel data, use the GetImageData or GetPointer methods.