【C#】C# + Halcon实现图像转换Bitmap 转 HImage

已于 2025-05-29 10:21:15 修改
阅读量1.5k 收藏 10
点赞数 3
分类专栏： C# Halcon 文章标签： c# 计算机视觉 图像处理 Halcon
于 2024-08-19 14:26:50 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_43626218/article/details/141324211
版权
  • 摘要： C# + Halcon实现图像转换Bitmap 转 HImage (8,24,32通道)案例。

  • 前言

    • HALCON 是一款由德国 MVTec 公司开发的功能强大的机器视觉软件，广泛应用于图像处理和机器视觉领域。
    • 它提供了丰富的图像处理算法和工具，支持多种编程语言接口（如 C、C++、C#、Python 等）。
    • 支持 Windows、Linux 和 macOS 等多种操作系统上运行。
    • 此案例C# + Halcon实现图像转换Bitmap 转 HImage (8,24,32通道)。
    • 使用GenImageInterleaved 方法实现Halcon图像转Bitmap图像。

  • 功能介绍

    • 1. 图像格式判断

      • GetImageFormat() 方法通过读取文件头部字节来判断图像的实际格式（JPEG、PNG、GIF、BMP）
      • 包含四个私有方法 IsJpeg(), IsPng(), IsGif(), IsBmp() 分别用于检测不同格式的特征字节。

      • 2. 图像通道数获取

        • GetImageChannelCount() 方法获取图像的通道数和像素格式。
          • 8bpp (1通道) - 灰度图。
          • 24bpp (3通道) - RGB图。
          • 32bpp (4通道) - RGBA图。

      • 3. 图像读取和转换

        • ReadImage() 方法读取图像并转换为 HImage 格式，根据不同的像素格式使用不同的处理方法。
        • 提供了多种 Bitmap 到 HImage/HObject 的转换方法：
          • BitmapToHImageBpp8() - 8位单通道转换。
          • BitmapToHImageBpp24() - 24位3通道转换。
          • BitmapToHImageBpp32() - 32位4通道转换。
          • BitmapToHObjectBpp24() - 24位彩色转HObject。

  • 核心步骤

    • 1、加载图像。
    • 2、锁定图像数据。
    • 3、执行图像转换。
    • 4、解锁图像数据。
    • 5、输出图像。

  • 运行环境

    • 操作系统： Windows11
    • 编程软件： Visual Studio 2022
    • .Net版本： .Net Framework 4.6.0
    • Halcon ： HALCON 20.11

  • 核心方法

     ///<summary> Bitmap转HImage(32位4通道) </summary>
    public static void BitmapToHImageBpp32(Bitmap bmp, out HImage image, PixelFormat pixelFormat)
    {
        try
        {
            image = new HImage();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, pixelFormat);
            image.GenImageInterleaved(srcBmpData.Scan0, "rgbx", bmp.Width, bmp.Height, 0, "byte", bmp.Width, bmp.Height, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }

  • 代码

    public class ImageFormatTools
{
    public class ImageFormatTools
{
    #region 判断图像的正确格式
    /// <summary> 图像格式工具：获取正确的图像格式，通过图像文件的二进制头部图像格式标识。 </summary>
    public static ImageFormat GetImageFormat(string filePath)
    {
        using (FileStream fs = new FileStream(filePath, FileMode.Open, FileAccess.Read))
        {
            using (BinaryReader br = new BinaryReader(fs))
            {
                // 读取文件的前几个字节
                byte[] headerBytes = br.ReadBytes(16);
                // 根据文件的前几个字节判断图像的实际格式
                if (IsJpeg(headerBytes))
                {
                    return ImageFormat.Jpeg;
                }
                else if (IsPng(headerBytes))
                {
                    return ImageFormat.Png;
                }
                else if (IsGif(headerBytes))
                {
                    return ImageFormat.Gif;
                }
                else if (IsBmp(headerBytes))
                {
                    return ImageFormat.Bmp;
                }
                else
                {
                    // 默认返回未知格式
                    return null;
                }
            }
        }
    }
    private static bool IsJpeg(byte[] headerBytes)
    {
        // JPEG 文件的前两个字节是 0xFF, 0xD8
        return headerBytes.Length >= 2 && headerBytes[0] == 0xFF && headerBytes[1] == 0xD8;
    }
    private static bool IsPng(byte[] headerBytes)
    {
        // PNG 文件的前八个字节是固定的签名：137 80 78 71 13 10 26 10
        return headerBytes.Length >= 8 && headerBytes[0] == 137
                && headerBytes[1] == 80 && headerBytes[2] == 78
                && headerBytes[3] == 71 && headerBytes[4] == 13
                && headerBytes[5] == 10 && headerBytes[6] == 26
                && headerBytes[7] == 10;
    }

    private static bool IsGif(byte[] headerBytes)
    {
        // GIF 文件的前三个字节是 "GIF"
        return headerBytes.Length >= 3 && headerBytes[0] == 71
                && headerBytes[1] == 73 && headerBytes[2] == 70;
    }

    private static bool IsBmp(byte[] headerBytes)
    {
        // BMP 文件的前两个字节是 "BM"
        return headerBytes.Length >= 2 && headerBytes[0] == 66
            && headerBytes[1] == 77;
    }
    #endregion
    /// <summary> 获取图像通道数、图像类型 </summary>
    public static int GetImageChannelCount(string imagePath ,out Bitmap bitmap,out PixelFormat format)
    {
        try
        {
            Image image = Image.FromFile(imagePath);
            //bitmap = new Bitmap(imagePath);
            bitmap = new Bitmap(image);
            // 获取图像的PixelFormat
            format = bitmap.PixelFormat;
            image.Dispose();
            // 根据PixelFormat判断通道数
            switch (format)
            {
                case PixelFormat.Format8bppIndexed: // 灰度图
                    return 1;
                case PixelFormat.Format24bppRgb: // RGB图
                    return 3;
                case PixelFormat.Format32bppRgb: // 
                case PixelFormat.Format32bppArgb: // RGBA图 RGB + Alpha
                    return 4;
                default:
                    return -1;
            }
        }
        catch (Exception ex)
        {
            throw new ArgumentException($"参数异常：{ex.Message}");
        }
    }
/// <summary> 读取图像，并返回读取信息：输入图像路径，返回HImage图像（8，24，32位（1，3，4通道））  </summary>
public static void ReadImage(string path,out HImage hImage,out string info)
{
    hImage = new HImage();
    Random random = new Random();
    info = null;
    int channel = GetImageChannelCount(path, out Bitmap bitmap, out PixelFormat format);
    switch (format)
    {
        case PixelFormat.Format8bppIndexed:
            try
            {
                hImage.ReadImage(path);
            }
            catch (Exception ex)
            {
                BitmapToHImageBpp8(bitmap, out hImage);
                info= ex.Message;
            }
            break;
        case PixelFormat.Format24bppRgb:
            try
            {
                hImage.ReadImage(path);
            }
            catch (Exception ex)
            {
                BitmapToHImageBpp24(bitmap, out hImage);
                info = ex.Message;
            }
            break;
        case PixelFormat.Format32bppRgb:
        case PixelFormat.Format32bppArgb:
            try
            {
                hImage.ReadImage(path);
            }
            catch (Exception ex)
            {
                BitmapToHImageBpp32(bitmap, out hImage, format);
                info = ex.Message;
            }
            break;

        default:
            try
            {
                hImage.ReadImage(path);
            }
            catch (Exception ex)
            {
                BitmapToHImageBpp8(bitmap, out hImage);
                info = ex.Message;
            }
            break;
    }
}
    ///<summary> Bitmap转HImage(24位3通道) </summary>
    public static void BitmapToHImageBpp24(Bitmap bmp, out HImage image)
    {
        try
        {
            HObject tempImage = new HObject();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb);
            //image.GenImageInterleaved(srcBmpData.Scan0, "rgb", bmp.Width, bmp.Height, 0, "byte", bmp.Width, bmp.Height, 0, 0, -1, 0);
            HOperatorSet.GenImageInterleaved(out tempImage, srcBmpData.Scan0, "bgr", bmp.Width, bmp.Height, 0, "byte", 0, 0, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);

            image = (HImage)tempImage.Clone();
        }
        catch (Exception ex)
        {
            image = null;
        }
    }

    ///<summary> Bitmap转HImage(32位4通道) </summary>
    public static void BitmapToHImageBpp32(Bitmap bmp, out HImage image, PixelFormat pixelFormat,int channel)
    {
        try
        {
            image = new HImage();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, pixelFormat);
            image.GenImageInterleaved(srcBmpData.Scan0, "rgbx", bmp.Width, bmp.Height, 0, "byte", bmp.Width, bmp.Height, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }
    /// <summary> Bitmap转HImage(8位单通道) </summary>
    public static void BitmapToHImageBpp8(Bitmap bmp,out HImage image)
    {
        try
        {

            image = new HImage();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format8bppIndexed);
            image.GenImage1("byte", bmp.Width, bmp.Height, srcBmpData.Scan0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }

    /// <summary> Bitmap 转HObject(24位彩色3通道) </summary>
    public static void BitmapToHObjectBpp24(Bitmap bmp ,out HObject image)
    {
        try
        {
            image = new HObject();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);

            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb);
            HOperatorSet.GenImageInterleaved(out image, srcBmpData.Scan0, "bgr", bmp.Width, bmp.Height, 0, "byte", 0, 0, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }
}
    public static int GetImageChannelCount(string imagePath ,out Bitmap bitmap,out PixelFormat format)
    {
        try
        {
            Image image = Image.FromFile(imagePath);
            //bitmap = new Bitmap(imagePath);
            bitmap = new Bitmap(image);
            // 获取图像的PixelFormat
            format = bitmap.PixelFormat;
            image.Dispose();
            // 根据PixelFormat判断通道数
            switch (format)
            {
                case PixelFormat.Format8bppIndexed: // 灰度图
                    return 1;
                case PixelFormat.Format24bppRgb: // RGB图
                    return 3;
                case PixelFormat.Format32bppRgb: // 
                case PixelFormat.Format32bppArgb: // RGBA图 RGB + Alpha
                    return 4;
                default:
                    return -1;
            }
        }
        catch (Exception ex)
        {
            throw new ArgumentException($"参数异常：{ex.Message}");
        }
    }

    ///<summary> Bitmap转HImage(24位3通道) </summary>
    public static void BitmapToHImageBpp24(Bitmap bmp, out HImage image)
    {
        try
        {
            HObject tempImage = new HObject();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb);
            //image.GenImageInterleaved(srcBmpData.Scan0, "rgb", bmp.Width, bmp.Height, 0, "byte", bmp.Width, bmp.Height, 0, 0, -1, 0);
            HOperatorSet.GenImageInterleaved(out tempImage, srcBmpData.Scan0, "bgr", bmp.Width, bmp.Height, 0, "byte", 0, 0, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);

            image = (HImage)tempImage.Clone();
        }
        catch (Exception ex)
        {
            image = null;
        }
    }

    ///<summary> Bitmap转HImage(32位4通道) </summary>
    public static void BitmapToHImageBpp32(Bitmap bmp, out HImage image, PixelFormat pixelFormat)
    {
        try
        {
            image = new HImage();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, pixelFormat);
            image.GenImageInterleaved(srcBmpData.Scan0, "rgbx", bmp.Width, bmp.Height, 0, "byte", bmp.Width, bmp.Height, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }
    /// <summary> Bitmap转HImage(8位单通道) </summary>
    public static void BitmapToHImageBpp8(Bitmap bmp,out HImage image)
    {
        try
        {

            image = new HImage();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format8bppIndexed);
            image.GenImage1("byte", bmp.Width, bmp.Height, srcBmpData.Scan0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }

    /// <summary> Bitmap 转HObject(24位彩色3通道) </summary>
    public static void BitmapToHObjectBpp24(Bitmap bmp ,out HObject image)
    {
        try
        {
            image = new HObject();
            Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);

            BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, PixelFormat.Format24bppRgb);
            HOperatorSet.GenImageInterleaved(out image, srcBmpData.Scan0, "bgr", bmp.Width, bmp.Height, 0, "byte", 0, 0, 0, 0, -1, 0);
            bmp.UnlockBits(srcBmpData);
        }
        catch (Exception ex)
        {
            image = null;
        }
    }
}

  • 总结

    • 1、Bitmap转换Halcon图像时常用的代码，如果Bitmap是32位的转换成HImage时显示图像倾斜的。
      • 网上搜了好多都无用，后来找到了要将GenImageInterleaved方法的第二个参数“bgr” 改成“bgrx”。
    • 2、获取图像正确格式的方法，是因为有时候直接改图像后缀名，读取图像时与图像后缀不符报错。
      • 目前暂时使用读取图像文件的二进制头部图像格式标识来判断。

  • 最后

    • 如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！
    • 如有疑问，欢迎评论区留言。
    • 也可以关注微信公众号 [编程笔记in] ，一起交流学习！
Halcon 图像类型转换
LIN943168247的博客
04-22 203
各位朋友们好，我是大脸猫。在计算机视觉开发中，经常需要将 Halcon 的 hobject 图像类型与 Mat 进行交互处理。然而，Halcon 和 Mat 在图像数据结构和存储方式上存在差异，直接使用会遇到诸多不便。因此，实现 hobject 到 Mat 的转换功能，成为打通两者高效协作的关键环节，对后续的图像分析与处理起着重要的铺垫作用。
C# Bitmap 与 halcon Hobject 图像格式互相转换
qq_40643170的博客
07-01 1万+
一直用opencv 做图像处理，最近接触到了halcon,发现使用halcon 实在太方便了。halcon 的代码可直接导出为C# 代码。由于我只是用halcon 实现图像算法功能，图像的显示还是用bitmap 格式，所以不可避免的要实现 bimtap 和hobject 互相转化的功能。 百度搜集的转换资料并不完整，经过几天的仔细研究，终于全部搞通。现分享出来，供有需要的同学参考。 1.彩色bitmap 转 彩色 Hobject public void Bitm...
c# 24位Bitmap转HImage用于halcon窗口控件显示
最新发布
weixin_39900300的博客
08-08 608
GenImageInterleaved算子的图像输入参数是不需要位对齐的图像数据，所以需要进行下面的数据转换。bitmapData.Scan0指向的图像数据已经是位对齐(bitmapData.Width%4==0)的，
c# 联合halcon Bitmap bmp快速转Hobject image
Sunny_love_you的博客
10-09 1800
public HObject Bitmap2Hobject(Bitmap bitmap) { Rectangle rectangle = new Rectangle(0, 0, bitmap.Width, bitmap.Height); BitmapData bitmapData = bitmap.LockBits(rectangle, ImageLockMode.ReadWrite, PixelFormat.Format32bppRgb); IntPtr intPtr = bitmapData.Scan0
Bitmap图像转halcon图像
12-07
机器视觉技术必备，从位图到halcon图像，bitmap图像转为halcon图像，bitmap to Hobject
Halcon_Bitmap转换
02-09
Halcon_Bitmap转换方法 写的文档 开发笔记
C#bitmap图像转halcon的hobject图像
m0_66380820的博客
06-27 1458
方法经过测试有一些问题，这种方法并不是所有的图片都通用，一些图片生成出来后会变成斜的。查找BitmapData类介绍，其中的有一个属性是Stride，也就是扫描一行的字节数，它是4的倍数，因此在行的字节数不满足这个条件时，会对行进行补充。所以说如果按照这个顺序来赋值内存的话，对于宽度不是4倍数的图片来说，不仅会丢失信息，还会造成图片的扭曲，并产生一个黑线。但是通过观察图片可以看出一些规律，就是图片的斜对角有一根很明显的切割线，图片也可以看出是图片的每一行后面都多了一个像素，一直累计导致现在这个样子。
C#+Halcon winform 采集图片，处理识别
09-12
在本文中，我们将深入探讨如何使用C#与Halcon库结合，在Windows Forms（Winform）应用程序中实现图像采集和处理识别。Halcon是一种强大的机器视觉软件，提供了丰富的图像处理算法，而C#作为.NET框架的一部分，是开发...
C# 图像处理:Bitmap 与 Image 之间的转换
weixin_33951761的博客
03-27 2237
Image img = this.pictureBox1.Image; Bitmap map = new Bitmap(img);   Image img = Bitmap;         Image和Bitmap类概述GDI+的Image类封装了对BMP、GIF、JPEG、PNG、TIFF、WMF(Windows元文件)和EMF(增强WMF)图像文件的调入、格式转换以及...
彩色 Bitmap转换HObject图像
yangsen001122的博客
05-08 461
后来查找原因，分析原因，发现是因为Bitmap4字节对齐，非4的整数倍宽度的图像，后面会补0来达到4的倍数。如图像width=202，每行202个字节，实际内存每行后面会补两个字节，宽度变为204个字节。所以重新修改转换代码，在每个末尾进行添加，这部分添加完毕后，经过测试，OK。彩色 Bitmap转换HObject图像。但是发现有问题，变换的图像十分异常，之前已有的代码是这样的。
halcon和emgucv图像格式互相转换函数
04-04
emgucv是c#版本的opencv，用c#写的halcon与c#emgucv之间的图像转换函数，对采用halcon与emgucv混合编程的比较有用。是txt格式的，直接把函数复制在自己的代码里面就可以用，注意要把emgucv和halcon的环境配置好才可以用
HALCON-从入门到入门-图像格式的互相转换
linux_huangyu的博客
06-02 2143
上次说到了图片的读取和写入到本地，这次说一下图片的格式相关。
Halcon HObject和C# Bitmap图像互转的几种方式及转换时间测试
热门推荐
SabreWulf
08-17 1万+
分别使用了HOperatorSet.GenImageInterleaved直接转换、C#获取图像各个通道内存首地址和HOperatorSet.GenImage3合成、OpenCV获取图像各通道内存首地址和HOperatorSet.GenImage3合成的三种方式。经测试发现还是使用HOperatorSet.GenImageInterleaved方法转换速度最快。 详细测试代码如下： usin...
C#中bitmap图像格式转换为Halcon图像格式
HXD196的博客
08-26 2087
public static void Bitmap2HObjectBpp8(Bitmap bmp, out HObject image) { try { Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height); BitmapData srcBmpData = bmp.LockBits(rect, ImageLockMode.ReadOnly, Pi...
C#里Bitmap转Halcon的HObject
海盗Isaac
08-30 1879
因为Bitmap4字节对齐，非4的整数倍宽度的图像，后面会补0来达到4的倍数。如图像width=810，每行810个字节，实际内存每行后面会补两个字节，宽度变为812个字节。如果按照上面的方法得到的图像如下图所示。一般情况下，图像的width是4的倍数的话，用以下代码便可将彩色bitmap转出halcon里的HObject。要避免这种情况，得重新搞好对应关系，我写了以下方法，可以得到正确的图像。
Halcon HObject和C#的Bitmap图像互转
Major_S的博客
07-13 5286
Halcon HObject和C#的Bitmap图像互转
HalconHObject和CSharp的Bitmap图像互转
NCUTer
03-04 667
HalconHObject和CSharp的Bitmap图像互转的C#代码
HALCON Hobject和Bitmap相互转换
m0_52364694的博客
05-09 1622
灰度图的HObject转HImage。灰度图HObject转Bitmap。Bitbmp转Hobject。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

编程笔记in

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值