get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback (Operator)
Name
get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback — Abfrage einer Callback-Funktion eines Bildeinzugsgeräts.
Signatur
Beschreibung
Der Operator get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback liefert eine bestimmte
Callback-Funktion für das durch AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle angegebene
Bildeinzugsgerät. Falls die Callback-Funktion zuvor via
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback registriert wurde, enthält
CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function einen Zeiger darauf, andernfalls NULL. Weiterhin
wird in UserContextUserContextUserContextUserContextuserContextuser_context auch der Zeiger auf die benutzerspezifischen
Kontextdaten zurückgegeben, der beim Aufruf von
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback angegeben wurde (oder NULL).
Mit dem Parameter CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type 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_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async abgeholt werden.
Abhängig von der Funktionalität des darunterliegenden API sind auch
weitere Werte für CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type 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_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param mit dem Parameter
'available_callback_types' abgefragt werden. Nähere Informationen
finden sich in der Dokumentation der verwendeten Bildeinzugsschnittstelle.
Achtung
Aus Sicht einer Anwendung mit mehreren Threads werden info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber,
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber und close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber exklusiv ausgeführt.
get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback 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
AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (input_control) framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Zu benutzendes Bildeinzugsgerät.
CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
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"
CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function (output_control) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Zeiger auf die Callback-Funktion.
UserContextUserContextUserContextUserContextuserContextuser_context (output_control) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Zeiger auf benutzerspezifische Kontextdaten.
Ergebnis
Ist das Bildeinzugsgerät geöffnet und wird der angegebene Callback-Typ
unterstützt, liefert get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback den Wert 2 (H_MSG_TRUE).
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback
Nachfolger
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image,
grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data,
grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start,
grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async,
grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async,
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param,
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber
Siehe auch
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback
Modul
Foundation