grab_dataT_grab_dataGrabDataGrabData (Operator)

Name

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

Signatur

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

Beschreibung

grab_datagrab_dataGrabDataGrabDataGrabData zieht über das durch AcqHandleAcqHandleAcqHandleAcqHandleacqHandle 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_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber und set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam vorgenommen werden. Abhängig von der aktuellen Konfiguration des Bildeinzugsgeräts können die vorverarbeiteten Bilddaten in Form von Bildern (ImageImageImageImageimage), Bildregionen (RegionRegionRegionRegionregion), XLD-Konturen (ContoursContoursContoursContourscontours) und Steuerdaten (DataDataDataDatadata) zurückgeliefert werden.

Der Abbruch des Bildeinzugs kann mit dem Operator set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam 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_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber aufgelistet) eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

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

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

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

Eingezogene Bilddaten.

RegionRegionRegionRegionregion (output_object) region(-array) → object

Vorverarbeitete Bildregionen.

ContoursContoursContoursContourscontours (output_object) xld_cont(-array) → object

Vorverarbeitete XLD-Konturen.

AcqHandleAcqHandleAcqHandleAcqHandleacqHandle (input_control) framegrabber → (handle)

Zu benutzendes Bildeinzugsgerät.

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

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)

Ergebnis

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

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam

Nachfolger

grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart, grab_imagegrab_imageGrabImageGrabImageGrabImage, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam

Modul

Foundation

Operatoren