Qt中QZXing 的編譯與使用

Posted on by

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 編譯與使用內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：