get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback (算子)
名称
get_framegrabber_callbackT_get_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback — 查询图像采集设备的回调功能。
签名
描述
算子 get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback queries a callback function
for the image acquisition device specified by AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle. If the
callback function was registered via set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback
before, CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunctioncallback_function contains a pointer to it, otherwise
NULL. Furthermore, UserContextUserContextUserContextUserContextuserContextuser_context contains a pointer to the
user-specific context data that was set via
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback (or NULL).
With the parameter CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type, you can select different callback
types. Suggested values are:
- 'exception'：
The image acquisition has raised an exception.
- 'exposure_end'：
The exposure of the next image has been finished.
- 'exposure_start'：
The exposure of the next image has been started.
- 'transfer_end'：
A new image is ready to be fetched
by grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async。
Depending on the functionality of the underlying API, additional values
for CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type are possible. All actually supported callback
types of a specific image acquisition device can be queried by
calling get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param with the parameter
'available_callback_types'. For more details see the
documentation of the specific image acquisition interface.
注意
For a multithreaded application,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively.
get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback runs in parallel with all non-exclusive
operators inside and outside of this group.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (输入控制) framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the acquisition device to be used.
CallbackTypeCallbackTypeCallbackTypeCallbackTypecallbackTypecallback_type (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Callback type.
默认值：
'transfer_end'
"transfer_end"
"transfer_end"
"transfer_end"
"transfer_end"
"transfer_end"
建议值：
'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 (输出控制) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Pointer to the callback function.
UserContextUserContextUserContextUserContextuserContextuser_context (输出控制) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Pointer to user-specific context data.
结果
If the image acquisition device is open and the specified callback type
is supported, the operator get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback 返回值 2 ( H_MSG_TRUE )。否则将抛出异常。
可能的前趋
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback
可能的后继
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
另见
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber,
set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback
模块
基础