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_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 FALSE (synchronous acquisition), the Grab method will wait for the current frame to be acquired before returning. If the asynchronous mode is selected, the method will initiate the acquisition and return immediately. This will allow your application to perform other tasks while the frame is being acquired. When the acquisition of the current frame is complete, the FrameAcquired event will be raised.
   

If the continuous acquisition mode is selected (the Acquire property is set to TRUE), the Grab method will not affect the acquisition process, however you can use it to delay your application until the current frame is completed.