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.
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