易语言OCR证件照文字识别

  一.引言

文字识别，也称为光学字符识别（Optical Character Recognition, OCR），是一种将不同形式的文档（如扫描的纸质文档、PDF文件或数字相机拍摄的图片）中的文字转换成可编辑和可搜索的数据的技术。随着技术的发展，文字识别技术已经成为信息管理、自动化办公和智能系统的关键组成部分。

二.简介

为了易于集成和使用，我们将文字识别OCR封装为DLL（动态链接库）。这种封装方式不仅保留了算法的性能优势，还提供了跨平台和跨语言的兼容性，目前支持编程语言如下：

  • C++
  • Python
  • 易语言

1.C++头文件

  1.  
  2.  
  3.  
  4. #ifndef __SN_OCR__H__
  5. #define __SN_OCR__H__
  6.  
  7. #include "windows.h"
  8.  
  9.  
  10. //返回参数
  11. typedef struct SN_STATU {
  12.  
  13. 	int code;			//错误码，如果为 0 表示成功，否则表示错误号
  14. 	char message[4096];	//错误信息，如果为 "OK" 表示成功，否则返回错误信息
  15.  
  16. }SN_STATU;
  17.  
  18.  
  19. /*启动OCR文字识别服务
  20. *
  21. * 参数：
  22. *	[in]  szOnnxFilePath：	设置 onnx 模型文件路径，如果设置为 NULL，默认和 DLL文件同级目录
  23. * 	[out] pResult：			返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
  24. *
  25. * 返回值：成功返回0，失败返回错误号，详细错误信息请参考 pResult
  26. *
  27. */
  28. int WINAPI apiSNInitOCRServer(char* szOnnxFilePath, SN_STATU* pStatu);
  29.  
  30.  
  31. /*创建OCR文字识别句柄
  32. *
  33. * 参数：
  34. *	[in]  szKey：		卡密(购买卡密：https://shop.4yuns.com/links/7C9F16B7)
  35. * 	[in]  pOnnxFilePath：设置 onnx 模型文件路径，如果设置为 NULL，默认和 DLL文件同级目录
  36. * 	[out] pResult：		返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
  37. *
  38. * 返回值：成功返回句柄，失败返回NULL
  39. *
  40. */
  41. HANDLE WINAPI apiSNCreateOCRHandle(char* szKey, char* szOnnxFilePath, SN_STATU* pStatu);
  42.  
  43.  
  44. /*获取OCR文字识别卡密到期时间
  45. *
  46. * 参数：
  47. *	[in]  handle：		句柄（通过调用apiSNCreateOCRHandle得到）
  48. * 	[out] pResult：		返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
  49. *
  50. * 返回值：返回卡密到期时间，失败返回NULL，错误信息请查看参数 pResult->message
  51. *
  52. */
  53. char* WINAPI apiSNGetKeyExpiresTime(HANDLE handle, SN_STATU* pResult);
  54.  
  55.  
  56. /*获取OCR文字识别结果（以json字符串形式返回）
  57. *
  58. * 参数：
  59. *	[in]  handle：			句柄（通过调用apiSNCreateOCRHandle得到）
  60. *  	[in]  szImageFilePath：	图片路径
  61. * 	[out] pResult：			返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
  62. *
  63. * 返回值：返回OCR文字识别结果（以json字符串形式返回），失败返回NULL，错误信息请查看参数 pResult->message
  64. *
  65. */
  66. char* WINAPI apiSNGetOCRFromImage(HANDLE handle, char* szImageFilePath, SN_STATU* pStatu);
  67.  
  68.  
  69. /*释放OCR文字识别句柄（释放内存）
  70. *
  71. * 参数：
  72. *	[in] handle：		句柄（通过调用apiSNCreateOCRHandle得到）
  73. *
  74. * 返回值：返回 0 表示成功，其他值表示错误号;
  75. *
  76. */
  77. int WINAPI apiSNDestroyOCRHandle(HANDLE handle);
  78.  
  79. #endif

2.C++调用dll接口

  1. .版本 2
  2. .支持库 spec
  3.  
  4. .程序集 窗口程序集_启动窗口
  5.  
  6. .子程序 _启动子程序, 整数型
  7.  
  8. _临时子程序 ()
  9. 返回 (0)
  10.  
  11.  
  12. .子程序 _临时子程序
  13. .局部变量 handle, 整数型
  14. .局部变量 pResult, SN_STATU, 静态, , 返回错误信息，参数pResult.code(错误码)如果为 0 表示成功，否则表示错误号;
  15. .局部变量 szOCRJson, 文本型, , , OCR识别结果 （json字符串）;
  16. .局部变量 szTime, 文本型, , , 卡密结束时间;
  17.  
  18. ' ---------------------------------------------------------------
  19. ' 1.启动 OCR 文字识别服务
  20. ' 其中卡密 SNKJe9xffLhdFY7r3TcffXq44ThDVcE3BQFQFfVA9VG4 仅用于测试，需要找开发人员重新购买，购买卡密连接：https://shop.4yuns.com/links/7C9F16B7
  21. ' ---------------------------------------------------------------
  22. apiSNInitOCRServer (“SNOCR.onnx”, pResult)
  23. 调试输出 (pResult.code, 到文本 (pResult.message))
  24. .如果真 (pResult.code ＜ 0)
  25.     调试输出 (“-----------程序结束-----------”)
  26.     返回 ()
  27.  
  28. .如果真结束
  29. ' 2.创建 OCR 文字识别句柄
  30. handle ＝ apiSNCreateOCRHandle (“SNKJe9xffLhdFY7r3TcffXq44ThDVcE3BQFQFfVA9VG4”, “SNOCR.onnx”, pResult)
  31. 调试输出 (pResult.code, 到文本 (pResult.message))
  32. 调试输出 (“句柄”, handle)
  33. .如果真 (pResult.code ＜ 0)
  34.     调试输出 (“-----------程序结束-----------”)
  35.     返回 ()
  36. .如果真结束
  37. ' 3.识别 OCR 文字识别，返回 json 字符串
  38. szOCRJson ＝ apiSNGetOCRFromImage (handle, “d:\\22.png”, pResult)
  39. 调试输出 (到文本 (szOCRJson))
  40.  
  41. ' 4.识别 OCR 文字卡密到期时间
  42. szTime ＝ apiSNGetKeyExpiresTime (handle, pResult)
  43. 调试输出 (到文本 (szTime))
  44. ' 5.释放 OCR 文字识别内存
  45. apiSNDestroyOCRHandle (handle)
  46. 调试输出 (“-----------程序结束-----------”)

三.效果演示

1.图片1

识别效果：

  1. {
  2. 	"type":	0,
  3. 	"task_id":	1,
  4. 	"err_code":	0,
  5. 	"ocr_result":	{
  6. 		"single_result":	[{
  7. 				"left":	80.136589,
  8. 				"top":	56.710590,
  9. 				"right":	413.614105,
  10. 				"bottom":	89.287964,
  11. 				"str_utf8":	"包头市特种设备追溯平台",
  12. 				"rate":	"0.981197"
  13. 			}, {
  14. 				"left":	171.293091,
  15. 				"top":	99.701866,
  16. 				"right":	329.740753,
  17. 				"bottom":	120.792061,
  18. 				"str_utf8":	"设备编码: 000001)",
  19. 				"rate":	"0.970116"
  20. 			}, {
  21. 				"left":	81.693756,
  22. 				"top":	274.142029,
  23. 				"right":	229.766312,
  24. 				"bottom":	295.966248,
  25. 				"str_utf8":	"RFID 扫描区域",
  26. 				"rate":	"0.992770"
  27. 			}, {
  28. 				"left":	50,
  29. 				"top":	318.229156,
  30. 				"right":	181.250000,
  31. 				"bottom":	339.062500,
  32. 				"str_utf8":	"投诉电话: 12365",
  33. 				"rate":	"0.984698"
  34. 			}, {
  35. 				"left":	259.311310,
  36. 				"top":	352.951111,
  37. 				"right":	466.734924,
  38. 				"bottom":	371.130615,
  39. 				"str_utf8":	"包头市质量技术监督局制",
  40. 				"rate":	"0.961233"
  41. 			}],
  42. 		"width":	"500",
  43. 		"height":	"384"
  44. 	}
  45. }

2.图片2

识别效果：

  1. {
  2. 	"type":	0,
  3. 	"task_id":	1,
  4. 	"err_code":	0,
  5. 	"ocr_result":	{
  6. 		"single_result":	[{
  7. 				"left":	451.128448,
  8. 				"top":	110.489426,
  9. 				"right":	1138.148070,
  10. 				"bottom":	199.850967,
  11. 				"str_utf8":	"中华人民共和国",
  12. 				"rate":	"0.998395"
  13. 			}, {
  14. 				"left":	398.003052,
  15. 				"top":	250.290588,
  16. 				"right":	1189.906010,
  17. 				"bottom":	370.648926,
  18. 				"str_utf8":	"居民身份证",
  19. 				"rate":	"0.999714"
  20. 			}, {
  21. 				"left":	333.586945,
  22. 				"top":	605.802917,
  23. 				"right":	1028.648680,
  24. 				"bottom":	654.308594,
  25. 				"str_utf8":	"签发机关上海市公安局徐汇分局",
  26. 				"rate":	"0.998378"
  27. 			}, {
  28. 				"left":	334.754303,
  29. 				"top":	712.041199,
  30. 				"right":	539.191406,
  31. 				"bottom":	752.816345,
  32. 				"str_utf8":	"有效期限",
  33. 				"rate":	"0.999937"
  34. 			}, {
  35. 				"left":	551.186523,
  36. 				"top":	713.943665,
  37. 				"right":	1061.341670,
  38. 				"bottom":	754.974915,
  39. 				"str_utf8":	"2005.10.08-202510.08",
  40. 				"rate":	"0.985583"
  41. 			}],
  42. 		"width":	"1313",
  43. 		"height":	"858"
  44. 	}
  45. }

四.常见问题

1.是否支持多线程

支持

五.更新日志

  • 2024.12.15 OCR 文字识别支持C++/Python/易语言

六.云盘源码下载

posted @ 2024-12-17 07:12  猿说编程  阅读(10)  评论(0)  编辑  收藏  举报