c#联合Halcon进行OCR字符识别（含halcon-25.05 百度网盘）

1.下载安装halcon

通过网盘分享的文件：halcon-25.05.0.0-x64-win64 链接: https://pan.baidu.com/s/1XAx-8ZQM-ZHkgHIc-dhCYw

提取码: whek

2.c#环境配置

创建test_halcon_ocr项目

找到halcon的安装路径

我的： D:\\halcon\\HALCON-25.05-Progress\\bin\\x64-win64 D:\\halcon\\HALCON-25.05-Progress\\bin\\dotnet35

添加引用（"D:\\halcon\\HALCON-25.05-Progress\\bin\\dotnet35\\halcondotnet.dll"）

把halcondotnet.dll拖到工具箱中。

屏幕录制 2025-08-12 103356

添加HWindowcontrol ，button 和 textbox

设置button1 点击事件

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using HalconDotNet;

namespace test_halcon_ocr
{
public partial class Form1 : Form
{
HObject TestImage;
string Path_testimg = "C:\\\\Users\\\\86957\\\\Desktop\\\\img_ocr_0296.png";

public Form1()
{
InitializeComponent();
}

private void button1_Click(object sender, EventArgs e)
{

//读取文件
HOperatorSet.ReadImage(out TestImage, Path_testimg);
//获取图片大小
HTuple Width, Height;
HOperatorSet.GetImageSize(TestImage, out Width, out Height);
//设置图片显示范围 hWindowControl1.HalconWindow获得窗体句柄
HOperatorSet.SetPart(hWindowControl1.HalconWindow, 0, 0, (Height – 1), (Width – 1)); //0,0, (Height – 1), (Width – 1)代表从0，0坐标到图片的宽高坐标，达到全屏显示

//将图片投射到窗体上
HOperatorSet.DispObj(TestImage, hWindowControl1.HalconWindow);//将TestImage变量投射到句柄窗口上

}

private void button2_Click(object sender, EventArgs e)
{

}
}
}

运行，

成功报错。

解决： 项目右键属性，找到生成，取消勾选首选32位。

再次运行，

成功。

3. ocr 字符识别

运行后，

4.完整代码：  

using System;
using System.IO;
using System.Windows.Forms;
using HalconDotNet;
namespace test_halcon_ocr
{
public partial class Form1 : Form
{
HObject TestImage;
HTuple hv_DeepOcrHandle = new HTuple();
string Path_testimg = "C:\\\\Users\\\\86957\\\\Desktop\\\\img_ocr_0296.png";

public Form1()
{
InitializeComponent();
}

//自动选择最佳计算设备（GPU优先），优化模型运行效率
static void set_suitable_device_in_ocr_handle(HTuple hv_DeepOcrHandle)
{

// Local control variables

HTuple hv_DLDeviceHandles = new HTuple(), hv_RecognitionImageWidthDefault = new HTuple();
HTuple hv_Exception = new HTuple(), hv_Index = new HTuple();
// Initialize local and output iconic variables
try
{
//Determine deep learning device to work with (prefer GPU over CPU).
hv_DLDeviceHandles.Dispose();
HOperatorSet.QueryAvailableDlDevices((new HTuple("runtime")).TupleConcat("runtime"),
(new HTuple("gpu")).TupleConcat("cpu"), out hv_DLDeviceHandles);
if ((int)(new HTuple((new HTuple(hv_DLDeviceHandles.TupleLength())).TupleEqual(
0))) != 0)
{
throw new HalconException("No supported device found to continue this example.");
}
//Set recognition_image_width larger for the example to work without memory problems.
try
{
hv_RecognitionImageWidthDefault.Dispose();
HOperatorSet.GetDeepOcrParam(hv_DeepOcrHandle, "recognition_image_width",
out hv_RecognitionImageWidthDefault);
HOperatorSet.SetDeepOcrParam(hv_DeepOcrHandle, "recognition_image_width",
260);
}
// catch (Exception)
catch (HalconException HDevExpDefaultException1)
{
HDevExpDefaultException1.ToHTuple(out hv_Exception);
}

for (hv_Index = 0; (int)hv_Index <= (int)((new HTuple(hv_DLDeviceHandles.TupleLength()
)) – 1); hv_Index = (int)hv_Index + 1)
{
try
{
using (HDevDisposeHelper dh = new HDevDisposeHelper())
{
HOperatorSet.SetDeepOcrParam(hv_DeepOcrHandle, "device", hv_DLDeviceHandles.TupleSelect(
hv_Index));
}
break;
}
// catch (Exception)
catch (HalconException HDevExpDefaultException1)
{
HDevExpDefaultException1.ToHTuple(out hv_Exception);
if ((int)(new HTuple(hv_Index.TupleEqual((new HTuple(hv_DLDeviceHandles.TupleLength()
)) – 1))) != 0)
{
throw new HalconException("Could not set any of the supported devices to continue this example.");
}
}
}
//Reset recognition_image_width to the default value.
try
{
HOperatorSet.SetDeepOcrParam(hv_DeepOcrHandle, "recognition_image_width",
hv_RecognitionImageWidthDefault);
}
// catch (Exception)
catch (HalconException HDevExpDefaultException1)
{
HDevExpDefaultException1.ToHTuple(out hv_Exception);
}

hv_DLDeviceHandles.Dispose();
hv_RecognitionImageWidthDefault.Dispose();
hv_Exception.Dispose();
hv_Index.Dispose();

return;
}
catch (HalconException HDevExpDefaultException)
{

hv_DLDeviceHandles.Dispose();
hv_RecognitionImageWidthDefault.Dispose();
hv_Exception.Dispose();
hv_Index.Dispose();

throw HDevExpDefaultException;
}
}

//执行完整的OCR识别流程，包含预处理、ROI裁剪、模型推理和结果解析
public static string DeepLearningOCR(HObject ho_ImageSource, int row1, int col1, int row2, int col2, HWindow Window, HTuple hv_DeepOcrHandle)
{

// Local iconic variables

HObject ho_ImageMean, ho_Image;
HObject ho_ImageWord, ho_Rectangle;

// Local control variables

HTuple hv_Width = new HTuple();
HTuple hv_Height = new HTuple(), hv_DeepOcrResult = new HTuple();
HTuple hv_RecognizedWord = new HTuple();
// Initialize local and output iconic variables
//HOperatorSet.GenEmptyObj(out ho_ImageSource);
HOperatorSet.GenEmptyObj(out ho_ImageMean);
HOperatorSet.GenEmptyObj(out ho_Image);
HOperatorSet.GenEmptyObj(out ho_ImageWord);
HOperatorSet.GenEmptyObj(out ho_Rectangle);
try
{

ho_ImageMean.Dispose();
HOperatorSet.MeanImage(ho_ImageSource, out ho_ImageMean, 3, 3);// 图像预处理

ho_Image.Dispose();
HOperatorSet.Emphasize(ho_ImageMean, out ho_Image, 9, 9, 1);

hv_Width.Dispose(); hv_Height.Dispose();
HOperatorSet.GetImageSize(ho_ImageSource, out hv_Width, out hv_Height);

//
//Crop the word to be recognized by the recognition component.
ho_ImageWord.Dispose();
HOperatorSet.CropRectangle1(ho_Image, out ho_ImageWord, row1, col1, row2, col2);// ROI裁剪
ho_Rectangle.Dispose();
HOperatorSet.GenRectangle1(out ho_Rectangle, row1, col1, row2, col2);
//
//Apply recognition with default recognition_image_width.

hv_DeepOcrResult.Dispose();
HOperatorSet.ApplyDeepOcr(ho_ImageWord, hv_DeepOcrHandle, "recognition", out hv_DeepOcrResult); // 执行OCR识别
hv_RecognizedWord.Dispose();
HOperatorSet.GetDictTuple(hv_DeepOcrResult, "word", out hv_RecognizedWord);
ho_Image.DispObj(Window);

Window.SetDraw("margin");

Window.SetColor("red");
Window.SetPart(0, 0, (int)(hv_Height – 1), (int)(hv_Width – 1));

ho_Rectangle.DispObj(Window);

}
catch (HalconException HDevExpDefaultException)
{
ho_ImageSource.Dispose();
ho_ImageMean.Dispose();
ho_Image.Dispose();
ho_ImageWord.Dispose();
ho_Rectangle.Dispose();

// hv_DeepOcrHandle.Dispose();
hv_Width.Dispose();
hv_Height.Dispose();
hv_DeepOcrResult.Dispose();
hv_RecognizedWord.Dispose();

throw HDevExpDefaultException;
}
ho_ImageSource.Dispose();
ho_ImageMean.Dispose();
ho_Image.Dispose();
ho_ImageWord.Dispose();
ho_Rectangle.Dispose();

// hv_DeepOcrHandle.Dispose();
hv_Width.Dispose();
hv_Height.Dispose();
hv_DeepOcrResult.Dispose();
hv_RecognizedWord.Dispose();

return hv_RecognizedWord.S;

}

//初始化深度学习OCR模型，创建识别器实例并配置基本参数
public static HTuple CreateDeepOcr()
{
HTuple hv_DeepOcrHandle = new HTuple();
hv_DeepOcrHandle.Dispose();
HOperatorSet.CreateDeepOcr("mode", "recognition", out hv_DeepOcrHandle);
set_suitable_device_in_ocr_handle(hv_DeepOcrHandle);
HOperatorSet.SetDeepOcrParam(hv_DeepOcrHandle, "recognition_image_width", 260);
return hv_DeepOcrHandle;

}

private void button1_Click(object sender, EventArgs e)//显示图像
{
//读取文件
HOperatorSet.ReadImage(out TestImage, Path_testimg);
//获取图片大小
HTuple Width, Height;
HOperatorSet.GetImageSize(TestImage, out Width, out Height);
//设置图片显示范围 hWindowControl1.HalconWindow获得窗体句柄
HOperatorSet.SetPart(hWindowControl1.HalconWindow, 0, 0, (Height – 1), (Width – 1)); //0,0, (Height – 1), (Width – 1)代表从0，0坐标到图片的宽高坐标，达到全屏显示

//将图片投射到窗体上
HOperatorSet.DispObj(TestImage, hWindowControl1.HalconWindow);//将TestImage变量投射到句柄窗口上

}

private void button2_Click(object sender, EventArgs e)//字符识别
{

textBox1.AppendText("开始检测：" + "\\r\\n");
try
{
hv_DeepOcrHandle = CreateDeepOcr();

}
catch
{
MessageBox.Show("error");
}

if (!File.Exists(Path_testimg))
{
textBox1.AppendText($"文件不存在: {Path_testimg}" + "\\r\\n");
return;
}

HalconDotNet.HImage hImage = new HalconDotNet.HImage(Path_testimg);

HTuple width, height;
hImage.GetImageSize(out width, out height);

int intWidth = width.TupleInt();
int intHeight = height.TupleInt();
textBox1.AppendText("选框坐标为：" + "\\r\\n");
textBox1.AppendText(intWidth.ToString());
textBox1.AppendText(width.ToString() + "\\r\\n");

string code = DeepLearningOCR(hImage, 0, 0, intHeight, intWidth, hWindowControl1.HalconWindow, hv_DeepOcrHandle);
textBox1.AppendText("code：" + code + "\\r\\n");

}
}
}

namespace test_halcon_ocr
{
partial class Form1
{
/// <summary>
/// 必需的设计器变量。
/// </summary>
private System.ComponentModel.IContainer components = null;

/// <summary>
/// 清理所有正在使用的资源。
/// </summary>
/// <param name="disposing">如果应释放托管资源，为 true；否则为 false。</param>
protected override void Dispose(bool disposing)
{
if (disposing && (components != null))
{
components.Dispose();
}
base.Dispose(disposing);
}

#region Windows 窗体设计器生成的代码

/// <summary>
/// 设计器支持所需的方法 – 不要修改
/// 使用代码编辑器修改此方法的内容。
/// </summary>
private void InitializeComponent()
{
this.hWindowControl1 = new HalconDotNet.HWindowControl();
this.button1 = new System.Windows.Forms.Button();
this.button2 = new System.Windows.Forms.Button();
this.textBox1 = new System.Windows.Forms.TextBox();
this.SuspendLayout();
//
// hWindowControl1
//
this.hWindowControl1.BackColor = System.Drawing.Color.Black;
this.hWindowControl1.BorderColor = System.Drawing.Color.Black;
this.hWindowControl1.ImagePart = new System.Drawing.Rectangle(0, 0, 640, 480);
this.hWindowControl1.Location = new System.Drawing.Point(96, 116);
this.hWindowControl1.Name = "hWindowControl1";
this.hWindowControl1.Size = new System.Drawing.Size(525, 338);
this.hWindowControl1.TabIndex = 0;
this.hWindowControl1.WindowSize = new System.Drawing.Size(525, 338);
//
// button1
//
this.button1.Location = new System.Drawing.Point(174, 567);
this.button1.Name = "button1";
this.button1.Size = new System.Drawing.Size(288, 117);
this.button1.TabIndex = 1;
this.button1.Text = "button1";
this.button1.UseVisualStyleBackColor = true;
this.button1.Click += new System.EventHandler(this.button1_Click);
//
// button2
//
this.button2.Location = new System.Drawing.Point(662, 567);
this.button2.Name = "button2";
this.button2.Size = new System.Drawing.Size(242, 117);
this.button2.TabIndex = 2;
this.button2.Text = "button2";
this.button2.UseVisualStyleBackColor = true;
this.button2.Click += new System.EventHandler(this.button2_Click);
//
// textBox1
//
this.textBox1.Location = new System.Drawing.Point(830, 189);
this.textBox1.Multiline = true;
this.textBox1.Name = "textBox1";
this.textBox1.Size = new System.Drawing.Size(317, 254);
this.textBox1.TabIndex = 3;
//
// Form1
//
this.AutoScaleDimensions = new System.Drawing.SizeF(9F, 18F);
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.ClientSize = new System.Drawing.Size(1269, 736);
this.Controls.Add(this.textBox1);
this.Controls.Add(this.button2);
this.Controls.Add(this.button1);
this.Controls.Add(this.hWindowControl1);
this.Name = "Form1";
this.Text = "Form1";
this.ResumeLayout(false);
this.PerformLayout();

}

#endregion

private HalconDotNet.HWindowControl hWindowControl1;
private System.Windows.Forms.Button button1;
private System.Windows.Forms.Button button2;
private System.Windows.Forms.TextBox textBox1;
}
}