Qt中QZXing 的编译与使用

0.前言

zxing 是一个开源的一维/二维条码图像处理库，当前版本为 Java 语言开发：

https://github.com/zxing/zxing

QZXing 是 ZXing 的 Qt 移植版本，同样还有 cpp 等语言和框架的移植版本。从 QZXing 的文档可以看到，只有 QR Code 二维码支持编码，其他都只支持解码。

https://github.com/ftylitak/qzxing

1.编译

下载源码后可以用 CMake 或者直接打开 pro 进行构建。网上有人编译失败，但是我用 Qt5.15 + VS2019 编译 QZXing3.3.0 并没有出现编译问题。 编译复制头文件和库文件到我们的工程。

 测试工程（Qt5 + MSVC2019）：

https://github.com/gongjianbo/MyTestCode2021/tree/master/Qt/QtQZXingVS2019

2.二维码生成

先打开编码功能，添加一个宏：

DEFINES += ENABLE_ENCODER_GENERIC

然后从 QZXing README 看简单的生成示例：

#include "QZXing.h"
 
int main()
{
    QString data = "text to be encoded";
    QImage barcode = QZXing::encodeData(data);
    //QImage barcode = QZXing::encodeData(data, QZXing::EncoderFormat_QR_CODE,
    //                                    QSize(240, 240), QZXing::EncodeErrorCorrectionLevel_H);
}

接口声明：

#ifdef ENABLE_ENCODER_GENERIC
//二维码编码接口，目前仅支持QR Code码
//QZXingEncoderConfig是个结构体，成员如下一个重载接口的参数
static QImage encodeData(const QString &data,
                         const QZXingEncoderConfig &encoderConfig);
 
//二维码编码接口，目前仅支持QR Code码
//encoderFormat 编码格式枚举
//encoderImageSize 生成二维码的大小
//errorCorrectionLevel 纠错等级
//border =true会有一圈白边，感觉没啥用
//transparent =true会半透明，感觉没啥用
static QImage encodeData(const QString& data,
                         const EncoderFormat encoderFormat = EncoderFormat_QR_CODE,
                         const QSize encoderImageSize = QSize(240, 240),
                         const EncodeErrorCorrectionLevel errorCorrectionLevel = EncodeErrorCorrectionLevel_L,
                         const bool border = false,
                         const bool transparent = false);
#endif // ENABLE_ENCODER_GENERIC

由于是使用 Qt 封装的，所以不用像其他库那样还要自己根据矩阵结果绘制 QImage。 

3.二维码识别

文档里着重讲了解码的使用，并且封装了相应的 QML 组件。

C++ 使用：

#include "QZXing.h"
 
int main()
{
    QImage imageToDecode("file.png");
    QZXing decoder;
    //必要设置
    decoder.setDecoder(QZXing::DecoderFormat_QR_CODE | QZXing::DecoderFormat_EAN_13 );
 
    //可选设置
    //decoder.setSourceFilterType(QZXing::SourceFilter_ImageNormal | QZXing::SourceFilter_ImageInverted);
    decoder.setSourceFilterType(QZXing::SourceFilter_ImageNormal);
    decoder.setTryHarderBehaviour(QZXing::TryHarderBehaviour_ThoroughScanning | QZXing::TryHarderBehaviour_Rotate);
 
    //解码
    QString result = decoder.decodeImage(imageToDecode);
}

 QML 使用：

#include "QZXing.h"
 
int main()
{
	...
	QZXing::registerQMLTypes();
	...
}

import QtQuick 2.0
import QZXing 3.3
 
Item{
    function decode(preview) {
        imageToDecode.source = preview
        decoder.decodeImageQML(imageToDecode);
    }
 
    Image{
        id:imageToDecode
    }
 
    QZXing{
        id: decoder
 
        enabledDecoders: QZXing.DecoderFormat_QR_CODE
 
        /
        //可选设置
        tryHarderType: QZXing.TryHarderBehaviour_ThoroughScanning | QZXing.TryHarderBehaviour_Rotate
 
        imageSourceFilter: QZXing.SourceFilter_ImageNormal //| QZXing.SourceFilter_ImageInverted
        /
 
        onDecodingStarted: console.log("Decoding of image started...")
 
        onTagFound: console.log("Barcode data: " + tag)
 
        onDecodingFinished: console.log("Decoding finished " + (succeeded==true ? "successfully" : "unsuccessfully") )
    }
}

参数较多，如果有疑问可以搜 zxing 的文档。经测试，该库是可以做一些简单的图像识别，可以识别截图中的二维码，但是对拍照的二维码识别不了，所以要直接识别还是得用上图像处理库。

到此这篇关于Qt中QZXing 的编译与使用的文章就介绍到这了,更多相关QZXing 编译与使用内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞！