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]
objActiveDcam.Grab


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


Parameters

None  


Return Values


S_OK  
Success  
E_ABORT  
Timeout occured  
E_NOINTERFACE  
Camera has been unplugged  
E_ACCESSDENIED  
Camera not found  
E_FAIL  
Failure  
 
Example

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

ActiveDcam1.Grab
ActiveDcam1.SaveImage "image1.tif"
 

Remarks


If the Asynch property is set to TRUE, the Grab method will initiate the continuous acquisition and return after the first frame is acquired to the memory. Subsequent calls to the Grab method will return when the most recent frame is acquired to the memory.

If the Asynch property is set to FALSE, the method will initiate a single frame acquisition (One Shot mode) and return after the frame is acquired to the memory.

The FrameAcquired event will be raised after the Grab call is completed.


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.