Name
get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback — Abfrage einer Callback-Funktion eines Bildeinzugsgeräts.
Der Operator get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback liefert eine bestimmte
Callback-Funktion für das durch AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle angegebene
Bildeinzugsgerät. Falls die Callback-Funktion zuvor via
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback registriert wurde, enthält
CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction einen Zeiger darauf, andernfalls NULL. Weiterhin
wird in UserContextUserContextUserContextUserContextUserContextuserContext auch der Zeiger auf die benutzerspezifischen
Kontextdaten zurückgegeben, der beim Aufruf von
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback angegeben wurde (oder NULL).
Mit dem Parameter CallbackTypeCallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackType können verschiedene
Callback-Typen abgefragt werden. Typische Werte sind:
- 'exception':
Der Bildeinzug hat eine Fehlerbehandlung
ausgelöst.
- 'exposure_end':
Die Belichtung des nächsten Bildes ist beendet.
- 'exposure_start':
Die Belichtung des nächsten Bildes ist gestartet.
- 'transfer_end':
Ein neues Bild ist verfügbar und kann mit
grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync abgeholt werden.
Abhängig von der Funktionalität des darunterliegenden API sind auch
weitere Werte für CallbackTypeCallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackType möglich. Alle tatsächlich
verfügbaren Callback-Typen für ein bestimmtes Bildeinzugsgerät können durch
den Aufruf von get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam mit dem Parameter
'available_callback_types' abgefragt werden. Nähere Informationen
finden sich in der Dokumentation der verwendeten Bildeinzugsschnittstelle.
Ein AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle kann grundsätzlich nicht von mehreren Threads
gleichzeitig verwendet werden. Etwaige Ausnahmen sind in der spezifischen
Dokumentation des jeweiligen Image Acquisition Interfaces aufgeführt.
Unterschiedliche Handles können in jeweils eigenen
Threads genutzt werden.
Aus Sicht einer Anwendung mit mehreren Threads bilden alle
Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber aufgelistet)
eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber,
open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und
close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.
get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback läuft mit allen nicht exklusiven
Operatoren innerhalb und außerhalb der Gruppe parallel.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Zu benutzendes Bildeinzugsgerät.
Callback-Typ.
Defaultwert:
'transfer_end'
"transfer_end"
"transfer_end"
"transfer_end"
"transfer_end"
"transfer_end"
Wertevorschläge: 'exception'"exception""exception""exception""exception""exception", 'exposure_end'"exposure_end""exposure_end""exposure_end""exposure_end""exposure_end", 'exposure_start'"exposure_start""exposure_start""exposure_start""exposure_start""exposure_start", 'transfer_end'"transfer_end""transfer_end""transfer_end""transfer_end""transfer_end"
Zeiger auf die Callback-Funktion.
Zeiger auf benutzerspezifische Kontextdaten.
Ist das Bildeinzugsgerät geöffnet und wird der angegebene Callback-Typ
unterstützt, liefert get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback den Wert 2 (H_MSG_TRUE).
Ansonsten wird eine Fehlerbehandlung durchgeführt.
open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback
grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage,
grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData,
grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart,
grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync,
grab_data_asyncgrab_data_asyncGrabDataAsyncgrab_data_asyncGrabDataAsyncGrabDataAsync,
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam,
close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber
open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber,
info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback
Foundation