C/C++二维码生成库qrencode编译与使用

news2024/12/25 9:24:39

                    
                        
                    
                    1 qrencode介绍 
qrencode 是一个用于生成 QR 码（Quick Response Code）的工具和库。QR 码是一种矩阵条形码或二维条形码，能够在水平和垂直方向上存储信息。qrencode 支持多种编码方式，并能够生成不同复杂度和错误校正级别的 QR 码。
 
2 资源 
gitub
官网
 
3 编译 
如果不想自己编译，可以跳过此章节。我分别编译了Windows和Linux平台的静态和动态库，可直接使用
工程地址
这里以 4.1.0版本为例
 
3.1 Windows平台编译 
找到cmake的安装目录的 bin目录下，双击打开cmake ui界面cmake-gui.exe
分别选择qrencode代码根目录和编译目录，可创建一个build目录，在build目录中编译 
  
 
点击Configure后，会弹出一个对话框，分别选择编译器和架构。然后点击Finish，等待配置生成。 
  
 
等待配置生成后，会出现一些选项。默认是生成静态库，勾选BUILD_SHARED_LIBS会生成动态库，CMAKE_INSTALL_PREFIX选择安装目录，默认会安装到C:/Program Files (x86)/QRencode目录下 
  
 
选项设置完成后，点击Genrate
如果出现以下报错，不用管，进入qrencode源代码根目录下的build目录，双击打开QRencode.sln，用visual studio编译。 
  
 
先选择qrencode工程，点击生成，会生成头文件和库，再点击INSTALL，点击生成，会进行安装。这样在build目录下会生成include和lib目录，其中就是生成的头文件和库文件。 
  
 
 
3.2 Linux平台编译 
进入源代码根目录，在根目录下创建build文件夹，在build目录下执行cmake ..
接下来需要打开Linux平台的cmake gui工具，在build目录下执行ccmake .，如果没有此命令，执行apt install cmake-curses-gui安装Linux平台的cmake gui工具。
执行ccmake .后会打开一个页面 
  
 
和Windows一样，BUILD_SHARED_LIBS 代表是否生成动态库。点击上下按钮可以移动光标，点击回车可以修改值。CMAKE_INSTALL_PREFIX表示安装目录，光标选到这一项后，先点击回车，输入目录地址，再点击回车。全部修改完成后，点击c进行保存，点击q退出。 
  
 
然后执行make进行编译，如果出现以下报错，可能是系统缺少libpng库 
  
 
libpng库 在这里选择一个编译安装。
编译完成后，再执行make install进行安装。同样在build目录下会生成include和lib目录，里面是对应的头文件和库文件。
 
4 qrencode使用 
4.1 API介绍 
qrencode核心API就一个 
     /*
  * 函数功能: 用于将给定的字符串编码为二维码
  * 参数string: 要编码成二维码的数据字符串。
  * 参数version: 二维码的版本，范围从1到40。
  *                              1是最小的版本，可以容纳26个字节的数据
  *                              40是最大的版本，可以容纳最多2953个字节的数据
  *                              如果设为0，则自动选择合适的版本。
  * 参数level: 错误修正级别。有以下四个取值，即二维码可以接收的数据损坏程度。
  *                             QR_ECLEVEL_L = 0,  -  7%
  *								QR_ECLEVEL_M,      -  15%
  *								QR_ECLEVEL_Q,      -  25%
  *								QR_ECLEVEL_H       -  30%
  * 参数hint: 数据编码模式
  * 参数casesensitive: 如果为非零值，则在编码时区分大小写，否则不区分大小写。
  * 返回值：指向 QRcode 结构体指针的指针。
  *               成功编码后，这个指针会被设置为指向新创建的 QRcode 结构体，该结构体包含了生成的 QR 码信息。
  */
  QRcode *QRcode_encodeString(const char *string, int version, QRecLevel level, 
  							QRencodeMode hint, int casesensitive);
 
 
 
4.2 在QT中使用 
接下来就演示下如何在Qt中使用qrencode。
首先创建一个QT工程，然后将qrencode的头文件和库文件拷贝到QT工程目录下，这里是Windows平台动态库为例。
打开pro文件，右击选择添加库，选择外部库。 
  
 
只勾选Windows，选择动态库，选择对应的库文件。然后下一步点击完成即可。 
  
 
在QT窗口中需要添加一个QLabel控件，用于显示二维码信息。
代码如下 
     #include "widget.h"
  #include "ui_widget.h"
  #include "qrencode.h"
  #include <QPainter>
  
  Widget::Widget(QWidget *parent) :
      QWidget(parent),
      ui(new Ui::Widget)
  {
      ui->setupUi(this);
  
      createQR("Hello qrencode");
  }
  
  Widget::~Widget()
  {
      delete ui;
  }
  
  void Widget::createQR(char *data)
  {
      // 生成二维码
      QRcode *qrcode = QRcode_encodeString(data, 0, QR_ECLEVEL_L, QR_MODE_8, 0);
      if(qrcode == NULL){
          return;
      }
  
      QImage image(qrcode->width, qrcode->width, QImage::Format_ARGB32);
      QPainter painter(&image);
      painter.setBrush(Qt::white);
      painter.setPen(Qt::NoPen);
      painter.setRenderHint(QPainter::Antialiasing, false);
      painter.drawRect(0, 0, qrcode->width, qrcode->width);
      painter.setBrush(Qt::black);
  
      // 绘制二维码
      for(qint32 y = 0; y < qrcode->width; y++){
          for(qint32 x = 0; x < qrcode->width; x++){
              unsigned char b = qrcode->data[y * qrcode->width + x];
              if(b & 0x01){
                  QRectF r(x, y, 1, 1);
                  painter.drawRect(r);
              }
          }
      }
  
      QRcode_free(qrcode);
  
      // 图片显示到控件
      ui->label->setPixmap(QPixmap::fromImage(image));
      ui->label->setScaledContents(true);
  }
 
 
效果演示。编译运行后就会生成一个二维码。 
  
 

                