首页
/ ZXing-CPP 2.3.0版本发布:条码识别库的重大更新

ZXing-CPP 2.3.0版本发布:条码识别库的重大更新

2025-07-01 18:45:21作者:尤峻淳Whitney

ZXing-CPP是一个基于C++实现的条码识别开源库,它是流行的ZXing(Zebra Crossing)项目的C++移植版本。该库支持多种一维和二维条码格式的识别,包括QR码、Data Matrix、PDF417、Aztec等,广泛应用于各种需要条码识别功能的软件系统中。

核心功能增强

本次2.3.0版本带来了多项重要的功能改进和性能优化:

  1. 新增条码格式支持

    • 增加了对DX Film Edge格式的读取支持
    • 新增了对Aztec Runes符号的检测和读取能力
    • 添加了对DataBarLimited符号的读取支持(由EUREKAM赞助)
  2. 图像处理优化

    • 重新实现了LocalAverage二值化算法,采用对称阈值插值技术,显著提高了对反转符号的检测能力
    • ImageView类增加了边界校验功能,提高了安全性
    • 新增了ImageFormat::LumX格式,支持2字节灰度+alpha通道的输入
  3. API改进

    • 引入了新的Barcode类替代Result类(Result将在3.0版本移除)
    • 添加了ZXing::Version()函数,可在运行时查询库版本
    • 图像格式命名规范化,将'X'替换为'A'(如RGBX改为RGBA)

跨平台与语言支持

ZXing-CPP 2.3.0显著增强了跨平台和多语言支持能力:

  1. 新增语言绑定

    • 正式构建中加入了C API支持(需通过cmake -DZXING_C_API=ON启用)
    • 新增了基于C API的Rust包装器
    • 新增了基于C API的.NET包装器
    • 增加了Kotlin/Native包装器支持
  2. 平台特定改进

    • Android版本增加了对Android 15灵活页面大小的支持
    • 将Android命名空间从zxingcpp改为zxingcpp.lib,解决了Maven Central发布问题
    • iOS包装器移除了initWithFormats初始化器,简化了API
  3. 构建系统改进

    • 将cmake选项前缀从BUILD_改为ZXING_
    • 默认使用C++20标准构建核心库
    • 添加了/utf-8到MSVC编译标志
    • 使构建在不同目录下具有可重现性

命令行工具增强

ZXingReader命令行工具获得了多项新功能:

  1. 新增-binarizer选项,支持local/global/fixed三种二值化方法
  2. 添加-single选项,可设置maxNumberOfSymbols(1)
  3. 完善了-formats参数解析,包括's'格式支持
  4. 支持从标准输入读取图像文件(通过传递'-'参数)

实验性API

2.3.0版本引入了一些实验性API(需通过cmake选项-DZXING_EXPERIMENTAL_API=ON启用):

  1. 全新的Create+Write API,用于生成/写入条码(将替代MultiFormatWriter)
  2. 基于libzint的新写入器后端
  3. 新增Barcode::symbol()属性,提供ImageView访问
  4. Python绑定中新增了实验性写入API

性能优化与问题修复

本次更新包含了大量性能优化和错误修复:

  1. 解码算法改进

    • DataMatrix解码器提高了对接近45°旋转符号的检测能力
    • DataBar解码器通过整合edge-2-edge模式提高了检测率
    • QR解码器现在即使存在校验和错误也会返回部分内容
    • 改进了ITFReader的多个方面
  2. 问题修复

    • 修复了BitHacks中可能导致在Pre-Haswell Windows机器上生成随机QR码内容的问题
    • 解决了PDF417解码时右侧可能错误折叠到(0,0)位置的问题
    • 调整了Barcode的operator==(),避免过度分割高线性符号
  3. 其他改进

    • 更新了HRI AIs至最新的gs1-syntax-dictionary.txt
    • 弃用了validateITFCheckSum、validateCode39CheckSum和returnCodabarStartEnd等函数
    • 确保macOS和64位Linux的Python包支持多符号DataMatrix检测(需要C++20支持)

总结

ZXing-CPP 2.3.0是一个功能丰富、改进显著的版本,不仅增加了对新条码格式的支持,还大幅提升了现有功能的稳定性和性能。特别是新增的跨语言绑定和实验性写入API,为开发者提供了更多可能性。对于需要高性能条码识别功能的项目,这个版本值得考虑升级。

登录后查看全文
热门项目推荐