【C# + HALCON 机器视觉】构建通用视觉软件平台：跨行业应用实战

摘要：本文深入探讨基于C#与HALCON开发通用视觉软件平台的技术路径与实践方法，围绕二维码识别、OCR、模板匹配等核心功能，结合模块化设计理念，详细阐述相机参数设置、图像处理、通信模块等技术实现。通过与爱普生机器人配合的定位标定案例，以及印刷品缺陷检测、包装日期识别等应用场景，展示该平台在跨行业领域的应用价值，同时提供完整实操流程与代码示例，助力开发者快速搭建高效、低成本的机器视觉解决方案。

---

---

【C# + HALCON 机器视觉】构建通用视觉软件平台：跨行业应用实战

关键词

C#；HALCON；机器视觉；通用软件平台；二维码识别；OCR；模板匹配；模块化设计

一、引言

在智能制造、工业自动化等领域，机器视觉技术发挥着至关重要的作用。传统的智能相机方案虽然功能强大，但存在开发成本高、灵活性不足等问题。基于C#和HALCON开发的通用视觉软件平台，凭借C#在跨平台开发与界面设计的优势，以及HALCON强大的图像处理与算法能力，能够显著缩短开发周期、降低成本，为中小型制造企业提供了高性价比的视觉解决方案。本文将从技术原理、功能实现、案例应用等方面展开，全面介绍该通用视觉软件平台的开发与应用。

二、技术基础与核心功能概述

2.1 C#与HALCON技术优势

• C#：作为一种面向对象的编程语言，C#拥有丰富的类库和强大的跨平台能力，通过.NET框架能够快速开发图形化用户界面（GUI），并实现与硬件设备的通信。同时，C#的代码易于维护和扩展，适合构建复杂的软件系统。
• HALCON：德国MVtec公司开发的机器视觉算法库，包含超过2000个图像处理算子，提供了亚像素级的高精度匹配、3D变换、深度学习等先进算法，能够处理复杂光照、反光表面等恶劣环境下的图像，在工业视觉领域被广泛应用。

2.2 核心功能模块

1. 图像采集与相机参数设置：实现与工业相机的连接，配置相机的曝光时间、增益、分辨率等参数，完成图像的实时采集。
2. 图像处理：运用HALCON的图像处理算子，进行图像预处理（如二值化、滤波、形态学操作）、特征提取、目标识别等操作。
3. 二维码识别与OCR：集成二维码解码算法和光学字符识别（OCR）技术，实现产品标识、信息读取等功能。
4. 模板匹配：通过HALCON的模板匹配算法，实现对目标物体的定位与检测。
5. 通信模块：支持串口、TCP等通信协议，实现与机器人、PLC等设备的数据交互，完成视觉系统与自动化生产线的协同工作。

三、通用视觉软件平台开发实操流程

3.1 开发环境搭建

1. 安装Visual Studio：选择Visual Studio 2019及以上版本，创建C# Windows Forms应用程序或WPF应用程序。
2. 安装HALCON：下载并安装HALCON开发套件，安装完成后，在Visual Studio中添加HALCON的引用。在项目中右键点击“引用”，选择“添加引用”，在弹出的窗口中找到HALCON安装目录下的halcondotnet.dll文件进行添加。
3. 安装工业相机驱动：根据所使用的工业相机型号，安装对应的驱动程序，确保相机能够正常连接与工作。

3.2 图像采集与相机参数设置

1. 创建相机连接类：新建一个CameraHelper.cs类，用于管理相机连接与参数设置。

using HalconDotNet;
using System;

namespace VisionSoftwarePlatform
{
   
    public class CameraHelper
    {
   
        private HObject ho_Image;
        private HDevWindow hv_Window;
        private HTuple hv_AcqHandle;

        public void OpenCamera()
        {
   
            // 初始化相机连接
            HOperatorSet.OpenFramegrabber("GigE", 1, 1, 0, 0, 0, 0, "default", 8, "rgb", -1,
                "false", "default", "192.168.1.100", 1888, out hv_AcqHandle);

            // 打开图像窗口
            HOperatorSet.OpenWindow(0, 0, 640, 480, 0, "visible", "", out hv_Window);
        }

        public void CloseCamera()
        {
   
            // 关闭相机连接
            HOperatorSet.CloseFramegrabber(hv_AcqHandle);
            // 关闭图像窗口
            HOperatorSet.CloseWindow(hv_Window);
        }

        public HObject GrabImage()
        {
   
            // 采集图像
            HOperatorSet.GrabImage(out ho_Image, hv_AcqHandle);
            return ho_Image;
        }

        public void SetExposureTime(double exposureTime)
        {
   
            // 设置曝光时间
            HOperatorSet.SetFramegrabberParam(hv_AcqHandle, "ExposureTimeAbs", exposureTime);
        }

        public void SetGain(double gain)
        {
   
            // 设置增益
            HOperatorSet.SetFramegrabberParam(hv_AcqHandle, "GainRaw", gain);
        }
    }
}

2. 在界面中调用相机功能：在主窗体的代码中，实例化CameraHelper类，并调用相关方法实现相机的打开、关闭、图像采集以及参数设置。

using System;
using System.Windows.Forms;

namespace VisionSoftwarePlatform
{
   
    public partial class MainForm : Form
    {
   
        private CameraHelper cameraHelper;

        public MainForm()
        {
   
            InitializeComponent();
            cameraHelper = new CameraHelper();
        }

        private void btnOpenCamera_Click(object sender, EventArgs e)
        {
   
            try
            {
   
                cameraHelper.OpenCamera();
                MessageBox.Show("相机打开成功");
            }
            catch (Exception ex)
            {
   
                MessageBox.Show($"相机打开失败: {
     ex.Message}");
            }
        }

        private void btnCloseCamera_Click(object sender, EventArgs e)
        {
   
            try
            {
   
                cameraHelper.CloseCamera();
                MessageBox.Show("相机关闭成功");
            }
            catch (Exception ex)
            {
   
                MessageBox.Show($"相机关闭失败: {
     ex.Message}");
            }
        }

        private void btnGrabImage_Click(object sender, EventArgs e)
        {
   
            try
            {
   
                HObject image = cameraHelper.GrabImage();
                // 在窗口中显示图像
                HWindowControl1.HalconWindow.DispObj(image);
            }
            catch (Exception ex)
            {
   
                MessageBox.Show($"图像采集失败: {
     ex.Message}");
            }
        }

        private void trackBarExposure_ValueChanged(object sender, EventArgs e)
        {
   
            double exposureTime = trackBarExposure.Value / 100.0;
            cameraHelper.SetExposureTime(exposureTime);
            labelExposure.Text = $"曝光时间: {
     exposureTime} s";
        }

        private void trackBarGain_ValueChanged(object sender, EventArgs e)
        {
   
            double gain = trackBarGain.Value / 10.0;
            cameraHelper.SetGain(gain);
            labelGain.Text = $"增益: {
     gain}";
        }
    }
}

3.3 图像处理模块

1. 图像预处理：在ImageProcessing.cs类中实现图像的二值化、滤波、形态学操作等预处理功能。

using HalconDotNet;

namespace VisionSoftwarePlatform
{
   
    public class ImageProcessing
    {
   
        public HObject BinarizeImage(HObject image)
        {
   
            // 使用全局阈值法进行二值化
            HTuple hv_Threshold;
            HOperatorSet.Threshold(image, out HObject ho_Region, 0, 128);
            return ho_Region;
        }

        public HObject FilterImage(HObject image)
        {
   
            // 使用中值滤波去除噪声
            HOperatorSet.MedianImage(image, out HObject ho_FilteredImage, "circle", 3, 3, "mirrored");
            return ho_FilteredImage;
        }

        public HObject MorphologyOperation(HObject region)
        {
   
            // 进行开运算，去除小的噪声区域
            HOperatorSet.OpenCircle(region, out HObject ho_OpenedRegion, 3);
            return ho_OpenedRegion;
        }
    }
}

2. 在主窗体中调用图像处理功能：在图像采集后，调用图像处理类的方法对图像进行处理，并显示处理结果。

private void btnProcessImage_Click(object sender, EventArgs e)