Operator Reference

grab_data_asyncT_grab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async (Operator)

grab_data_asyncT_grab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async — Asynchronous grab of images and preprocessed image data from the specified image acquisition device.

Signature

grab_data_async( : Image, Region, Contours : AcqHandle, MaxDelay : Data)

Description

The operator grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async requests asynchronously grabbed images and preprocessed image data from the image acquisition device specified by AcqHandleAcqHandleAcqHandleacqHandleacq_handle. By default, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async also starts the next asynchronous grab before the operator returns. More information about the behavior of a specific image acquisition device can be found in the corresponding interface documentation in the directory doc/html/reference/acquisition. The desired operational mode of the image acquisition device as well as a suitable image part and additional interface-specific settings can be specified using the operators open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber and set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param. Depending on the current configuration of the image acquisition device, the preprocessed image data can be returned in terms of images (ImageImageImageimageimage), regions (RegionRegionRegionregionregion), XLD contours (ContoursContoursContourscontourscontours), and control data (DataDataDatadatadata).

The grab of the next image is finished by calling grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async or grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncgrab_image_async. If more than MaxDelayMaxDelayMaxDelaymaxDelaymax_delay ms have passed since the asynchronous grab was started, the asynchronously grabbed image is considered as too old and a new image is grabbed, if necessary. If a negative value is assigned to MaxDelayMaxDelayMaxDelaymaxDelaymax_delay, this control mechanism is deactivated.

To abort the grab, the operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param with the parameter 'do_abort_grab' can be used if the specific image acquisition interface supports it. Note that as an exception from the description of the concurrent usage in multiple threads (see below) 'do_abort_grab' can also be used from another thread.

Please note that if you call the operators grab_imagegrab_imageGrabImageGrabImagegrab_image or grab_datagrab_dataGrabDataGrabDatagrab_data after grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async, the asynchronous grab started by grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async is aborted and a new synchronous grab is started.

Attention

For a multithreaded application, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively.

grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async runs in parallel with all non-exclusive operators inside and outside of this group.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ImageImageImageimageimage (output_object) image(-array) → object (byte / real / uint2)

Grabbed image data.

RegionRegionRegionregionregion (output_object) region(-array) → object

Pre-processed image regions.

ContoursContoursContourscontourscontours (output_object) xld_cont(-array) → object

Pre-processed XLD contours.

AcqHandleAcqHandleAcqHandleacqHandleacq_handle (input_control) framegrabber → (handle)

Handle of the acquisition device to be used.

MaxDelayMaxDelayMaxDelaymaxDelaymax_delay (input_control) number → (real)

Maximum tolerated delay between the start of the asynchronous grab and the delivery of the image [ms].

Default: -1.0

Suggested values: -1.0, 20.0, 33.3, 40.0, 66.6, 80.0, 99.9

DataDataDatadatadata (output_control) string(-array) → (string / real / integer / handle)

Pre-processed control data.

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',-1,-1,AcqHandle)
* Grab image, segment it, and start next grab
grab_data_async (Image1, Region1, Contours1, AcqHandle, -1.0, Data1)
* Process data 1...
* Finish asynchronous grab, segment this image, and start next grab
grab_data_async (Image2, Region2, Contours2, AcqHandle, -1.0, Data2)
* Process data 2...
close_framegrabber(AcqHandle)

Result

If the image acquisition device is open and supports the image acquisition via grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async, the operator grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncgrab_data_async returns the value 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

Possible Predecessors

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, grab_image_startgrab_image_startGrabImageStartGrabImageStartgrab_image_start, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param

Possible Successors

grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncgrab_image_async, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamset_framegrabber_param, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber

Module

Foundation

Operators