halcon算子翻译——grab

halcon算子翻译——grab_image

名称

grab_image - 从指定的图像采集设备同步抓取图像。

用法

grab_image( : Image : AcqHandle : )

描述

　　算子grab_image通过AcqHandle指定的图像采集设备获取图像。可以使用算子open_framegrabber和set_framegrabber_param来指定图像采集设备所需的操作模式以及合适的图像部分和其他特定于接口的设置。

　　为了中止抓取，如果特定的图像采集接口支持，可以使用带有参数“do_abort_grab”的算子set_framegrabber_param。请注意，作为多线程中并发使用的描述的异常（见下文），“do_abort_grab”也可以从另一个线程中使用。

注意

　　对于多线程应用程序，所有图像采集算子（如open_framegrabber中列出的）都是自己的组，其中info_framegrabber，open_framegrabber，close_framegrabber和close_all_framegrabbers是独占执行的。

　　grab_image与该组内外的所有非独占运算符并行运行。

并行

●　　多线程类型：可重入（与非独占算子并行运行）。
●　　多线程范围：全局（可以从任何线程调用）。
●　　不并行化处理。

参数

Image (output_object) 　　image → object (byte / uint2)
　　采集的图像

AcqHandle (input_control) 　　 framegrabber → (integer)
　　要使用的采集设备的句柄。

Example (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Open image acquisition device using the default settings, see
* documentation of the actually used interface for more details
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, 
                  'default','default','default',-1,-1,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

结果

如果可以成功获取图像，则算子grab_image将返回值2（H_MSG_TRUE）。否则会引发异常。

Possible Predecessors

open_framegrabber, set_framegrabber_param

Possible Successors

grab_image_start, grab_image_async, close_framegrabber

模块

Foundation