C++ 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接口
#include <iostream>
#include "SNOCR.h"
int main()
{
struct SN_STATU statu = { 0 };
char szExeFullPath[4096] = { 0 };
char szImagePath[4096] = { 0 };
//卡密
char szKey[4096] = "SNKJe9xffLhdFY7r3TcffXq44ThDVcE3BQFQFfVA9VG4";
//onnx模型路径
char szOnnxFullPath[4096] = { 0 };
GetModuleFileName(NULL, szExeFullPath, 4096);
*strrchr(szExeFullPath, '\\') = 0;
sprintf(szOnnxFullPath, "%s\\SNOCR.onnx", szExeFullPath);
// 注意路径不要带有中文
sprintf(szImagePath, "%s\\7.jpg", szExeFullPath);
//1.启动OCR服务
int ret = apiSNInitOCRServer(szOnnxFullPath, &statu);
if (ret < 0)
{
printf("Error:%s \n", statu.message);
return 0;
}
//2.创建OCR句柄
HANDLE handle = apiSNCreateOCRHandle(szKey, szOnnxFullPath, &statu);
if (!handle)
{
printf("Error:%s \n", statu.message);
return 0;
}
//3.获取卡密到期时间
char* szTime = apiSNGetKeyExpiresTime(handle, &statu);
if (!szTime)
{
printf("Error:%s \n", statu.message);
return 0;
}
//4.识别OCR,返回Json字符串
char* szJson = apiSNGetOCRFromImage(handle, szImagePath, &statu);
if (!szJson)
{
printf("Error:%s \n", statu.message);
return 0;
}
printf("%s \n", szJson);
//5.释放内存
apiSNDestroyOCRHandle(handle);
getchar();
}
三.效果演示
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"
}
}
四.常见问题
1.是否支持多线程
支持
五.更新日志
- 2024.12.15 OCR 文字识别支持C++/Python/易语言
六.云盘源码下载
- 百度云盘
- 夸克云盘
- 123云盘