详解Halcon自定义函数封装方法

有网友说不太清楚这个halcon函数的封装方法。今天写个教程帖子，大家一起进步分享。

1、名词解释

算子：
指Halcon中最基础、最底层的函数（即你看不到它的代码实现），一个算子只有一句话，例如threshold算子。

函数：
由多个算子组合成的函数。其特点是，可以通过鼠标右键单击“显示函数”打开。如下图：

通常，Halcon代码程序窗口中，算子和小函数的代码颜色是有差异的。如下图：

2、例子介绍

1、处理原图与任务：

要求求亮区外圆半径大小。

2、代码与解析：

* 读入图片
read_image (Image, ‘C:/Users/Administrator/Desktop/1.jpg’)

根据图片打开窗口
dev_open_window_fit_image (Image, 0, 0, -1, -1, WindowHandle)

显示图片，用于预览
dev_display (Image)

二值化
binary_threshold (Image, Region, ‘max_separability’, ‘light’, UsedThreshold)

分割连通域
connection (Region, ConnectedRegions)

使用特征筛选去掉小面积区域的干扰
select_shape (ConnectedRegions, SelectedRegions, ‘area’, ‘and’, 5000, 1000000000)

合并区域，为下一步求取最小外接矩形做准备
union1 (SelectedRegions, RegionUnion)

求取最小外接矩形
smallest_circle (RegionUnion, Row, Column, Radius)

生成一个圆形，用于显示
gen_circle (Circle, Row, Column, Radius)

*显示结果前的准备
dev_clear_window ()
dev_set_draw (‘margin’)
dev_set_line_width (3)
dev_set_color (‘red’)

显示相关结果
dev_display (Image)
dev_display (Circle)
disp_message (WindowHandle, ‘圆环半径: ‘+Radius, ‘window’, 50, 50, ‘black’, ‘true’)

3、Halcon函数封装方式

Halcon的函数创建分为以下几个步骤：
1、明确需求，要封装的函数要实现什么功能
2、选取函数部分进行函数创建，更改函数接口，即更改输入输出变量
3、运行验证与函数更改操作

①明确需求

我们拿上边的这个程序举例，我们这个程序完成的任务主要是：求取外接圆的半径并且显示

我们看代码一共分为三个部分：
1.准备阶段：读入图片、打开窗口、预览等工作。
2.处理阶段：进行图像处理，求取结果
3.显示阶段：对结果进行显示
如下图：

明确1：我们需要将第二部分“处理阶段的算子封装成一个函数”

此时我们再看处理阶段的代码，我们由分析可知：
1、此段代码需要一个图片，用于图像处理
2、需要得出圆环外接圆这个结果（外接圆的位置与半径）
由此确定：
传入一个图像变量，传出外接圆的坐标（X,Y）与外接圆的半径
到此需求已经明确。

②选取函数部分进行函数创建，更改函数接口

选中处理阶段函数，右键，点击“创建新函数”。如下图所示：

之后显示页面如下：

首先点击一般设置栏，编辑函数名称（你想把这个函数名叫什么就命什么名），再点击“参数”。
之后显示页面如下：

图标参数含义：即图片、区域、Xld轮廓等图形变量。
变量参数含义：指我们在程序中用得到的整形、浮点型、字符串、数组等变量

我们可以点击添加变量按钮进行输入输出变量的添加操作
如果我们要进行删除变量操作，操作方式如下图：
首先选中变量，点击移除

点击移除后：

也可以通过选中函数后点击“上移”、“下移”更改变量顺序。

我们由需求分析步骤可知，我们需要：
传入一个图像变量，传出外接圆的坐标（X,Y）与外接圆的半径
修改参数页面变量如下，并点击一般文档切换栏目：

一般文档栏目：（可以对函数进行说明性文档的编写）包括了函数的描述、实例程序、参数说明、高级注意事项4个部分。我们一般不进行填写。

点击上图中的参数文档：
参数文档包含了这个函数的详细的参数意义说明：如下图：

我们如果将一般文档和参数文档都填完整那么会出现什么情况呢？
你的函数有了一份像halcon算子一样的说明文档：
即选中一个算子，点击F1出现的算子帮助文档！

完成上述所有步骤点击确定按钮即可生成函数

③运行验证与函数更改操作

点击F5运行程序或者点击F6单步运行程序验证程序的准确性。
当F6单步调试到函数时可以点击F7运行到函数内部执行。点击F8跳出函数执行

如果想查看函数代码，选中函数，点击鼠标右键，选择显示函数即可查看代码：

可以点击红色方框内的后退按钮退出当前函数显示
如下图：
点击蓝色方框内的 按钮，打开函数编辑窗口（即上边我们进行函数名修改、接口参数变化的窗口）

审核编辑：汤梓红