一、Zint1. 介绍
Zint是一个软件,允许在任何广泛的公共领域条形码标准中轻松编码数据,并允许将这种功能集成到您自己的程序中。
Zint项目的目标是提供一个完全跨平台的开源条形码生成解决方案,目前包含了:
-
一个基于Qt的基础GUI
-
一个命令行工具
-
一个允许用户调用API使用Zint的库
zint在github的仓库地址为:https://github.com/zint/zint,使用过程中发现github上的版本才到2.4.2,太老了。
zint主要维护的是sourceforge仓库,地址为:https://sourceforge.net/projects/zint/,可以下载到最新的「2.10.0」版本,也可以使用git拉取:
git clonegit://git.code.sf.net/p/zint/code zint-code
3. 文档
文档地址为:http://www.zint.org.uk。
二、安装1. macOSbrew install zint
2. linux(从源码安装)
下载源码:
git clonegit://git.code.sf.net/p/zint/code zint-code
提前安装好cmake:
sudo apt-get install cmake
新建编译文件夹:
cdzint
mkdir build
安装:
cdbuild
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库版本
函数原型:
intZBarcode_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 intZBarcode_Encode(struct zint_symbol *symbol, constunsignedchar*source, intlength);
(2) 使用文件中传入的内容编码一个条形码:
/* Encode a barcode using input data from file `filename` */
ZINT_EXTERN intZBarcode_Encode_File(struct zint_symbol *symbol, constchar*filename);
输出条形码(输出图片) /* Output a previously encoded symbol to file `symbol->outfile` */
ZINT_EXTERN intZBarcode_Print(struct zint_symbol *symbol, introtate_angle);
/* Encode and output a symbol to file `symbol->outfile` */
ZINT_EXTERN intZBarcode_Encode_and_Print(struct zint_symbol *symbol, constunsignedchar*source, intlength,
introtate_angle);
/* Encode a symbol using input data from file `filename` and output to file `symbol->outfile` */
ZINT_EXTERN intZBarcode_Encode_File_and_Print(struct zint_symbol *symbol, constchar*filename,
introtate_angle);
输出到缓冲区(位图bitmap) /* Output a previously encoded symbol to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN intZBarcode_Buffer(struct zint_symbol *symbol, introtate_angle);
/* Encode and output a symbol to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN intZBarcode_Encode_and_Buffer(struct zint_symbol *symbol, constunsignedchar*source, intlength,
introtate_angle);
/* Encode a symbol using input data from file `filename` and output to memory as raster (`symbol->bitmap`) */
ZINT_EXTERN intZBarcode_Encode_File_and_Buffer(struct zint_symbol *symbol, constchar*filename,
introtate_angle);
错误码 /* Warning and error conditions (API return values) */
#defineZINT_WARN_INVALID_OPTION 2 /* Invalid option given but overridden by Zint */
#defineZINT_WARN_USES_ECI 3 /* Automatic ECI inserted by Zint */
#defineZINT_WARN_NONCOMPLIANT 4 /* Symbol created not compliant with standards */
#defineZINT_ERROR 5 /* Warn/error marker, not returned */
#defineZINT_ERROR_TOO_LONG 5 /* Input data wrong length */
#defineZINT_ERROR_INVALID_DATA 6 /* Input data incorrect */
#defineZINT_ERROR_INVALID_CHECK 7 /* Input check digit incorrect */
#defineZINT_ERROR_INVALID_OPTION 8 /* Incorrect option given */
#defineZINT_ERROR_ENCODING_PROBLEM 9 /* Internal error (should not happen) */
#defineZINT_ERROR_FILE_ACCESS 10 /* Error opening output file */
#defineZINT_ERROR_MEMORY 11 /* Memory allocation (malloc) failure */
#defineZINT_ERROR_FILE_WRITE 12 /* Error writing to output file */
#defineZINT_ERROR_USES_ECI 13 /* Error counterpart of warning if WARN_FAIL_ALL set (see below) */
#defineZINT_ERROR_NONCOMPLIANT 14 /* Error counterpart of warning if WARN_FAIL_ALL set */
3. demo生成条形码 #include<zint.h>
#include<stdio.h>
intmain(intargc, char*argv[])
{
intret;
structzint_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");
return0;
}
编译:
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:
1.芯片都去哪了?美国SIA年度报告揭秘~
2.树莓派偷偷换上新SoC!
3.MCU从入门到躺平
4.车规级MCU国产替代下的选择题:车厂策略激进,直供能成为未来主流?
5.编程语言成功的几大要素
6.碳中和,不确定世界里的确定性
标签:zint,symbol,二维码,Encode,ZBarcode,defineZINT From: https://www.cnblogs.com/leochan007/p/16859641.html