Asynch

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.