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 字符识别

CreateDeepOcr函数：这个函数负责创建深度OCR处理器。使用HOperatorSet.CreateDeepOcr方法，传入参数"mode"和"recognition"，生成一个OCR句柄。然后调用set_suitable_device_in_ocr_handle来设置合适的运行设备（如GPU或CPU），并设置识别图像的宽度参数。这个函数的作用是初始化OCR模型，准备后续的识别操作。
set_suitable_device_in_ocr_handle函数：该函数用于配置OCR处理器使用的计算设备。首先查询可用的深度学习设备（GPU和CPU），优先选择GPU。然后设置识别图像的宽度参数，确保在处理时不会因为内存问题出错。这里涉及到异常处理，确保在设备不可用时能够回退到其他设备，并在最后恢复默认的图像宽度设置。
DeepLearningOCR函数：这是实际的OCR识别函数。它接收图像、ROI坐标、窗口句柄和OCR处理器句柄作为参数。处理步骤包括图像预处理（均值滤波和强调处理）、裁剪ROI区域、应用OCR识别，并将结果返回。识别过程中使用Halcon的ApplyDeepOcr方法，并从结果中提取识别的文本。

运行后，

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();}#endregionprivate HalconDotNet.HWindowControl hWindowControl1;private System.Windows.Forms.Button button1;private System.Windows.Forms.Button button2;private System.Windows.Forms.TextBox textBox1;}
}