免费试用

GB/T 21049 · ISO/IEC 20830

汉信码识别与生成 SDK

离线运行的汉信码编码、解码库。C 接口,Windows、Linux x64、Linux ARM64 和 .NET 都能直接调用;不依赖 OpenCV,也不需要联网。

当前版本 0.4.2 · 开发版 ¥399 起 · 已购版本永久使用

演示画面均为测试集样图,识读结果和耗时取自实际解码输出。

3,313 张测试图逐张比对真值

误读
0 次

3,013 张含码图,凡输出内容都与真值一致

无码图误报
0 / 300

文字、纹理、其他条码等干扰图

曲面弯曲识读率
87%

0.4.1 为 18%,同一批测试图

中位解码耗时
4.5 ms

全部含码图,Linux x64 测试机

支持的平台

四种形式,同一套解码代码和授权方式。授权按运行设备签发,买一次可在对应平台上一直使用已购版本。

Windows x64

SinoMatrix.dll、头文件、导入库。部署只需一个 DLL,不依赖 OpenSSL、OpenCV。

  • C / C++、C#、Python 示例
  • Qt 图形 Demo 及其源码

Linux x64

libSinoMatrix.so,按 glibc 2.17 编译、C++ 运行库静态链接,适用于 glibc 2.17 及以上(CentOS 7 起)的发行版。

  • C 示例与 CMake 工程
  • 命令行设备申请程序

Linux ARM64

面向鲲鹏、飞腾等 ARM64 服务器和麒麟、统信 UOS 等发行版,要求同 Linux x64。

  • 与 x64 相同的接口和示例
  • 未做操作系统厂商兼容认证

NuGet

dotnet add package SinoMatrix.HanXin

  • .NET Framework 4.x、.NET Core 3.x、.NET 5–8
  • 自带 win-x64、linux-x64、linux-arm64 运行库

几行代码接入

输入 8 位灰度图,返回 UTF-8 文本;读不出时返回“未识别”,不会猜一个结果给你。完整示例在下载包的 examples 目录。

// dotnet add package SinoMatrix.HanXin
using SinoMatrixSdk;

HanXin.LoadLicense("license.lic");          // 程序启动时调用一次

// 识别:传入 8 位灰度图,读不出返回 null
string text = HanXin.Decode(gray, width, height, stride, timeLimitMs: 2000);

// 生成:返回 8 位灰度图(0=黑,255=白)
byte[] img = HanXin.Encode("追溯码 SMHX-2026-000123", out int w, out int h);
#include "SinoMatrix.h"

SinoMatrix_LoadLicenseFileUtf8("license.lic");      /* 启动时一次 */

SinoMatrixImageView image = { gray, width, height, stride };
SinoMatrixHanXinDecodeOptionsV2 options;
SinoMatrix_InitializeHanXinDecodeOptionsV2(&options);
options.timeLimitMs = 2000;

SinoMatrixHanXinDecodeResultV2 result = { 0 };
if (SinoMatrix_HanXinDecodeGray8V2(image, &options, &result) == SinoMatrixStatus_Ok)
    fwrite(result.base.textUtf8.data, 1, result.base.textUtf8.size, stdout);
SinoMatrix_FreeHanXinDecodeResultV2(&result);     /* 成功失败都要释放 */
# 包内 examples/python/sinomatrix.py,读图需要 pip install pillow
from sinomatrix import SinoMatrix

sdk = SinoMatrix()                  # 加载同目录的 SinoMatrix.dll / libSinoMatrix.so
sdk.load_license("license.lic")

print(sdk.decode_file("label.jpg", time_limit_ms=2000))   # 读不出返回 None

w, h, pixels = sdk.encode("追溯码 SMHX-2026-000123")      # 生成
  • 内容中文(GB18030 各区)、UTF-8、数字、字母、二进制、ECI、GS1、URI 混合模式
  • 控制ROI 区域、候选数量、时间预算、取消回调
  • 结果文本、原始字节分段、版本、纠错等级、位置,可选图像质量分析

测试数据

3,313 张测试图:由 Zint、BWIPP(bwip-js)、TEC-IT 在线生成器和本 SDK 编码,再程序合成旋转、透视、曲面、模糊、污损、光照和背景变化,其中 300 张不含汉信码。每张图单独解码一次,结果和真值逐张比对。三家独立编码器生成的 84 个版本标准图全部读出。

在什么条件下能读出来

每格是一段难度区间,数字是该区间的识读成功率,颜色越深越好。区间有意一直覆盖到读不出的程度,方便判断你的场景落在哪里。

标准图84 个版本 × 4 级纠错
  1. 100%600 张全部读出,600 张
任意角度旋转每模块 3 像素起
  1. 100%300 张全部读出,300 张
平面 / 曲面曲面如瓶身、软包装
  1. 100%平面透视,200 张
  2. 87%曲面弯曲,100 张
透视程度四角偏移 ÷ 边长
  1. 95%0.04–0.08,87 张
  2. 97%0.08–0.12,69 张
  3. 97%0.12–0.16,64 张
  4. 94%0.16–0.22,80 张
分辨率每个模块占几个像素
  1. 5%1–1.4 px,94 张
  2. 64%1.4–1.8 px,64 张
  3. 100%1.8–2.2 px,61 张
  4. 100%2.2–2.6 px,81 张
对焦模糊模糊半径 ÷ 模块
  1. 100%0.2–0.4,72 张
  2. 44%0.4–0.6,72 张
  3. 0%0.6–0.8,73 张
  4. 0%0.8–1,83 张
运动拖影拖影长度 ÷ 模块
  1. 100%0.5–1,63 张
  2. 100%1–1.5,81 张
  3. 56%1.5–2,78 张
  4. 8%2–2.5,78 张
污损遮挡墨点、孔洞、划痕、贴纸
  1. 78%0%–5%,27 张
  2. 69%5%–10%,74 张
  3. 29%10%–15%,77 张
  4. 4%15%–20%,81 张
  5. 0%20%–30%,41 张
光照不均阴影、渐变、反光、反色
  1. 73%全部区间,300 张
复杂背景文字、纹理、多个码
  1. 97%全部区间,300 张

稳定区间:每模块不少于 1.8 像素、对焦模糊不超过 0.4 个模块、拖影不超过 1.5 个模块、透视偏移在边长的 22% 以内。超出后成功率明显下降。

曲面弯曲的汉信码测试图
曲面弯曲
大角度透视加弯曲的汉信码测试图
大角度透视 + 弯曲
大面积污损的汉信码测试图
大面积污损
旋转的汉信码测试图
任意角度旋转

以上都是合成图,不能代替实拍;我们不承诺任意图片百分百识别。耗时为 Linux x64 测试机数据,与 Windows DLL 为同一套解码代码。查看完整测试报告

14 天免费试用

试用版和正式版是同一个包,区别只在授权文件。先用你自己的设备和样本测,满意再买。

  1. 下载 SDK 包

    .NET 项目也可以直接装 NuGet 包,设备申请程序在 SDK 包里。

  2. 在运行设备上生成申请文件

    Windows 运行 bin\SinoMatrixDeviceRequest.exe,Linux 运行 bin/sinomatrix-device-request,得到 device-request.req。

  3. 把申请文件发给我们

    通过淘宝旺旺发送,注明“试用”。我们签发该设备的 14 天 license.lic,每台设备可试用一次。

  4. 加载授权开始测试

    程序启动时加载 license.lic。购买后用同一份申请文件签发正式授权,不用重新集成。

价格

按登记设备数量授权,已购版本永久使用,交付后 90 天安装与缺陷支持。下单和付款在淘宝完成。

  • 开发版1 台登记设备
    ¥399
    开发调试或单机部署
  • 运行时授权包10 台登记设备
    ¥1,999
    随你的应用部署到客户设备
  • 运行时授权包100 台登记设备
    ¥9,800
    约 ¥98 / 台

以上为 Windows x64 价格,NuGet 包在 Windows 上使用同样适用。Linux x64 / ARM64 价格请联系确认;OEM/无限分发、源码买断、Android 等其他平台请联系洽谈。

常见问题

需要联网吗?
不需要。识别和授权校验都在本机完成,适合内网和离线设备。
授权怎么算?换电脑怎么办?
每台运行设备一份 license.lic,按设备指纹签发。改计算机名不影响;换机、重装系统导致指纹变化时请联系我们迁移。
能保证识别率吗?
不承诺任意图片百分百识别。上面的测试数据说明了能力范围,实际效果请用试用授权在你的设备和样本上评估。
支持哪些开发语言?
能调用 C 动态库的语言都可以。包内有 C、C#、Python 示例;Java(JNA)、Go(cgo)等可按头文件自行封装。
提供源码吗?
默认交付编译好的库,不含 SDK 核心源码。源码买断或 OEM 请联系洽谈。
支持 32 位或手机吗?
目前只提供 64 位 Windows 和 Linux。Android 等平台可以定制,请联系确认。

联系我们

索取试用、询价、技术问题都可以。发申请文件时请写明“试用”或订单号。