grab_image — Synchroner Einzug eines Bildes vom angegebenen Bildeinzugsgerät.
grab_image zieht über das durch AcqHandle
spezifizierte Bildeinzugsgerät ein Bild ein. Der gewünschte Betriebsmodus
des Bildeinzugsgeräts, ein passender Bildausschnitt sowie weitere
Schnittstellen-spezifische Einstellungen können mittels der Operatoren
open_framegrabber und set_framegrabber_param vorgenommen
werden.
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 läuft mit allen nicht exklusiven
Operatoren innerhalb und außerhalb der Gruppe parallel.
Image (output_object) image → object (byte / uint2)
Eingezogenes Bild.
AcqHandle (input_control) framegrabber → (handle)
Zu benutzendes Bildeinzugsgerät.
* 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_image(Image,AcqHandle)
close_framegrabber(AcqHandle)
Wenn der Bildeinzug erfolgreich verlaufen ist, liefert grab_image
den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.
open_framegrabber,
set_framegrabber_param
grab_image_start,
grab_image_async,
close_framegrabber
open_framegrabber,
info_framegrabber,
set_framegrabber_param
Foundation