Qt-qrencode開發-生成、顯示二維碼📀

mahuifa發表於2024-05-30
QT

Qt-qrencode開發-生成二維碼📀

目錄
  • Qt-qrencode開發-生成二維碼📀
    • 1、概述📸
    • 2、實現效果💽
    • 3、編譯qrencode🔍
    • 4、在QT中引入編譯為靜態庫的QRencode
    • 5、在Qt中直接使用QRencode原始碼
    • 6、在Qt中使用QRencode生成二維碼示例
    • 7、完整原始碼📑

1、概述📸

qrencode是一個用於生成QR碼（二維碼）的庫，它支援多種程式語言的介面，包括C、C++、Python等。QR碼是一種矩陣式二維碼，常用於儲存網址、聯絡資訊、文字資訊等，廣泛應用於各種場景，如產品追蹤、廣告宣傳、文件管理等。

qrencode的設計簡潔高效，提供了易於使用的API介面，使得開發者能夠輕鬆地在應用程式中整合QR碼生成和處理功能

庫的基本特性

  1. 生成能力：qrencode庫能夠生成不同版本和糾錯級別的QR碼，支援從最小的版本1（21x21的模組）到最高的版本40（177x177的模組），並且可以根據需要調整糾錯等級（L、M、Q、H）。
  2. 輸出格式：庫支援生成多種格式的輸出，包括PNG圖片、SVG向量圖、ASCII文字形式的二維碼等，這取決於庫的具體實現和使用的介面。
  3. 編碼內容：支援多種資料型別編碼，如數字、字母、二進位制資料、UTF-8文字、電子郵件地址、電話號碼、URL等。
  4. C++介面：對於C++，qrencode提供了豐富的類和方法來方便地生成二維碼。使用者可以建立一個QRcode物件，向其中新增資料，然後將其渲染成所需的格式。
  5. C介面：對於C語言使用者，qrencode也提供了函式介面，透過這些函式可以直接操作二維碼資料結構，進行編碼和輸出。
  6. 跨平臺：qrencode庫是跨平臺的，可以在多種作業系統上編譯和使用，包括Windows、Linux、macOS等。
  7. 依賴：在某些情況下，如生成PNG圖片輸出時，qrencode可能需要額外的依賴，如libpng和zlib庫。

開發環境說明

  • 系統：Windows11、Ubuntu20.04
  • Qt版本：V5.14.2
  • 編譯器：MSVC2017-64、GCC/G++64
  • qrencode版本：4.1.1
    • 官方下載

2、實現效果💽

  1. 將qrencode使用Qt封裝為一個生成、顯示二維碼的控制元件；
  2. 支援使用QPainter繪製顯示二維碼；
  3. 可透過函式介面返回生成的二維碼QImage；
  4. 可透過呼叫函式將生成的二維碼儲存到指定路徑；
  5. 支援使用原始碼嵌入工程（更好的跨平臺、支援各種編譯器）；
  6. 支援使用編譯好的靜態庫（MSVC2017-64）；

3、編譯qrencode🔍

  1. 下載原始碼

  2. 將qrencode-4.1.1解壓後，建立一個build資料夾；

  3. 開啟Cmake，將qrencode-4.1.1資料夾下的CMakeLists.txt檔案拖入CMake中；

  4. 點選【Configure】；

  5. 這裡我選擇了MSVC2017-64編譯器，點選【Finish】；

  6. 如下圖所示進行配置，配置不正確會由於沒有準備依賴而報錯；

    1. 設定編譯後的安裝路徑為C:/Users/MHF/Downloads/qrencode-4.1.1/QRencode；
    2. 勾選WITHOUT_PNG，表示不支援png；
    3. 取消勾選WITH_TOOLS，否則會報錯。

  7. 然後點選【Generate】、【Open Project】開啟VS；

  8. 滑鼠右鍵選擇【ALL_BUILD】，點選【生成】，然後選擇【INSTALL】，點選【生成】；

  9. 就可以在安裝路徑下生成編譯好的檔案了；

4、在QT中引入編譯為靜態庫的QRencode

  • 建立一個工程，將編譯後的QRencode資料夾複製到工程中；

  • 在工程的pro檔案中新增下列程式碼；

    CONFIG(debug, debug|release): {
LIBS += -L$$PWD/QRencode/lib/ -lqrencoded
}else{
LIBS += -L$$PWD/QRencode/lib/ -lqrencode
}
INCLUDEPATH += $$PWD/QRencode/include
DEPENDPATH += $$PWD/QRencode/include

5、在Qt中直接使用QRencode原始碼

  • 將qrencode-4.1.1資料夾中除了.h、.c、config.h.in外的檔案刪除，資料夾也刪除，qrenc.c也刪除；

  • 將config.h.in重新命名為config.h；

  • 在pro檔案中新增所有.h 、.c檔案；

  • 注意：還需要新增DEFINES += HAVE_CONFIG_H

    DEFINES += HAVE_CONFIG_H
SOURCES += \
    main.cpp \
    qrencode/bitstream.c \
    qrencode/mask.c \
    qrencode/mmask.c \
    qrencode/mqrspec.c \
    qrencode/qrencode.c \
    qrencode/qrinput.c \
    qrencode/qrspec.c \
    qrencode/rsecc.c \
    qrencode/split.c \
    widget.cpp

HEADERS += \
    qrencode/bitstream.h \
    qrencode/config.h \
    qrencode/mask.h \
    qrencode/mmask.h \
    qrencode/mqrspec.h \
    qrencode/qrencode.h \
    qrencode/qrencode_inner.h \
    qrencode/qrinput.h \
    qrencode/qrspec.h \
    qrencode/rsecc.h \
    qrencode/split.h \
    widget.h

  • 編譯後會報錯error: C2065: “MAJOR_VERSION”: 未宣告的識別符號；

  • 開啟config.h檔案，如下圖所示；

  • 將MAJOR_VERSION、MICRO_VERSION、MINOR_VERSION、VERSION四項修改為如下所示，與自己下載的版本號相同；

  • 然後就可以正常編譯了；

6、在Qt中使用QRencode生成二維碼示例

  • 在ui檔案中新增下列控制元件，並將QWidget提升為QrCodeView；

  • 實現程式碼

    #include "qrcodeview.h"
#include "qrencode.h"
#include <QDebug>
#include <QDir>
#include <QFileInfo>
#include <QPainter>

QrCodeView::QrCodeView(QWidget* parent)
    : QWidget{parent}
{}

void QrCodeView::setString(const QString& str)
{
    if (str.isEmpty())
        return;
    if (m_str == str)
        return;
    m_str = str;

    QRcode* qrcode = QRcode_encodeString(str.toStdString().data(), 2, QR_ECLEVEL_Q, QR_MODE_8, 1);
    if (!qrcode)   // 錯誤返回null
    {
        qInfo() << errno;   // 列印錯誤碼
        return;
    }

    int w = qMin(this->width(), this->height());   // 控制元件長寬的最小值，保證繪製完整正方形
    int qrcodeW = qMax(qrcode->width, 1);
    qreal size = w / qreal(qrcodeW);   // 二維碼小格子的長寬

    m_img = QImage(w, w, QImage::Format_ARGB32);
    QPainter painter(&m_img);
    painter.setBrush(Qt::white);   // 設定白色筆刷
    painter.setPen(Qt::NoPen);
    painter.drawRect(0, 0, w, w);   // 繪製w x w的白色背景
    painter.setBrush(Qt::black);    // 設定黑色筆刷用於繪製方塊

    for (qint32 y = 0; y < qrcodeW; y++)
    {
        for (qint32 x = 0; x < qrcodeW; x++)
        {
            unsigned char b = qrcode->data[(y * qrcodeW) + x];
            if (b & 0x01)   // 1=黑、0=白
            {
                QRectF rect(x * size, y * size, size, size);
                painter.drawRect(rect);   // 繪製黑色格子
            }
        }
    }
    delete qrcode;
    qrcode = nullptr;

    this->update();   // 繪製圖片
}

/**
 * @brief       儲存生成的二維碼圖片到指定路徑
 * @param path  儲存路徑 + 名稱.jpg
 * @return   true 儲存成功
 */
bool QrCodeView::save(const QString& path)
{
    if (path.isEmpty() || m_img.isNull())
        return false;

    QFileInfo info(path);
    if (info.suffix() == "jpg" || info.suffix() == "JPG")   // 只支援儲存為jpg格式
    {
        QDir().mkpath(info.path());   // 建立路徑，防止路徑不存在
        return m_img.save(path);
    }
    else
    {
        return false;
    }
}

/**
 * @brief   返回生成的二維碼圖片
 * @return
 */
QImage QrCodeView::getImage()
{
    return m_img;
}

/**
 * @brief          在控制元件中顯示二維碼
 * @param event
 */
void QrCodeView::paintEvent(QPaintEvent* event)
{
    QWidget::paintEvent(event);

    QPainter painter(this);
    int x = (this->width() - m_img.width()) / 2;
    int y = (this->height() - m_img.height()) / 2;
    painter.drawImage(x, y, m_img);
}

7、完整原始碼📑

  • github
  • gitee

　         🎈🎈  ☁️
　        🎈🎈🎈
☁️     🎈🎈🎈🎈
　      🎈🎈🎈🎈
　 ☁️    ⁣🎈🎈🎈
　          |/
　          🏠   ☁️
　 ☁️         ☁️

🌳🌻🏫🌳🏘🏢_🏘🏢🌲🌳

相關文章