三千幻想乡

在HALCON算子手册中，对算子的介绍通常包含HALCON原生程序、C#、C++以及C四种语言的介绍。本文以介绍HALCON原生程序下的算子（用其它语言联合HALCON开发，肯定要能看懂HALCON原生示例程序）的形式来学习该算子。虽然标题的CreateScaledShapeModel是大驼峰命名法，是C#和C++采用的命名，但这是因为我以往文章标题是以下划线分段的，为了美观和避免歧义，我才使用了驼峰式命名（不然标题就变成了。

但在开启采集之后，设置就会报如下错误（比如上面"Width"和"Height"的设置）。于是，我查阅了算子文档中的内容，发现里面并没有这部分的描述，甚至第一个参数的建议值都没有出现"Width"、“Height”、“Gain”。这使得我不太敢继续往下写相机初始化和修改配置的代码。在我一番查阅后，发现有一个文档叫，简单翻阅了一下，了解到该文档主要描述了如何创建一个HALCON图像采集接口，以及如何将第三方图像采集硬件集成到HALCON系统所需的基本技术。

本文是HALCON的programmers_guide（编程指南）中的2.2章节，章节名直译是——用HALCON进行并行编程，实际上就是多线程编程嘛。因为HALCON是机器视觉软件，涉及图像处理，图像处理往往就会牵扯到多线程，所以这章非常重要。它会给你一些多线程编程的建议与参考。实话讲，看完这节，并没有给我带来很大的启发。

使用HALCON联合C#进行开发时，若用HDevelop导出代码，可以在导出的代码文件中看到类似下面的代码，从用户手册中可以知道，ho_为前缀的ho_Image是一个图像变量（当然，根本原因是HObject类是图像类）。在ho_Image从图像设备中获取图像前，还有一行代码加这行代码的理由如上图所述，导出的C#代码中图像对象由HObject表示，但是从GC的角度看，HObject是非常小的，因此可能会被忽略。

在选择图像采集接口时，用户可以设置相应的设备参数，如图像格式等。在成功与所选的图像采集接口建立连接后，可以在活动的图形窗口中抓取并显示图像。使用实时图像时，可以交互式地调节所选接口支持的参数（交互式调节就是可以GUI操作，并且可以马上从图形窗口中看到反馈）。要设置一个通用参数，请从列表中选择，并编辑分配的值，即 = 后面的值。这个设备ID，实际上是由设备的多个参数组合而成的，其中就包括设备物理地址。还能指示助手生成HDevelop代码，该代码将连接到所选的图像采集接口，设置指定的参数并捕获图像。

整个过程其实并不复杂，毕竟我们只是调用算子，不需要关注算法细节。但这里还是得稍微总结一下，阈值化，拿到图之后通常会先阈值化一下，方便后续处理。选取ROI，获取一个形状，然后用该形状去裁剪原图。

按照HDevelop用户指南/手册的章节顺序，代码导出是第十章的内容。但6789这四章，是偏查阅的内容，不是那种流程介绍的。拿第六章GUI来说，里面子章节对HDevelop中的各种窗口做详细说明，显然前期学习阶段没有必要把里面的内容全看一遍，在用到时查阅更好，剩下的789章同理。从个人使用的角度来讲，在学完1-5章后，已经对HALCON基本概念和HDevelop基本使用有了一定了解，之后就想把HDevelop的功能导出来，试着集成到自己的程序中。

一般来讲，在HDevelop中使用过程这个概念是对调用HALCON算子概念的延伸，因为过程和算子接口具有相同的参数类型，并且具有相同的传参规则。只有可以在过程调用的插入点解析过程，才能调用过程（即想调用过程，必须能够解析过程）。例如，导入的过程优先于本地过程。一个程序总是包含主过程（程序窗口中的main），主过程在程序中具有特殊的地位，因为它在调用层次结构中，始终处于最顶层，且无法从程序中删除。若在编译的过程中发生错误，整个过程调用将中止，即，PC将不会指出导致错误的实际程序行。

这是一个在HDevelop中创建程序的基本方式。选择一个算子，指定它的参数，使用应用按钮尝试不同的设置值，使用输入或确定添加新的程序行，然后在程序窗口中双击进行编辑。开发过程中，使用HDevelop提供的交互式工具来辅助开发，如，为算子找到合适的阈值。

HDevelop（确切说是底层的HALCON库）支持多种格式的图片，这些格式的图片可以直接被加载（图像加载详情可查阅参考手册中的。这是HDevelop默认的行为，但如果你需要的话，也可以禁止图像的自动显示，如，为了加快计算密集型程序的速度。图像采集助手是一个功能强大的工具，可以通过图像采集接口，从HALCON支持的文件（包括AVI文件）、文件夹和图像采集设备中获取图像。默认设置下，图像是从文件中获取的，下一小节会做详细描述。选项卡包含了所选设备特有的（特有指的是不同设备的参数列表是不同的）参数列表。

标题本来想用“开始使用”或“快速上手”，不过感觉怪怪的，干脆就叫Getting Started吧，因为许多开发手册，开始上手的那节就叫这个名字。本文是接上一篇文的，所以下面直接是章节二了。

看完了HALCON快速向导之后，对HALCON有个大致认识（HALCON基本概念、使用的场景）。但距离实战还差得远，接下来我觉得可以开始学习使用HALCON的IDE——HDevelop。因为实际开发，HALCON相关的工作主要是在HDevelop中进行。HDevelop是一个用于构建机器视觉应用程序的工具箱。它提供了一个高交互性的编程环境用于开发和测试机器视觉应用程序，有助于快速原型的构建。它基于HALCON库，是一个通用的机器视觉包，适用于产品开发、研究和教育。

HALCON很容易被新的算子扩展。尽管HALCON已经包含超过2000个用于处理各种任务的算子，但你仍可能需要新的算子以满足你的需求，例如，为了访问一个特殊的硬件或实现一种非传统的算法。为了做到这些，HALCON提供了扩展包接口（extension package interface），它允许以扩展包的形式集成新算子（在C中实现）。它包含了一些预定义好的规则和宏，用于在C中简单处理图像和内存对象。一旦新的算子被成功集成，它就能像其它HALCON算子那样被使用。

HALCON是MVTec公司的一款软件产品。它是一款风靡全球的、用于机器视觉的标准软件，并带有HDevelop集成开发环境。MVTec是公司名，德国的，从名字上看MVTec就是Machine Vision Technology，机器视觉科技。HALCON是软件名。HDevelop是集成开发环境。使用它可以节省成本并缩短上市时间。HALCON的灵活架构有助于快速开发任何类型的机器视觉程序。它提供了图像、视觉算法，给你灵活调用。不需要自己研发当然可以节省成本和快速开发。