grab_image_start
— Start eines asynchronen Bildeinzugs vom angegebenen Bildeinzugsgerät.
grab_image_start
startet den asynchronen Bildeinzug über
das durch AcqHandle
spezifizierten Bildeinzugsgerät. Der
gewünschte Betriebsmodus des Bildeinzugsgeräts sowie ein passender
Bildausschnitt kann mittels open_framegrabber
eingestellt
werden. Weitere Schnittstellen-spezifische Einstellungen können
gegebenenfalls mit set_framegrabber_param
vorgenommen
werden.
Der Abschluss des Bildeinzuges erfolgt dann mittels grab_image_async
bzw. grab_data_async
. Der Parameter MaxDelay
ist obsolet
und hat keinen Einfluss auf das neue eingezogene Bild. Um festzustellen,
ob ein eingezogenes Bild zu alt ist, kann dagegen der Parameter
MaxDelay
des Operators grab_image_async
bzw.
grab_data_async
verwendet werden.
Beachten Sie, dass der Operator grab_image_start
nur in Verbindung
mit grab_image_async
oder grab_data_async
sinnvoll
ist. Falls stattdessen grab_image
oder grab_data
aufgerufen
werden, wird der mit grab_image_start
begonnene asynchrone
Bildeinzug abgebrochen und ein neuer, synchroner Bildeinzug gestartet.
Der Abbruch des Bildeinzugs kann mit dem Operator
set_framegrabber_param
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.
Aus Sicht einer Anwendung mit mehreren Threads bilden alle
Bildeinzugsoperatoren (wie in open_framegrabber
aufgelistet)
eine eigene Gruppe innerhalb der info_framegrabber
,
open_framegrabber
, close_framegrabber
und
close_all_framegrabbers
exklusiv ausgeführt werden.
grab_image_start
läuft mit allen nicht exklusiven
Operatoren innerhalb und außerhalb der Gruppe parallel.
AcqHandle
(input_control) framegrabber →
(handle)
Zu benutzendes Bildeinzugsgerät.
MaxDelay
(input_control) number →
(real)
Dieser Parameter ist obsolet und hat keinen Einfluss auf das neue eingezogene Bild.
Defaultwert: -1.0
Wertevorschläge: -1.0, 20.0, 33.3, 40.0, 66.6, 80.0, 99.9
* 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)
Ist das Bildeinzugsgerät geöffnet und unterstützt es den asynchronen
Bildeinzug, liefert grab_image_start
den Wert 2 (H_MSG_TRUE).
Ansonsten wird eine Fehlerbehandlung durchgeführt.
open_framegrabber
,
set_framegrabber_param
grab_image_async
,
grab_data_async
,
set_framegrabber_param
,
close_framegrabber
open_framegrabber
,
info_framegrabber
,
set_framegrabber_param
Foundation