在C#中使用Halcon开发视觉检测程序

本文的初衷是希望帮助那些有其它平台视觉算法开发经验的人能快速转入Halcon平台下，通过文中的示例开发者能快速了解一个Halcon项目开发的基本步骤，让开发者能把精力完全集中到算法的开发上面。

首先，你需要安装Halcon，HALCON 18.11.0.1的安装包会放在文章末尾。安装包分开发和运行时两个版本，运行时版本一般用于生产环境。
注：开发版本自带运行时可替代运行时版本，但安装的东西会比较多。

然后，你需要学会查看Halcon的帮助手册，这是很重要的一件事。

本文涉及到帮助文档的主要章节如下：

原文 HALCON 18.11.0.1 / Programmer's Guide / Programming With HALCON/.NET
翻译 HALCON 18.11.0.1/程序员指南/使用 HALCON/.NET 编程

原文 HALCON 18.11.0.1 / HALCON Operator Reference
翻译 HALCON 18.11.0.1/ HALCON 运算符参考

文中的示例是我第一次接触Halcon时的学习测试用例，在电脑里面躺了一年，最近才有时间整理一下发出来，希望能对你有所帮助。

注：运行本文示例程序前至少安装Halcon的运行时，否则Halcon的dll无法正常使用。

将 HALCON/.NET 添加到应用程序#

添加控件#

右键单击工具箱，然后选择“选择项”，弹出的对话框选择“.NET Framework组件”，单击下面的“浏览”，导航到HALCON安装目录下的\bin\dotnet35（VS2008以下版本的选择dotnet20） ，然后选择halcondotnet.dll。

完成上述操作后，HSmartWindowControl和HWindowControl控件就会出现在工具箱中，其中HWindowControl控件已经过时官方不再推荐使用。

与HWindowControl相比，HSmartWindowControl控件具有以下几个优点：

• 可以像任何其他控件一样使用
• 提供预定义的鼠标交互（移动窗口内容并使用鼠标滚轮进行缩放）， 可以通过双击窗口来重置视图
• 控件会自动重新缩放，而不会闪烁

注：与HSmartWindowControlWPF 相反，HSmartWindowControl需要一个回调才能使用鼠标滚轮进行缩放。

引用dll#

在HALCON安装目录下的\bin\dotnet35中，引用以下dll：

• hdevenginedotnet.dll
• halcondotnet.dll

注：使用 HALCON XL 开发应用程序时，必须选择以xl结尾的dll，hhdevelop xl适用于大分辨率的图像（大于 32k x 32k ）。

引用以下命名空间：

• HalconDotNet：控件所在的命名空间
• HalconType：Line、Rectangle2等数据类型所在的命名空间

调用Halcon算子#

以ReadImage操作为例，函数原型如下：

static void HOperatorSet.ReadImage(out HObject image, HTuple fileName)

public HImage(HTuple fileName)

public HImage(string fileName)

void HImage.ReadImage(HTuple fileName)

void HImage.ReadImage(string fileName)

注：这些内容帮助手册上都有，在文章开头列出来的章节。

在C#调用HALCON 算子有两种选择：函数式