Grab
Top  Previous  Next

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]
objActiveGeni.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()
ActiveGeni1.Acquire=False
End Sub


Private Sub
 Button_Click()
ActiveGeni1.Grab
ActiveGeni1.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.