因行动设备的流行而跟着带动起来的 QR Code,是众多条码类型的其中一种,它让我们的生活更便利,传递信息的速度更快,省下许多使用键盘打字的时间。如果要产生出 QR Code,已经有许多相关的现成工具能够使用,甚至还能直接在网页上产生。只是有的时候还是会遇到需要在自己的程序中加入产生 QR Code 的状况,像是需要产生大量的 QR Code 时,或是想要让自己的程序能不依赖其他工具就能独立使用。这篇文章,将会探讨如何使用 Rust 编程语言产生 QR Code。
QR Code Generator
「QR Code Generator」是笔者开发的套件,采用「nayuki/QR-Code-generator」这个跨编程语言的 QR Code 产生函数库来产生 QR Code 的数据矩阵,并支持 RAW、SVG、PNG 格式的图档输出。
Crates.io
Cargo.toml
使用方法
qrcode_generator 这个 crate 提供了几个有用的函数,可以进行 QR Code 编码。带有 _from_segments 结尾的函数名称,属于低级的使用方法,可以优化产生出来的 QR Code 数据。
另外还可以使用 QrCodeEcc 枚举来控制 QR Code 数据的错误修正等级,其 Low 变体可以修正 7% 内的错误;Medium 变体可以修正 15% 内的错误;Quartile 变体可以修正 25% 内的错误;High 变体可以修正 30% 内的错误。错误修正的等级愈高,编码出来的数据量就会愈多,通常会因此使得 QR Code 的尺寸版本上升(白话一点来说就是 QR Code 的点数会变多),但是尺寸版本也有可能在错误修正等级的提升之下维持不变,因为数据量刚好没超过尺寸版本的容纳上限。程序员在使用这个套件时所指定的错误修正等级,这个套件会自动去选择相同尺寸版本中「最佳」的错误修正等级,比如说我们想要用 QrCodeEcc::Medium 来编码某个数据,但是这笔数据在使用 QrCodeEcc::High 编码出来的 QR Code 尺寸版本和使用 QrCodeEcc::Medium 编码 QR Code 尺寸版本是相同的话,这个套件就会选择使用 QrCodeEcc::High 来作为真正的错误修正等级。
to_image
to_image 函数可以将任意数据编码成 8 比特灰阶色域的图片原始(RAW)数据,方便进行后续的图像处理。原则上输出的数据类型为 Vec<u8>,但也可以在 to_image 名称后加上 _buffer,来将数据以 ImageBuffer<Luma<u8>, Vec<u8>> 类型输出。
程序如下:
use qrcode_generator::QrCodeEcc;
let result: Vec<u8> = qrcode_generator::to_image("Hello world!", QrCodeEcc::Low, 1024).unwrap();
println!("{:?}", result);
to_matrix
to_matrix 函数可以将任意数据编码成 Vec<Vec<bool>> 类型的 QR Code 二维数组,方便进行后续的处理。
程序如下:
use qrcode_generator::QrCodeEcc;
let result: Vec<Vec<bool>> = qrcode_generator::to_matrix("Hello world!", QrCodeEcc::Low).unwrap();
println!("{:?}", result);
to_png
to_png 函数可以将任意数据编码成 PNG 图片,写进任意的 Writer 中。在 to_png 函数名称后加上 _to_vec 可以将 PNG 图片数据以 Vec<u8> 类型来输出;加上 _to_file 可以将 PNG 图片数据输出成文件。
程序如下:
use qrcode_generator::QrCodeEcc;
qrcode_generator::to_png_to_file("Hello world!", QrCodeEcc::Low, 1024, "path/to/file.png").unwrap();
to_svg
to_svg 函数可以将任意数据编码成 SVG 图片,写进任意的 Writer 中。在 to_svg 函数名称后加上 _to_string 可以将 SVG 图片数据以 String 类型来输出;加上 _to_file 可以将 SVG 图片数据输出成文件。
程序如下:
use qrcode_generator::QrCodeEcc;
qrcode_generator::to_svg_to_file("Hello world!", QrCodeEcc::Low, 1024, None, "path/to/file.svg").unwrap();
低级用法
「nayuki/QR-Code-generator」的作者其实有提供优化 QR Code 的算法,能够将要编码的数据分段,分别套用适当的编码方式,以求最小的输出数据量。不过这个算法作者并没有用 Rust 实作出来,所以笔者只好另外开了 GitHub 项目,自行将作者用 Java 实作的程序转成 Rust。
GitHub:
另外这个项目还支持一些能够在 QR Code 中被额外优化的数据。例如网址,网址的通信协定(或称 Scheme)部份和网域的部份,可以转成大写,这样一来,该段数据在 QR Code 中就可以套用占用空间比较少的 Alphanumeric 编码模式,而不需用到 Byte 模式。
举一个例子:
use qrcode_generator::QrCodeEcc;
use url::Url;
let url = "https://magiclen.org/path/to/12345";
let ecc = QrCodeEcc::Low;
let naive_matrix = qrcode_generator::to_matrix(url, ecc).unwrap();
let url = Url::parse(url).unwrap();
let optimized_matrix = qrcode_generator::to_matrix_from_segments(
qrcode_segments_optimizer::make_segments_from_url(&url, ecc)
.unwrap()
.as_slice(),
ecc,
)
.unwrap();
assert!(optimized_matrix.len() < naive_matrix.len());
