C#的视觉库Halcon入门示例

以前写过emgu.cv的视觉库，但翻了一下招聘软件发现，用得比较多的是halcon，以前也有留意过这玩意，一直没动手，今天有空就来试一波，由于是使用公司的电脑，不能安装收费软件halcon，而halcon我看了一下，网上有好多文章介绍的都是安装了halcon包后再使用的，本文介绍的是使用带有halcon运行时的程序，不需要再单独安装halcon

demo示例下载(免费无套路，目前是设置为0积分，有也是csdn自己调的)：
https://download.csdn.net/download/zxy13826134783/92445707

运行环境：

vs2022

win11

示例代码是参考官方文档写的：

https://www.mvtec.com/cn/products/halcon/components-documentation/documentation

下载地址：https://www.mvtec.com/fileadmin/Redaktion/mvtec.com/products/halcon/documentation/halcon/programmers_guide.pdf

切换到9.1节

操作步骤如下：

1 新建名为HalconDemo1的.net framework 4.8控制台项目

2 在nuget中安装halcon，输入halcon后，会看到这两个，我都试过，没带halcon运行的库的，如下图：

我们要往下拉，找到Sun_Halcon19.11这个，安装1.0.0.2版本

3 随便找一张照片，名为test.png，然后放到bin/Debug目录下

4 把项目的目标平台设置x64，如下图：

5 在主程序编写代码如下：

cs 复制代码

using HalconDotNet;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace HalconDemo1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            HImage hImage = new HImage("test.png");
            HRegion region = hImage.Threshold(0d, 122d);
            int numRegions = region.Connection().CountObj();
            Console.WriteLine("Number of Regions: " + numRegions);
            Console.ReadLine();
        }
    }
}

5 程序运行结果如下：

好了，本文的内容到此结束

2025-12-09 新增，输出灰度图：

cs 复制代码

using HalconDotNet;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using static System.Net.Mime.MediaTypeNames;

namespace HalconDemo1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            HObject ho_GrayImage;
            HImage hImage = new HImage("test.png");
            HRegion region = hImage.Threshold(0d, 122d);
            int numRegions = region.Connection().CountObj();
            Console.WriteLine("Number of Regions: " + numRegions);
            // 转换为灰度图（RGB转灰度）
            HOperatorSet.Rgb1ToGray(hImage, out ho_GrayImage);
            //输出灰度图
            HOperatorSet.WriteImage(ho_GrayImage, "jpg", 0, "1.jpg");//灰度图像
            Console.WriteLine("运行完毕");
            Console.ReadLine();
        }
    }
}