Asynch
Top  Previous  Next

Description

Enables/disables the asynchronous mode for video acquisition.

Syntax


[VB]
objActiveDcam.Asynch [= Value]


[C/C++]
HRESULT get_Asynch ( bool *pAsynch );
HRESULT put_Asynch( bool Asynch );


Data Type
[VB]

Boolean


Parameters
[C/C++]

pAsynch [out,retval]  
Pointer to the Boolean that is TRUE if the asynchronous acquisition is enable, or FALSE otherwise  
Asynch [in]  
Set to TRUE to enable the asynchronous acquisition, or set to FALSE for synchronous acquisition  


Return Values


S_OK  
Success  
E_FAIL  
Failure.  

Example


This VB example sets the acquisition in the asynchronous mode:

ActiveDcam1.Asynch = 
True

MsgBox ActiveDcam1.Asynch
 

Remarks


If this property is set to TRUE, the camera will continuously transfer pixels into the internal image memory, allowing your application to perform other tasks while the acquisition of the next frame occurs. The asynchronous mode provides the fastest and most efficient setup for real-time image processing. However, if processing occurs at a slower rate than pixels are acquired, using this mode may result in the decomposition of images and loss of data.    

Setting the Asynch property to FALSE will set the board to the synchronous mode. In this mode the acquisition of the next frame will be initiated upon calling the Grab method. The synchronous mode is slower, but it guarantees the wholeness of images during real-time processing.