在生活中常常可以看到条码(Barcode)的存在,无论是商品结帐时在收银台使用的 EAN 条码、书籍使用的 ISBN 条码,还是在最近因行动设备的流行也跟着带动起来的 QR Code,这些条码都可以让我们的生活更便利,传递信息的速度更快,省下许多使用键盘打字的时间。zBar 是一个使用 C 语言开发的函数库,效率极佳,支持多种一维条码和二维条码的扫描,要如何在 Rust 上使用 zBar 函数库进行条码扫描呢?

ZBar Rust

「ZBar Rust」是笔者开发的套件,可以让 Rust 程序绑定 zBar 的函数库,使 Rust 程序能够直接使用 zBar 函数库的功能。

Crates.io

Cargo.toml

zbar-rust = "*"

编译

zBar 是使用 C 语言开发的,因此无法直接被引用至 Rust 程序中使用,必须要使用这篇文章介绍的做法来引用才行。为了简化问题,「ZBar Rust」套件可以自动绑定操作系统中安装的 zBar 函数库。如果想要手动设置 zBar 函数库的位置也是可以的,尤其是想要让 Rust 程序可以在无 zBar 函数库的运行环境中使用,要先设置好以下的几个环境变量:

  • ZBAR_LIB_DIRS:函数库文件所在的目录位置。这个变量类似 C/C++ 编译器中 -L 参数的用途。路径如果有多个的话,必须使用 : 隔开。
  • ZBAR_LIBS:函数库的名称。这个变量类似 C/C++ 编译器中 -l 参数的用途。名称如果有多个的话,必须使用 : 隔开。通常这个变量的值是 iconv:zbar。
  • ZBAR_INCLUDE_DIRS:函数库标头档的路径。这个变量类似 C/C++ 编译器中 -I 参数的用途。路径如果有多个的话,必须使用 : 隔开。

使用方法

zbar_rust 这个 crate 底下有 ZBarImageScanner 结构体,这个结构体提供了 new 关联函数,可以用来产生 ZBarImageScanner 的结构实体。ZBarImageScanner 结构实体提供了 scan_y800 方法,可以用来扫描一张灰阶图片。如果扫描成功,scan_y800 方法会回传 Vec<ZBarImageScanResult> 结构实体,每个 ZBarImageScanResult 结构实体分别代表着一个条码图案的扫描结果。可以利用 ZBarImageScanResult 结构实体的 symbol_type 字段来查看条码的类型,用 data 字段来读取解码后的数据。

如果要读取任意格式的图片,建议搭配 image 等图像处理的 crate 来将读取到的图片转为灰阶格式。

例如:

use zbar_rust::ZBarImageScanner;

use image::GenericImageView;

let img = image::open(INPUT_IMAGE_PATH).unwrap();

let (width, height) = img.dimensions();

let mut scanner = ZBarImageScanner::new();

let mut results = scanner.scan_y800(img.into_luma8().into_raw(), width, height).unwrap();

for result in results {
    println!("{}", String::from_utf8(result.data).unwrap())
}