应用篇01-开发系统搭建

Jason 2008

已于 2025-04-14 13:03:37 修改

阅读量318

点赞数 2

CC 4.0 BY-SA版权

分类专栏：基于Halcon的机器视觉实践-应用篇文章标签：计算机视觉图像处理人工智能机器学习 C++

于 2025-03-18 11:44:01 首次发布

本文链接：https://blog.csdn.net/ahhjian/article/details/146337458

基于Halcon的机器视觉实践-应用篇专栏收录该内容

6 篇文章

订阅专栏

本节将简要介绍如何搭建基于Halcon的机器视觉开发环境，将为后续的各种应用做好准备。

1. 安装Halcon

虽然有第三方提供Halcon安装软件，但考虑到完整性和后面软件激活的需要，最好还是从官网下载最新版本的安装文件。

1.1 软件下载

进入HALCON中文官网下载界面（https://www.mvtec.com/cn/downloads）。第一次登录时，需要账号登录，所以需要用邮箱注册并登录。

如下图所示，点击下载 HALCON，选择需要的版本下载。

点击上图的下载图标后，进入到软件版本选择界面，如下图所示。

根据电脑的操作系统以及对应的架构，选择合适的版本。下图所示为Window11下安装最新版的24.11版。点击“完整版”按钮，会自动下载单个压缩文件至本地。

为了后面激活方便，提前准备好对应版本的许可（license）文件，这个要根据所安装的Halcon版本，以及安装时间来选取。以截止到2025年3月最新的Halcon版本（版本号24.11）为例，它对应的许可文件名是license_eval_halcon_progress_2025_03.dat，具体方式大家可自行搜索。

注意，该许可文件支持的Halcon版本包括24.05和24.11 ，其他版本不再支持。另外，每月更新一次许可文件。

1.2 安装主程序

（1）进入安装界面

将下载的压缩文件halcon-24.11.1.1-x64-win64.zip进行解压。进入HALCON-24.11.1.0-x64-win64文件夹，右键点击【som.exe】文件，选择以【管理员身份运行】（这一步至关重要，务必用管理员身份运行）。

（2）设置安装路径

点击右上角【环境】按钮，设置程序和数据路径（建议修改默认路径），如下图所示。

注意：不建议随便修改安装路径，否则容易出现找不到安装文件的报错。

（3）安装选择

用户选择：在安装页面上选择语言为中文（CN），选中第二个所有用户安装。如下图所示。
安装类型选择：选择安装类型为【高级安装】，简易安装会省略一些部件，比如GenICam、GigeVision、USB采集接口、VS调试插件。
安装包选择：选择【全部】。
配置选择：一定要选【激活安装】。
加载安装组件：耐心等待几分钟。
加载用户许可：需要滚动滑鼠到最下方，方可激活"接受"按钮。
安装主程序：需要几分钟，耐心等待，可能提示安装插件，默认选是即可。
完成安装：我们选择退出软件管理器，记得退出SOM，否则可能导致服务8188端口服务仍然在运行中，下次无法正常开启。

1.3 加载许可文件

请将之前下载的许可证文件粘贴放在Halcon安装路径下的license文件夹下，再启动HDevelop，就OK了。

再次强调，记得每月更新一次许可文件，虽然麻烦一点，但至少能用。

2 开发界面介绍

下图所示是HDevelopEVO主窗口，各个部件的功能介绍如下：

First Activity Bar（第一活动栏）位于窗口的左侧，可让您快速访问不同的视图，例如资源管理器视图、搜索视图和调试视图。它是核心导航界面。当您点击活动栏中的某个项目时，主侧边栏会在右侧打开，您可以在其中查看和管理相应活动栏项目的内容。
Menu Bar（菜单栏）在窗口的顶部。功能强大，后面详细介绍。
在Central Space（中央区域），您可以找到欢迎页面，当您首次启动 HDevelopEVO 时，该页面会向您显示几个直接链接，如 Open Folder > Open Example Folder。这里也是打开编辑器选项卡的区域。
右侧是Secondary Activity Ba（次要活动栏），其功能与活动栏类似，点击它会打开次要面板。
在Graphics View（图形视图）中会显示您的图形，它也是次要活动栏的一部分。
您可以在Iconic Variables View（图标变量视图）中检查图标变量，它同样是次要活动栏的一部分。
窗口下方的Bottom Panel（底部面板）会显示输出信息、调试控制台和问题列表。
Status Bar（状态栏）位于窗口的底部，会显示有关您正在编辑的文件、所使用的 HALCON 版本以及已打开工作区的信息。

但我们使用更多的是HDevelop开发窗口，如下图所示：

图形窗口：显示（中间）结果，即图像、区域和 XLD 等图标数据。
程序窗口：您在此处输入程序代码，通过使用算子来调用 HALCON 的图像处理方法。
变量窗口：显示所有变量，即图标变量和控制变量。图标变量包含图标数据，而控制变量包含控制数据。

3 测试

下面介绍两种测试实例。一种是本机测试，涉及到简单的图像处理操作。另一种是带摄像头的测试，需要一个外接USB摄像头。两个实例均来自Halcon官方文档。

3.1 图像直方图均衡化处理

该实例完成针对灰度图像的直方图均衡化处理。具体步骤是：

读入图像，做灰度化处理，显示原图和灰度图；
计算直方图，显示直方图；
均衡化处理，显示处理结果图。

实现代码：

*读取并显示待处理图像
read_image (Image, 'pollen.jpg')
get_image_size (Image, Width, Height)
dev_close_window ()
dev_open_window_fit_size (0, 0, Width, Height, -1, -1, WindowHandle)
dev_display (Image)

*灰度化处理
rgb1_to_gray (Image, GrayImage)
*计算图像的灰度值分布
gray_histo (GrayImage, GrayImage, AbsoluteHisto, RelativeHisto)
*获得灰度直方图
gen_region_histo (Region, RelativeHisto, 255, 255, 1)
*在原图上绘制灰度直方图
dump_window (WindowHandle, 'jpg', 'histgram')

*直方图均衡化处理
equ_histo_image (GrayImage, ImageEquHisto)
*保存处理结果
dump_window (WindowHandle, 'jpg', 'result')

处理过程如下图所示：