get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback (Operator)

Name

get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback — Abfrage einer Callback-Funktion eines Bildeinzugsgeräts.

Signatur

get_framegrabber_callback( : : AcqHandle, CallbackType : CallbackFunction, UserContext)

Beschreibung

Der Operator get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallback liefert eine bestimmte Callback-Funktion für das durch AcqHandleAcqHandleAcqHandleAcqHandleacqHandle angegebene Bildeinzugsgerät. Falls die Callback-Funktion zuvor via set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback registriert wurde, enthält CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction einen Zeiger darauf, andernfalls NULL. Weiterhin wird in UserContextUserContextUserContextUserContextuserContext auch der Zeiger auf die benutzerspezifischen Kontextdaten zurückgegeben, der beim Aufruf von set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback angegeben wurde (oder NULL).

Mit dem Parameter CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackType 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_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync abgeholt werden.

Abhängig von der Funktionalität des darunterliegenden API sind auch weitere Werte für CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackType 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_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParam 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 bilden alle Bildeinzugsoperatoren (wie in open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber aufgelistet) eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallback 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

AcqHandleAcqHandleAcqHandleAcqHandleacqHandle (input_control) framegrabber → (handle)

Zu benutzendes Bildeinzugsgerät.

CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackType (input_control) string → (string)

Callback-Typ.

Defaultwert: 'transfer_end' "transfer_end" "transfer_end" "transfer_end" "transfer_end"

Wertevorschläge: 'exception'"exception""exception""exception""exception", 'exposure_end'"exposure_end""exposure_end""exposure_end""exposure_end", 'exposure_start'"exposure_start""exposure_start""exposure_start""exposure_start", 'transfer_end'"transfer_end""transfer_end""transfer_end""transfer_end"

CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction (output_control) pointer → (integer)

Zeiger auf die Callback-Funktion.

UserContextUserContextUserContextUserContextuserContext (output_control) pointer → (integer)

Zeiger auf benutzerspezifische Kontextdaten.

Ergebnis

Ist das Bildeinzugsgerät geöffnet und wird der angegebene Callback-Typ unterstützt, liefert get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallback den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback

Nachfolger

grab_imagegrab_imageGrabImageGrabImageGrabImage, grab_datagrab_dataGrabDataGrabDataGrabData, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber

Siehe auch

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback

Modul

Foundation

Operatoren