文章目录
- 前言
- 二、Getting Started
- 2.1. 运行HDevelop
- 2.2. 运行示例程序
前言
标题本来想用“开始使用”或“快速上手”,不过感觉怪怪的,干脆就叫Getting Started吧,因为许多开发手册,开始上手的那节就叫这个名字。
本文是接上一篇文的,都是HDevelop用户手册的内容,所以直接是章节二了。
二、Getting Started
2.1. 运行HDevelop
HALCON安装就不专门花章节介绍了,接下来的内容假设你已经正确安装好HALCON(在Windows下,不讨论Linux和macOS下的使用)。
开始对话框
开始对话框提供了:
①对HDevelop程序的快速访问
②入门材料(快速向导等)
③文档(用户指南)
若第一次使用HDevelop,建议先看“入门向导”下的内容。
关闭开始对话框按下 Esc 键即可(也可以点击右下角的关闭)。如果不小心关掉了开始对话框,可以通过HDevelop菜单中“帮助”中的启动对话框再打开。
上图界面中序号标注表示:
①图形窗口
②算子窗口
③程序窗口
④变量窗口
⑤菜单
⑥工具栏
⑦状态栏
用户界面
第一次打开HDevelop,看起来类似上图界面,主窗口提供了一个菜单(⑤)和一个工具栏(⑥),用于快速访问使用频繁的功能。窗口底部的状态栏(⑦)会显示一些消息和图像属性。此外,以下窗口默认也是可用的:
- 图形窗口
该窗口会显示图像数据(iconic data):images、regions、XLDs。它也提供了独立的工具栏用于快速缩放和移动显示的图像,并且提供了环境菜单(鼠标右键显示的菜单栏)用于调整视觉设置。HDevelop支持任意数量的图形窗口。 - 算子窗口
在该窗口中,你可以选择HALCON算子(和HDevelop程序)。所选算子的参数可以被指定,且算子也可以被执行,也可以加入到当前程序中。你也可以从该窗口中访问所选算子的在线帮助文档。 - 程序窗口
该窗口显示当前程序。它提供了用户可自定义颜色的语法高亮。左侧列会显示程序的行号。小黑三角是插入光标(缩写为IC,Insert Cursor,后面会以缩写表示),它是将添加新程序行的位置。
绿色箭头是程序计数器(缩写为PC,Program Counter),用于标记将要执行的下一行。你可以在当前程序的该列中添加或移除一个断点(BP,Break Point)。这将使程序暂停在用户指定的位置,以便查检查中间结果。
- 变量窗口
程序变量可以在该窗口中监测。它会显示当前程序所有的变量以及值。图像变量(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