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
库。
开发环境说明
- 将qrencode使用Qt封装为一个生成、显示二维码的控件;
- 支持使用QPainter绘制显示二维码;
- 可通过函数接口返回生成的二维码QImage;
- 可通过调用函数将生成的二维码保存到指定路径;
- 支持使用源码嵌入工程(更好的跨平台、支持各种编译器);
- 支持使用编译好的静态库(MSVC2017-64);
将qrencode-4.1.1解压后,创建一个build文件夹;
打开Cmake,将qrencode-4.1.1文件夹下的CMakeLists.txt文件拖入CMake中;
点击【Configure】;
这里我选择了MSVC2017-64编译器,点击【Finish】;
如下图所示进行配置,配置不正确会由于没有准备依赖而报错;
C:/Users/MHF/Downloads/qrencode-4.1.1/QRencode
;然后点击【Generate】、【Open Project】打开VS;
鼠标右键选择【ALL_BUILD】,点击【生成】,然后选择【INSTALL】,点击【生成】;
就可以在安装路径下生成编译好的文件了;
创建一个工程,将编译后的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
将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
四项修改为如下所示,与自己下载的版本号相同;
然后就可以正常编译了;
在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);
}
🎈🎈 ☁️
🎈🎈🎈
☁️ 🎈🎈🎈🎈
🎈🎈🎈🎈
☁️ 🎈🎈🎈
|/
🏠 ☁️
☁️ ☁️
🌳🌻🏫🌳🏘🏢_🏘🏢🌲🌳