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