grab_dataT_grab_dataGrabDataGrabDatagrab_data (算子名称)

名称

grab_dataT_grab_dataGrabDataGrabDatagrab_data — Synchronous grab of images and preprocessed image data from the specified image acquisition device.

参数签名

grab_data( : Image, 区域, Contours : AcqHandle : Data)

描述

The operator grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data grabs images and preprocessed image data via the image acquisition device specified by AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle. 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_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber and set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param. Depending on the current configuration of the image acquisition device, the preprocessed image data can be returned in terms of images (ImageImageImageImageimageimage), regions (区域区域区域区域区域区域), XLD contours (ContoursContoursContoursContourscontourscontours), and control data (DataDataDataDatadatadata).

To abort the grab, the operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_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.

注意

For a multithreaded application, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively.

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

运行信息

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

参数表

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

Grabbed image data.

区域区域区域区域区域区域 (output_object) region(-array) → object

Preprocessed image regions.

ContoursContoursContoursContourscontourscontours (output_object) xld_cont(-array) → object

Preprocessed XLD contours.

AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (input_control) framegrabber → (handle)

Handle of the acquisition device to be used.

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

Preprocessed control data.

例程 (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Open image acquisition device using the default settings, see
* documentation of the actually used interface for more details
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',-1,-1,AcqHandle)
* Grab and segment image
grab_data (Image, Region, Contours, AcqHandle, Data)
* Process Region...
close_framegrabber(AcqHandle)

结果

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

可能的前置算子

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param

可能的后置算子

grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start, grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber

参考其它

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param

模块

Foundation

算子列表