一个开源的条码二维码生成库和生成工具

Posted 嵌入式大杂烩

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了一个开源的条码二维码生成库和生成工具相关的知识,希望对你有一定的参考价值。

一、zint

1. 介绍

Zint是一个软件,允许在任何广泛的公共领域条形码标准中轻松编码数据,并允许将这种功能集成到您自己的程序中。

Zint项目的目标是提供一个完全跨平台的开源条形码生成解决方案,目前包含了:

  • 一个基于Qt的基础GUI

  • 一个命令行工具

  • 一个允许用户调用API使用Zint的库

2. 下载

zint在github的仓库地址为:https://github.com/zint/zint,使用过程中发现github上的版本才到2.4.2,太老了。

zint主要维护的是sourceforge仓库,地址为:https://sourceforge.net/projects/zint/,可以下载到最新的「2.10.0」版本,也可以使用git拉取:

git clone git://git.code.sf.net/p/zint/code zint-code

3. 文档

文档地址为:http://www.zint.org.uk。

二、安装

1. macOS

brew install zint

2. linux(从源码安装)

下载源码:

git clone git://git.code.sf.net/p/zint/code zint-code

提前安装好cmake:

sudo apt-get install cmake

新建编译文件夹:

cd zint
mkdir build

安装:

cd build
cmake ..
make
sudo make install

3. libzint库安装检查

linux默认安装位置:

/usr/local/libzint.so

mac默认安装位置:

/usr/local/lib/libzint.dylib

4. zint工具安装检查

zint -h

三、zint命令行工具的使用

1.输入数据

使用-d参数输入数据:

zint -d "helloworld"

执行之后在当前目录生成图片out.png:也可以直接从文件中读取数据:

zint -i ./hello.txt

2. 输出数据

使用-o参数指定输出文件名:

zint -o hello.png -d "hello world"

3. 选择条形码类型

使用-b参数指定条形码类型,支持的类型列表可以使用如下列表查看:

zint -t

生成二维码(QRCODE):

zint -b 58 -o hello.png -d "hello world"

生成的二维码图片为42x42:

4. 调整图片大小

图片自身大小

条形码通过--height=<>参数来调整高度。

二维码通过--vers=<>参数指定版本来调整大小,版本与大小的对应如下表:

生成版本为4的二维码:

zint -b 58 --vers=4 -d "hello world"

生成的二维码图片为66x66(「默认已经放大1倍了」):

放大

使用-scale=参数和默认x维的倍数来改变图片大小,默认是1,这里修改为2:

zint -b 58 --vers=4 --scale=2 -d "hello world"

生成的二维码大小为132x132:

四、libzint库

1. 使用方法

使用时需要包含头文件:

#include <zint.h>

编译时需要带上参数-lzint和动态库路径:

gcc main.c -lzint -Wl,-rpath="/usr/local/lib"

2. 符号类型

symbol结构体中的  symbology 成员表示符号类型。

一维码(BARCODE_CODE128)

单个尺寸的符号通常指条形码,由若干条和若干不同宽度的空白组成。

常用类型是 「Standard Code 128 (ISO 15417)」。这种码支持ASCII全字符,并使用三模系统将数据压缩成较小的符号,是Zint默认使用的符号类型。

二维码(BARCODE_QRCODE)

QRCode全称Quick Reponse COde,由Denso开发。

根据下表设置--secure=<option>参数或者设置option_1可以获得四种级别的错误纠正:符号的大小可以使用--vers=<>参数或者通过option_2参数设置需要的二维码版本(1-40),生成的二维码大小如之前的表所示。

3. API

查询当前libzint库版本

函数原型:

int ZBarcode_Version();

使用示例:

printf("libzint version:%d\\n", ZBarcode_Version());

符号结构体创建/删除

(1) 创建并初始化一个符号结构体

/* Create and initialize a symbol structure */
ZINT_EXTERN struct zint_symbol *ZBarcode_Create(void);

(2) 释放并删除一个符号结构体

/* Create and initialize a symbol structure */
ZINT_EXTERN struct zint_symbol *ZBarcode_Create(void);

生成条形码(默认)

(1) 编码一个条形码:

/* Encode a barcode. If `length` is 0, `source` must be NUL-terminated. */
ZINT_EXTERN int ZBarcode_Encode(struct zint_symbol *symbol, const unsigned char *source, int length);

(2) 使用文件中传入的内容编码一个条形码:

/* Encode a barcode using input data from file `filename` */
ZINT_EXTERN int ZBarcode_Encode_File(struct zint_symbol *symbol, const char *filename);

输出条形码(输出图片)

/* Output a previously encoded symbol to file `symbol->outfile` */
ZINT_EXTERN int ZBarcode_Print(struct zint_symbol *symbol, int rotate_angle);


/* Encode and output a symbol to file `symbol->outfile` */
ZINT_EXTERN int ZBarcode_Encode_and_Print(struct zint_symbol *symbol, const unsigned char *source, int length,
                    int rotate_angle);

/* Encode a symbol using input data from file `filename` and output to file `symbol->outfile` */
ZINT_EXTERN int ZBarcode_Encode_File_and_Print(struct zint_symbol *symbol, const char *filename,
                    int rotate_angle);

输出到缓冲区(位图bitmap)

/* Output a previously encoded symbol to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN int ZBarcode_Buffer(struct zint_symbol *symbol, int rotate_angle);

/* Encode and output a symbol to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN int ZBarcode_Encode_and_Buffer(struct zint_symbol *symbol, const unsigned char *source, int length,
                    int rotate_angle);

/* Encode a symbol using input data from file `filename` and output to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN int ZBarcode_Encode_File_and_Buffer(struct zint_symbol *symbol, const char *filename,
                    int rotate_angle);

错误码

/* Warning and error conditions (API return values) */
#define ZINT_WARN_INVALID_OPTION        2   /* Invalid option given but overridden by Zint */
#define ZINT_WARN_USES_ECI              3   /* Automatic ECI inserted by Zint */
#define ZINT_WARN_NONCOMPLIANT          4   /* Symbol created not compliant with standards */
#define ZINT_ERROR                      5   /* Warn/error marker, not returned */
#define ZINT_ERROR_TOO_LONG             5   /* Input data wrong length */
#define ZINT_ERROR_INVALID_DATA         6   /* Input data incorrect */
#define ZINT_ERROR_INVALID_CHECK        7   /* Input check digit incorrect */
#define ZINT_ERROR_INVALID_OPTION       8   /* Incorrect option given */
#define ZINT_ERROR_ENCODING_PROBLEM     9   /* Internal error (should not happen) */
#define ZINT_ERROR_FILE_ACCESS          10  /* Error opening output file */
#define ZINT_ERROR_MEMORY               11  /* Memory allocation (malloc) failure */
#define ZINT_ERROR_FILE_WRITE           12  /* Error writing to output file */
#define ZINT_ERROR_USES_ECI             13  /* Error counterpart of warning if WARN_FAIL_ALL set (see below) */
#define ZINT_ERROR_NONCOMPLIANT         14  /* Error counterpart of warning if WARN_FAIL_ALL set */

3. demo

生成条形码

#include <zint.h>
#include <stdio.h>

int main(int argc, char *argv[])
{
    int ret;
    struct zint_symbol *symbol;

    printf("libzint version:%d\\n", ZBarcode_Version());

    symbol = ZBarcode_Create();
    if (!symbol) {
        printf("symbol create fail!(%s)\\r\\n", symbol->errtxt);
        return -1;
    }

    ret = ZBarcode_Encode(symbol, argv[1], 0);
    if (ret != 0) {
        printf("ZBarcode encode fail, ret is %d(%s)\\r\\n", ret, symbol->errtxt);
        ZBarcode_Delete(symbol);
        return -1;
    }

    ret = ZBarcode_Print(symbol, 0);
    if (ret != 0) {
        printf("ZBarcode print fail, ret is %d(%s)\\r\\n", ret, symbol->errtxt);
        ZBarcode_Delete(symbol);
        return -1;
    }

    ZBarcode_Delete(symbol);

    printf("ZBarcode delete.\\r\\n");

    return 0;
}

编译:

gcc main.c -lzint -Wl,-rpath="/usr/local/lib"

运行:

./a.out helloworld

生成的条形码如图:

生成二维码

添加如下设置类型的代码:

symbol->symbology = BARCODE_QRCODE;

或者

symbol->symbology = 58;

默认生成的二维码图片大小是42x42:

生成指定尺寸的二维码

zint命令行工具使用--vers=<>参数设置需要的「二维码版本」(1-40),调用 libzint 库时「设置 option_2 参数」即可:

symbol->option_2  = 4;

再次编译运行,生成的二维码大小为66x66(「默认已经放大1倍了」):同时,可以设置放大倍数来进一步调整二维码大小,比如这里设置放大倍数为4:

symbol->scale = 4;

重新编译运行,生成的二维码大小为 264x264:

往期推荐:

国产芯片替代STM32的一些经验分享

深入理解嵌入式中重要的编程模型

在公众号聊天界面回复1024,可获取嵌入式资源;回复 m ,可查看文章汇总。

点击阅读原文,查看更多分享

以上是关于一个开源的条码二维码生成库和生成工具的主要内容,如果未能解决你的问题,请参考以下文章

如何生成既带有图片又带有文字的二维码?

讲解开源项目:用 Python 生成有“灵魂”的二维码

java二维码生成与解析代码实现

Java生成条码二维码

高分求助生成二维码的vb代码

java识别条形码api都有哪些