lua-quirc

二维码(QRCode)图像扫描库 quirc 的 Lua 接口。

quirc 只支持 8bit 的无压缩灰度图像(下文简称 raw 格式)，像 jpg/png 等带压缩的格式需自行转换。

编译

安装依赖：

sudo apt-get install libjpeg-dev libpng-dev

下载 quirc 源码到本文件夹：

COMMIT=307473dbcab5e6c9654944c034b2426f46ac509f
wget -qO- https://github.com/dlbeer/quirc/archive/$COMMIT.tar.gz | tar -xzv
mv quirc-$COMMIT quirc

运行 make 编译，默认编译 3 个 target：

• quirc.so 就是引入在应用项目的 Lua 模块。
• readraw.so 读取 raw 格式的 lightuserdata 模块，测试演示用。
• qrdump 可执行命令，直接分析 jpg/png 中的二维码及信息，依赖 libjpeg/libpng 库，测试演示用。

RAW 格式

表示一张 8bit 的灰度图像，原点在左上角，一字节一像素，所以长度需要等于高宽的乘积。

这里的图像是指从类似相机/视频截取出来的图像，二维码出现在任意位置，可能旋转的、模糊的、残缺的，能否识别出数据取决于图片的清晰度。

只包含像素数据，不带高宽数据，所以被处理时高宽得另外传递。

API 接口

scan(bytes, width, height)

扫描 raw 图像，识别出里面的二维码，并返回二维码的内容。

参数

• width 图像的宽度，number 类型
• height 图像的高度，number 类型
• bytes 图像的数据，string 类型

返回值

如果识别不出任何二维码，则返回 nil，否则返回一个 table。

table 包含以下字段：

名称	类型	描述
payload	string	数据内容
length	number	数据内容长度
mask	number	掩码图案
version	number	版本号
data_type	number	数据类型
ecc_level	number	ECC Level

scan_lud(lud)

参数

lud 为一个 lightuserdata 对象，基本上同 scan() 的参数结构如下：

typedef struct {
    char *bytes;
    unsigned long length;
    unsigned long width;
    unsigned long height;
} qrimageraw;

返回值

同 scan()

使用示例

假设有二维码图像 hello.png，内容为 hello，高宽均为 46 像素。

wget 'http://chart.googleapis.com/chart?cht=qr&chs=46x46&chld=H|0&chl=hello' -O hello.png

test-raw.lua

使用方法

lua test-raw.lua image.raw width:height

image.raw 图像文件，width:height，冒号分隔高宽。

可以用上面的 qrdump 来创建 hello.raw 文件

$ ./qrdump hello.png hello.raw

... 忽略其余输出 ...

Success to write image raw file:
file: hello.raw
width: 46 pixels
height: 46 pixels
length: 2116 bytes

$ lua test-raw.lua hello.raw 46:46
hello.raw
mask: 6
version: 1
length: 5
payload: hello
ecc_level: 2
data_type: 4

test-hex.lua

这个只是为了方便调试 raw 图像构造而已，转换成十六进制文本查看：

xxd -c 46 hello.raw | sed 's/^.\+: //; s/ //g; s/\.\+//;' > hello.hex

xxd 的参数 -c 表示多少字节换行，然后 sed 去除掉地址和 ASCII 内容，打开 hello.hex，二维码肉眼能识别，在 lua 里可以转换回去。

$ lua test-hex.lua hello.hex
hello.raw
mask: 6
version: 1
length: 5
payload: hello
ecc_level: 2
data_type: 4

test-lud.lua

和 test-raw.lua 大同小异，只不过用 readraw.so 来读取 raw 图像文件，使用 scan_lud() 接口