机器视觉_HALCON_HDevelop用户指南_2.Getting Started

---

前言

标题本来想用“开始使用”或“快速上手”，不过感觉怪怪的，干脆就叫Getting Started吧，因为许多开发手册，开始上手的那节就叫这个名字。

本文是接上一篇文的，都是HDevelop用户手册的内容，所以直接是章节二了。

二、Getting Started

2.1. 运行HDevelop

HALCON安装就不专门花章节介绍了，接下来的内容假设你已经正确安装好HALCON（在Windows下，不讨论Linux和macOS下的使用）。

开始对话框

开始对话框提供了：
①对HDevelop程序的快速访问
②入门材料（快速向导等）
③文档（用户指南）

若第一次使用HDevelop，建议先看“入门向导”下的内容。
关闭开始对话框按下 Esc 键即可（也可以点击右下角的关闭）。如果不小心关掉了开始对话框，可以通过HDevelop菜单中“帮助”中的启动对话框再打开。

上图界面中序号标注表示：
①图形窗口
②算子窗口
③程序窗口
④变量窗口
⑤菜单
⑥工具栏
⑦状态栏

用户界面
第一次打开HDevelop，看起来类似上图界面，主窗口提供了一个菜单（⑤）和一个工具栏（⑥），用于快速访问使用频繁的功能。窗口底部的状态栏（⑦）会显示一些消息和图像属性。此外，以下窗口默认也是可用的：

1. 图形窗口
   该窗口会显示图像数据（iconic data）：images、regions、XLDs。它也提供了独立的工具栏用于快速缩放和移动显示的图像，并且提供了环境菜单（鼠标右键显示的菜单栏）用于调整视觉设置。HDevelop支持任意数量的图形窗口。
2. 算子窗口
   在该窗口中，你可以选择HALCON算子（和HDevelop程序）。所选算子的参数可以被指定，且算子也可以被执行，也可以加入到当前程序中。你也可以从该窗口中访问所选算子的在线帮助文档。
3. 程序窗口
   该窗口显示当前程序。它提供了用户可自定义颜色的语法高亮。左侧列会显示程序的行号。小黑三角是插入光标（缩写为IC，Insert Cursor，后面会以缩写表示），它是将添加新程序行的位置。
   

绿色箭头是程序计数器（缩写为PC，Program Counter），用于标记将要执行的下一行。你可以在当前程序的该列中添加或移除一个断点（BP，Break Point）。这将使程序暂停在用户指定的位置，以便查检查中间结果。

4. 变量窗口
   程序变量可以在该窗口中监测。它会显示当前程序所有的变量以及值。图像变量（iconic）显示为缩略图，而控制变量显示为文本。窗口的布局可以通过双击分割线来切换至水平或者垂直布局。
   
   也可以双击图像变量来将其显示在活动的图形窗口中。双击控制变量会打开一个监测窗口，里面有当前值的列表和统计数据。

除了上面提到的四种主要窗口，还有许多其他窗口，后面会介绍。

2.2. 运行示例程序

HALCON有大量各种应用领域的示例程序。这些程序涵盖很广，从演示HALCON或HDevelop单个功能的简单程序到完整的机器视觉解决方案。本文作为对HDevelop的介绍，推荐你尝试跑一下其中一些程序来快速适应HDevelop的工作方式。

示例程序“了解HALCON强大的功能（Explore the Power of HALCON）”，它在一个程序中演示了HALCON的许多不同功能。你可以从开始对话框中启动它。强烈推荐运行该程序以对HALCON的应用领域有个大致认识。

当从开始对话框加载时，“了解HALCON强大的功能”的示例程序会自动启动。在手动加载它或其他示例程序后，点击运行或按下 F5 以开始运行。

示例程序会以应用范围（application area）、工业领域（industry）、方法（method）和算子（operator）用途进行分类。一个特殊的分类“版本新信息”，根据特定版本的发布时间对示例进行分组。通过浏览这些分类，你可以快速找到你想用HALCON解决的图像处理问题的示例程序。这些程序也许会成为你所要开发的工程的基础。

浏览和加载示例程序

• 点击 文件>浏览HDevelop示例程序
  
  这将会打开一个示例程序浏览器。与文件浏览器（文件资源管理器）相似，它会在左侧展示一棵主题树，并在右侧展示所选主题的示例程序列表。
  点击对应的图标或双击分类名，子主题可切换展开状态。

  • 浏览分类：点击以选中主题并显示其中的示例程序。还可以在保持 Ctrl 键按下时，点击多个分类，以选中多个主题。
  • 过滤示例程序：要减少所列出示例程序的数量，可以在 查找文本框 中输入关键字。随后，只有匹配关键字的示例程序会显示在右侧列表中。
    
    

  假设你正在寻找一个半导体行业测量的示例：
  1. 双击工业领域主题
  2. 点击子主题半导体业。半导体业的示例就会显示在右侧。
  3. 在查找文本框输入关键字
  随着你输入关键字，显示的列表在更新。现在，示例程序的列表变得很短了。你也许需要调整示例浏览框来阅读列出程序的介绍。
  4. 点击选中 measure_ic_leads.hdev
  5. 点击 打开。选中的示例程序会被加载（当然你也可以双击打开）。示例浏览器被关闭，除非你保持对话框打开。
  
  上图是加载了示例程序后的变量窗口和程序窗口，序号标注的区域分别表示：
  ①图像变量
  ②控制变量
  ③PC
  ④当前程序
  示例程序加载后，其代码会显示在程序窗口。PC（程序计数器）被设在程序的第一个执行行（前面的注释会被忽略）。变量窗口也会被更新：窗口中会列出主程序中用到的变量，主程序最初就是当前程序。目前，变量未实例化，即它们的值是未定义的（undefined）。未定义的值用 ? 表示。

运行示例程序

• 点击 执行>运行 或 点击工具栏中对应的按钮
  PC的下一行程序会被执行，同时PC也会移动到下一行，直到执行停止。程序执行的停止有四个原因：1）程序的最后一行已经被执行， 2）到达了一个断点， 3）遇到了HDevelop的停止指令，就像本例一样， 4）遇到了一个错误。
  
  执行期间，图形窗口用于可视化。变量的改变会反映在变量窗口中。程序停止执行时，状态栏上会显示执行行的行数和执行时间。
  想要继续执行程序，再次点击 执行>运行 直到到达程序的末尾。

• 点击 重置程序执行 来将程序重置到初始状态。

• 使用 单步跳过函数 按钮，你可以一行行执行程序，并检查每条指令的即时效果。

上图为基本的执行按钮，图中序号标注的四个重要按钮分别为：
①不间断执行
②单步执行（单步跳过函数）
③停止
④重置程序执行

命令行开关
HDevelop支持多个命令行开关，用以修改其启动行为。你也可以在命令行添加HDevelop程序路径和文件名来直接加载它。这与不带任何参数的调用和随后的程序加载是一样的。Windows语法中，程序名也许包含环境变量，如下：
hdevelop %HALCONEXAMPLES%/hdevelop/explore_halcon.hdev

或者，你可以在完全不打开图形界面的情况下，将HDevelop程序转化为其他编程语言。使用以下命令可以获得支持的命令行开关的完整列表：
hdevelop --help