Grab

Description

Grabs a single frame into the internal memory. If the Display property is enabled, the frame will be automatically displayed in the control window.


Syntax

[VB]
objActiveGige.Grab

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


Parameters

None

Return Values

S_OK

Success

E_ABORT

Timeout occured

E_ACCESSDENIED

Camera not found

E_FAIL

Failure

Example

This VB example grabs a frame and saves it as a tiff file

Private Sub Form_Load()
ActiveGige1.Acquire=False
End Sub

Private Sub Button_Click()
ActiveGige1.Grab
ActiveGige1.SaveImage "image1.tif"
End Sub

Remarks

The Grab method will wait for the current frame to be acquired before returning. When the acquisition of the current frame is complete, the FrameAcquired event will be raised.   

Note that the use of the Grab method is incompatible with the Acquire property set to TRUE. Make sure to set Acquire to FALSE when using Grab.