KlassenKlassenKlassenKlassen | | | | Operatoren

grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData (Operator)

Name

grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData — Synchroner Einzug von Bildern und vorverarbeiteten Bilddaten vom angegebenen Bildeinzugsgerät.

Signatur

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)

Beschreibung

grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData zieht über das durch AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle spezifizierte Bildeinzugsgerät Bilder und vorverarbeitete Bilddaten ein. Der gewünschte Betriebsmodus des Bildeinzugsgeräts, ein passender Bildausschnitt sowie weitere Schnittstellen-spezifische Einstellungen können mittels der Operatoren open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber und set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam vorgenommen werden. Abhängig von der aktuellen Konfiguration des Bildeinzugsgeräts können die vorverarbeiteten Bilddaten in Form von Bildern (ImageImageImageImageImageimage), Bildregionen (RegionRegionRegionRegionRegionregion), XLD-Konturen (ContoursContoursContoursContoursContourscontours) und Steuerdaten (DataDataDataDataDatadata) zurückgeliefert werden.

Der Abbruch des Bildeinzugs kann mit dem Operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam erfolgen, sofern die jeweilige Bildeinzugsschnittstelle den dazu notwendigen Parameter 'do_abort_grab' unterstützt. Es ist zu beachten, dass, als Ausnahme von der Beschreibung der gleichzeitigen Verwendung mehrerer Threads (siehe unten), 'do_abort_grab' auch aus einem anderen Thread aufgerufen werden kann.

Achtung

Aus Sicht einer Anwendung mit mehreren Threads bilden die Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber aufgelistet) eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData läuft mit allen nicht exklusiven Operatoren innerhalb und außerhalb der Gruppe parallel.

Parallelisierung

Parameter

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

Eingezogene Bilddaten.

RegionRegionRegionRegionRegionregion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Vorverarbeitete Bildregionen.

ContoursContoursContoursContoursContourscontours (output_object)  xld_cont(-array) objectHXLDContHXLDContHXLDContHXLDContXHobject *

Vorverarbeitete XLD-Konturen.

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

Zu benutzendes Bildeinzugsgerät.

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)

Vorverarbeitete Steuerdaten.

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

Beispiel (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) ;

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

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

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

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

Ergebnis

Ist das Bildeinzugsgerät geöffnet und unterstützt es den Bildeinzug via grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData, liefert grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam

Nachfolger

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

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren