Qt-qrencode开发-生成、显示二维码

2024-05-30 22:28 由 mahuifa 发表于 #其他

Qt-qrencode开发-生成二维码📀

Qt-qrencode开发-生成二维码📀

1、概述📸

qrencode是一个用于生成QR码（二维码）的库，它支持多种编程语言的接口，包括C、C++、Python等。QR码是一种矩阵式二维码，常用于存储网址、联系信息、文字信息等，广泛应用于各种场景，如产品追踪、广告宣传、文档管理等。

qrencode的设计简洁高效，提供了易于使用的API接口，使得开发者能够轻松地在应用程序中集成QR码生成和处理功能

库的基本特性

生成能力：qrencode库能够生成不同版本和纠错级别的QR码，支持从最小的版本1（21x21的模块）到最高的版本40（177x177的模块），并且可以根据需要调整纠错等级（L、M、Q、H）。

输出格式：库支持生成多种格式的输出，包括PNG图片、SVG矢量图、ASCII文本形式的二维码等，这取决于库的具体实现和使用的接口。

编码内容：支持多种数据类型编码，如数字、字母、二进制数据、UTF-8文本、电子邮件地址、电话号码、URL等。

C++接口：对于C++，qrencode提供了丰富的类和方法来方便地生成二维码。用户可以创建一个QRcode对象，向其中添加数据，然后将其渲染成所需的格式。

C接口：对于C语言使用者，qrencode也提供了函数接口，通过这些函数可以直接操作二维码数据结构，进行编码和输出。

跨平台：qrencode库是跨平台的，可以在多种操作系统上编译和使用，包括Windows、Linux、macOS等。

依赖：在某些情况下，如生成PNG图片输出时，qrencode可能需要额外的依赖，如libpng和zlib库。

开发环境说明

系统：Windows11、Ubuntu20.04
Qt版本：V5.14.2
编译器：MSVC2017-64、GCC/G++64
qrencode版本：4.1.1
- 官方下载

2、实现效果💽

将qrencode使用Qt封装为一个生成、显示二维码的控件；

支持使用QPainter绘制显示二维码；

可通过函数接口返回生成的二维码QImage；

可通过调用函数将生成的二维码保存到指定路径；

支持使用源码嵌入工程（更好的跨平台、支持各种编译器）；

支持使用编译好的静态库（MSVC2017-64）；

3、编译qrencode🔍

下载源代码
将qrencode-4.1.1解压后，创建一个build文件夹；
打开Cmake，将qrencode-4.1.1文件夹下的CMakeLists.txt文件拖入CMake中；
点击【Configure】；
这里我选择了MSVC2017-64编译器，点击【Finish】；
如下图所示进行配置，配置不正确会由于没有准备依赖而报错；
1. 设置编译后的安装路径为C:/Users/MHF/Downloads/qrencode-4.1.1/QRencode；
2. 勾选WITHOUT_PNG，表示不支持png；
3. 取消勾选WITH_TOOLS，否则会报错。
然后点击【Generate】、【Open Project】打开VS；
鼠标右键选择【ALL_BUILD】，点击【生成】，然后选择【INSTALL】，点击【生成】；
就可以在安装路径下生成编译好的文件了；

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);
}

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

🌳🌻🏫🌳🏘🏢_🏘🏢🌲🌳