ClassesClassesClassesClasses | | | | Operators

grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData (Operator)

Name

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

Signature

grab_data( : Image, Region, Contours : AcqHandle : Data)

Herror grab_data(Hobject* Image, Hobject* Region, Hobject* Contours, const Hlong AcqHandle, char* Data)

Herror T_grab_data(Hobject* Image, Hobject* Region, Hobject* Contours, const Htuple AcqHandle, Htuple* Data)

Herror grab_data(Hobject* Image, Hobject* Region, Hobject* Contours, const HTuple& AcqHandle, char* Data)

Herror grab_data(Hobject* Image, Hobject* Region, Hobject* Contours, const HTuple& AcqHandle, HTuple* Data)

HImage HImage::GrabData(HRegion* Region, HXLDCont* Contours, const HFramegrabber& AcqHandle, char* Data)

HImageArray HImageArray::GrabData(HRegionArray* Region, HXLDContArray* Contours, const HFramegrabber& AcqHandle, HTuple* Data)

HImageArray HFramegrabber::GrabData(HRegion* Region, HXLDCont* Contours, HTuple* Data) const

void GrabData(HObject* Image, HObject* Region, HObject* Contours, const HTuple& AcqHandle, HTuple* Data)

HRegion HImage::GrabData(HXLDCont* Contours, const HFramegrabber& AcqHandle, HTuple* Data)

HRegion HImage::GrabData(HXLDCont* Contours, const HFramegrabber& AcqHandle, HString* Data)

HImage HRegion::GrabData(HXLDCont* Contours, const HFramegrabber& AcqHandle, HTuple* Data)

HImage HRegion::GrabData(HXLDCont* Contours, const HFramegrabber& AcqHandle, HString* Data)

HImage HFramegrabber::GrabData(HRegion* Region, HXLDCont* Contours, HTuple* Data) const

HImage HFramegrabber::GrabData(HRegion* Region, HXLDCont* Contours, HString* Data) const

void HOperatorSetX.GrabData(
[out] IHUntypedObjectX*Image, [out] IHUntypedObjectX*Region, [out] IHUntypedObjectX*Contours, [in] VARIANT AcqHandle, [out] VARIANT* Data)

IHRegionX* HImageX.GrabData(
[out] IHXLDContX*Contours, [in] IHFramegrabberX* AcqHandle, [out] VARIANT* Data)

IHImageX* HRegionX.GrabData(
[out] IHXLDContX*Contours, [in] IHFramegrabberX* AcqHandle, [out] VARIANT* Data)

IHImageX* HFramegrabberX.GrabData(
[out] IHRegionX*Region, [out] IHXLDContX*Contours, [out] VARIANT* Data)

static void HOperatorSet.GrabData(out HObject image, out HObject region, out HObject contours, HTuple acqHandle, out HTuple data)

HRegion HImage.GrabData(out HXLDCont contours, HFramegrabber acqHandle, out HTuple data)

HRegion HImage.GrabData(out HXLDCont contours, HFramegrabber acqHandle, out string data)

HImage HRegion.GrabData(out HXLDCont contours, HFramegrabber acqHandle, out HTuple data)

HImage HRegion.GrabData(out HXLDCont contours, HFramegrabber acqHandle, out string data)

HImage HFramegrabber.GrabData(out HRegion region, out HXLDCont contours, out HTuple data)

HImage HFramegrabber.GrabData(out HRegion region, out HXLDCont contours, out string data)

Description

The operator grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData grabs images and preprocessed image data via the image acquisition device specified by AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle. 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_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber and set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam. Depending on the current configuration of the image acquisition device, the preprocessed image data can be returned in terms of images (ImageImageImageImageImageimage), regions (RegionRegionRegionRegionRegionregion), XLD contours (ContoursContoursContoursContoursContourscontours), and control data (DataDataDataDataDatadata).

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

Attention

For a multithreaded application all image acquisition operators (as listed in open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber) are an own group in which info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber and close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers are executed exclusively.

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

Parallelization

Parameters

ImageImageImageImageImageimage (output_object)  image(-array) objectHImageHImageHImageHImageXHobject * (byte / real / uint2)

Grabbed image data.

RegionRegionRegionRegionRegionregion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Preprocessed image regions.

ContoursContoursContoursContoursContourscontours (output_object)  xld_cont(-array) objectHXLDContHXLDContHXLDContHXLDContXHobject *

Preprocessed XLD contours.

AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle (input_control)  framegrabber HFramegrabber, HTupleHTupleHFramegrabber, HTupleHFramegrabberX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the acquisition device to be used.

DataDataDataDataDatadata (output_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Preprocessed control data.

Example (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)

Example (C)

/* 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(&Region,AcqHandle) ;
/* Process Region... */
close_framegrabber(AcqHandle) ;

Example (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)

Example (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)

Example (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)

Example (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)

Result

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

Possible Predecessors

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam

Possible Successors

grab_data_asyncgrab_data_asyncGrabDataAsyncgrab_data_asyncGrabDataAsyncGrabDataAsync, grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart, grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage, grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber

See also

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam

Module

Foundation


ClassesClassesClassesClasses | | | | Operators