易语言OCR银行卡文字识别

一.引言

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

二.简介

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

C++
Python
易语言

1.C++头文件

#ifndef __SN_OCR__H__
#define __SN_OCR__H__#include "windows.h"//返回参数
typedef struct SN_STATU {int code;			//错误码，如果为 0 表示成功，否则表示错误号char message[4096];	//错误信息，如果为 "OK" 表示成功，否则返回错误信息}SN_STATU;/*启动OCR文字识别服务
*
* 参数：
*	[in]  szOnnxFilePath：	设置 onnx 模型文件路径，如果设置为 NULL，默认和 DLL文件同级目录
* 	[out] pResult：			返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：成功返回0，失败返回错误号，详细错误信息请参考 pResult
*
*/
int WINAPI apiSNInitOCRServer(char* szOnnxFilePath, SN_STATU* pStatu);/*创建OCR文字识别句柄
*
* 参数：
*	[in]  szKey：		卡密(购买卡密：https://shop.4yuns.com/links/7C9F16B7)
* 	[in]  pOnnxFilePath：设置 onnx 模型文件路径，如果设置为 NULL，默认和 DLL文件同级目录
* 	[out] pResult：		返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：成功返回句柄，失败返回NULL
*
*/
HANDLE WINAPI apiSNCreateOCRHandle(char* szKey, char* szOnnxFilePath, SN_STATU* pStatu);/*获取OCR文字识别卡密到期时间
*
* 参数：
*	[in]  handle：		句柄（通过调用apiSNCreateOCRHandle得到）
* 	[out] pResult：		返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：返回卡密到期时间，失败返回NULL，错误信息请查看参数 pResult->message
*
*/
char* WINAPI apiSNGetKeyExpiresTime(HANDLE handle, SN_STATU* pResult);/*获取OCR文字识别结果（以json字符串形式返回）
*
* 参数：
*	[in]  handle：			句柄（通过调用apiSNCreateOCRHandle得到）
*  	[in]  szImageFilePath：	图片路径
* 	[out] pResult：			返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：返回OCR文字识别结果（以json字符串形式返回），失败返回NULL，错误信息请查看参数 pResult->message
*
*/
char* WINAPI apiSNGetOCRFromImage(HANDLE handle, char* szImageFilePath, SN_STATU* pStatu);/*释放OCR文字识别句柄（释放内存）
*
* 参数：
*	[in] handle：		句柄（通过调用apiSNCreateOCRHandle得到）
*
* 返回值：返回 0 表示成功，其他值表示错误号;
*
*/
int WINAPI apiSNDestroyOCRHandle(HANDLE handle);#endif

2.易语言调用C++ dll接口

.版本 2
.支持库 spec.程序集 窗口程序集_启动窗口.子程序 _启动子程序, 整数型_临时子程序 ()
返回 (0).子程序 _临时子程序
.局部变量 handle, 整数型
.局部变量 pResult, SN_STATU, 静态, , 返回错误信息，参数pResult.code(错误码)如果为 0 表示成功，否则表示错误号;
.局部变量 szOCRJson, 文本型, , , OCR识别结果 （json字符串）;
.局部变量 szTime, 文本型, , , 卡密结束时间;' ---------------------------------------------------------------
' 1.启动 OCR 文字识别服务
' 其中卡密 SNKJe9xffLhdFY7r3TcffXq44ThDVcE3BQFQFfVA9VG4 仅用于测试，需要找开发人员重新购买，购买卡密连接：https://shop.4yuns.com/links/7C9F16B7
' ---------------------------------------------------------------
apiSNInitOCRServer (“SNOCR.onnx”, pResult)
调试输出 (pResult.code, 到文本 (pResult.message))
.如果真 (pResult.code ＜ 0)调试输出 (“-----------程序结束-----------”)返回 ().如果真结束
' 2.创建 OCR 文字识别句柄
handle ＝ apiSNCreateOCRHandle (“SNKJe9xffLhdFY7r3TcffXq44ThDVcE3BQFQFfVA9VG4”, “SNOCR.onnx”, pResult)
调试输出 (pResult.code, 到文本 (pResult.message))
调试输出 (“句柄”, handle)
.如果真 (pResult.code ＜ 0)调试输出 (“-----------程序结束-----------”)返回 ()
.如果真结束
' 3.识别 OCR 文字识别，返回 json 字符串
szOCRJson ＝ apiSNGetOCRFromImage (handle, “d:\\22.png”, pResult)
调试输出 (到文本 (szOCRJson))' 4.识别 OCR 文字卡密到期时间
szTime ＝ apiSNGetKeyExpiresTime (handle, pResult)
调试输出 (到文本 (szTime))
' 5.释放 OCR 文字识别内存
apiSNDestroyOCRHandle (handle)
调试输出 (“-----------程序结束-----------”)

三.效果演示

1.图片1

识别效果：

{"type":	0,"task_id":	1,"err_code":	0,"ocr_result":	{"single_result":	[{"left":	114.244186,"top":	23.175808,"right":	271.365000,"bottom":	46.518356,"str_utf8":	"中国农业银行","rate":	"0.999777"}, {"left":	19.323814,"top":	24.856495,"right":	122.353912,"bottom":	50.065903,"str_utf8":	"ABCO","rate":	"0.766064"}, {"left":	353.547882,"top":	89.664581,"right":	422.770813,"bottom":	125.902084,"str_utf8":	"ck","rate":	"0.739968"}, {"left":	342.670288,"top":	119.914871,"right":	416.961487,"bottom":	138.448044,"str_utf8":	"闪付Rass","rate":	"0.917070"}, {"left":	49.198284,"top":	149.225143,"right":	409.334000,"bottom":	180.329193,"str_utf8":	"622848 1888888888888","rate":	"0.976407"}, {"left":	331.121216,"top":	207.541183,"right":	404.778625,"bottom":	228.257782,"str_utf8":	"UnionPa","rate":	"0.991631"}, {"left":	357.729156,"top":	225.322922,"right":	401.864594,"bottom":	244.370834,"str_utf8":	"银联","rate":	"0.935912"}, {"left":	19.047916,"top":	252.733337,"right":	50.175000,"bottom":	266.206238,"str_utf8":	"ATM","rate":	"0.902741"}],"width":	"446","height":	"280"}
}

2.图片2

识别效果：

{"type":	0,"task_id":	1,"err_code":	0,"ocr_result":	{"single_result":	[{"left":	102.208336,"top":	41.812500,"right":	329.854156,"bottom":	67.829170,"str_utf8":	"中国建设银行","rate":	"0.939104"}, {"left":	104.431534,"top":	68.423492,"right":	309.992828,"bottom":	84.602386,"str_utf8":	"China Construction Bank","rate":	"0.966887"}, {"left":	102.672920,"top":	96.168755,"right":	403.258331,"bottom":	111.964584,"str_utf8":	"龙卡通(储蓄卡)LONG CARD(DEBIT CARD)","rate":	"0.968900"}, {"left":	41.781921,"top":	137.955643,"right":	410.251556,"bottom":	164.107880,"str_utf8":	"6227 0033 2069 0222 205","rate":	"0.975151"}, {"left":	20.770407,"top":	210.668716,"right":	77.230583,"bottom":	230.122101,"str_utf8":	"ATM","rate":	"0.935433"}, {"left":	103.137505,"top":	185.368759,"right":	192.337509,"bottom":	207.204163,"str_utf8":	"CCB GZ","rate":	"0.960131"}, {"left":	338.376495,"top":	201.118103,"right":	417.111450,"bottom":	224.273529,"str_utf8":	"UnionPa","rate":	"0.929293"}, {"left":	367.485413,"top":	220.677078,"right":	413.479156,"bottom":	239.260422,"str_utf8":	"银联","rate":	"0.917808"}],"width":	"446","height":	"280"}
}