halcon算子翻译——get_framegrabber_callback
名称
get_framegrabber_callback - 查询图像采集设备的回调函数。
用法
get_framegrabber_callback( : : AcqHandle, CallbackType : CallbackFunction, UserContext)
描述
算子get_framegrabber_callback查询由AcqHandle指定的图像采集设备的回调函数。 如果之前通过set_framegrabber_callback注册了回调函数,则CallbackFunction包含一个指向它的指针,否则为NULL。 此外,UserContext包含一个指向通过set_framegrabber_callback(或NULL)设置的用户特定上下文数据的指针。
使用参数CallbackType,您可以选择不同的回调类型。 建议值为:
'exception':
图像采集引发了一个异常。
'exposure_end':
下一张照片的曝光已经完成。
'exposure_start':
下一张照片的曝光已经开始。
'transfer_end':
一个新的图像准备好由grab_image_async获取。
根据底层API的功能,CallbackType的附加值是可能的。 通过调用带有参数'available_callback_types'的get_framegrabber_param,可以查询特定图像采集设备实际支持的所有回调类型。 有关更多详细信息,请参阅特定图像采集界面的文档。
注意
对于多线程应用程序,所有图像采集算子(如open_framegrabber中列出的)都是自己的组,其中info_framegrabber,open_framegrabber,close_framegrabber和close_all_framegrabbers是独占执行的。
get_framegrabber_callback与该组内部和外部的所有非独占运算符并行运行。
并行
● 多线程类型:可重入(与非独占算子并行运行)。
● 多线程范围:全局(可以从任何线程调用)。
● 不并行化处理。
参数
AcqHandle (input_control) framegrabber → (integer)
要使用的采集设备的句柄。
CallbackType (input_control) string → (string)
回调类型。
Default value: 'transfer_end'
Suggested values: 'exception', 'exposure_end', 'exposure_start', 'transfer_end'
CallbackFunction (output_control) pointer → (integer)
指向回调函数的指针。
UserContext (output_control) pointer → (integer)
指向用户特定上下文数据的指针。
结果
如果图像采集设备已打开并且支持指定的回调类型,则算子get_framegrabber_callback将返回值2(H_MSG_TRUE)。 否则会引发异常。
Possible Predecessors
open_framegrabber, set_framegrabber_callback
Possible Successors
grab_image, grab_data, grab_image_start, grab_image_async, grab_data_async, set_framegrabber_param, close_framegrabber
See also
open_framegrabber, info_framegrabber, set_framegrabber_callback
模块
Foundation