grab_imageT_grab_imageGrabImageGrabImagegrab_image (Operator)
Name
grab_imageT_grab_imageGrabImageGrabImagegrab_image
— Synchroner Einzug eines Bildes vom angegebenen Bildeinzugsgerät.
Signatur
Beschreibung
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image
zieht über das durch AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle
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_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
und set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
vorgenommen
werden.
Der Abbruch des Bildeinzugs kann mit dem Operator
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_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.
Achtung
Aus Sicht einer Anwendung mit mehreren Threads bilden alle
Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
aufgelistet)
eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
,
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber
und
close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers
exklusiv ausgeführt werden.
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image
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
ImageImageImageImageimageimage
(output_object) image →
objectHImageHObjectHImageHobject * (byte / uint2)
Eingezogenes Bild.
AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle
(input_control) framegrabber →
HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Zu benutzendes Bildeinzugsgerät.
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_image(Image,AcqHandle)
close_framegrabber(AcqHandle)
Ergebnis
Wenn der Bildeinzug erfolgreich verlaufen ist, liefert grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image
den Wert TRUE. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
,
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
Nachfolger
grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start
,
grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async
,
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber
Siehe auch
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
,
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
Modul
Foundation