grab_image_startT_grab_image_startGrabImageStartGrabImageStart (Operator)

Name

grab_image_startT_grab_image_startGrabImageStartGrabImageStart — Start eines asynchronen Bildeinzugs vom angegebenen Bildeinzugsgerät.

Signatur

Beschreibung

grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart startet den asynchronen Bildeinzug über das durch AcqHandleAcqHandleAcqHandleAcqHandleacqHandle spezifizierten Bildeinzugsgerät. Der gewünschte Betriebsmodus des Bildeinzugsgeräts sowie ein passender Bildausschnitt kann mittels open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber eingestellt werden. Weitere Schnittstellen-spezifische Einstellungen können gegebenenfalls mit set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam vorgenommen werden.

Der Abschluss des Bildeinzuges erfolgt dann mittels grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync bzw. grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync. Der Parameter MaxDelayMaxDelayMaxDelayMaxDelaymaxDelay ist obsolet und hat keinen Einfluss auf das neue eingezogene Bild. Um festzustellen, ob ein eingezogenes Bild zu alt ist, kann dagegen der Parameter MaxDelayMaxDelayMaxDelayMaxDelaymaxDelay des Operators grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync bzw. grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync verwendet werden.

Beachten Sie, dass der Operator grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart nur in Verbindung mit grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync oder grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync sinnvoll ist. Falls stattdessen grab_imagegrab_imageGrabImageGrabImageGrabImage oder grab_datagrab_dataGrabDataGrabDataGrabData aufgerufen werden, wird der mit grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart begonnene asynchrone Bildeinzug abgebrochen und ein neuer, synchroner Bildeinzug gestartet.

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 alle 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_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart 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

Beispiel (HDevelop)

* Select a suitable image acquisition interface named AcqName.
open_framegrabber('AcqName', 1, 1, 0, 0, 0, 0, 'default', -1, 'default', \
                  -1.0, 'default', 'default', 'default', -1, -1, AcqHandle)
* Start asynchronous grabbing.
grab_image_start(AcqHandle, -1)
* Run acquisition loop.
while (true)
    * Get image, start next grab.
    grab_image_async(Image, AcqHandle, -1.0)
    * Next: Do something with the grabbed image.
endwhile
close_framegrabber(AcqHandle)

Ergebnis

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

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam

Nachfolger

grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam

Modul

Foundation