摘要: 详解 Python qrcode 二维码模块。
项目地址
https://github.com/lincolnloop/python-qrcode
声明
import
qrcode
使用
QRCode 方法
参数解释
1、version:控制二维码的大小,取值范围从1到40。取最小值1时,二维码大小为21*21。取值为 None (默认)或者使用fit=true参数(默认)时,二维码会自动调整大小。
2、error_correction:控制二维码纠错级别。
ERRORCORRECTL:大约7%或者更少的错误会被更正。
ERRORCORRECTM:默认值,大约15%或者更少的错误会被更正。
ERRORCORRECTQ:大约25%或者更少的错误会被更正。
ERRORCORRECTH:大约30%或者更少的错误会被更正。
3、box_size:控制二维码中每个格子的像素数,默认为 10。
4、border:控制二维码四周留白包含的格子数,默认为4。
5、image_factory:选择生成图片的形式,默认为 PIL 图像。
6、mask_pattern:选择生成图片的的掩模。
方法属性解释
常用方法:
1、add_data(str,optimize=20):添加要转换的文字到data参数;如果使用了optimize优化参数,数据将被拆分为多个块来进行优化,以找到一个长度至少为这个值的足够简洁的方式来生成二维码。设置为“0”以避免优化。
2、make(fit=True):当fit参数为真或者没有给出version参数时,将会调用bestfit方法来找到适合数据的最小尺寸。如果没有设置maskpattern,将会调用bestmaskpattern方法来找到找到最有效的掩模图案。最后将这些数据传递给makeImpl方法来生成二维码。与qrcode本体的make方法不一样的是,这个方法没有任何返回值。
3、makeimage(fillcolor=None, backcolor=None,imagefactory=None):创建二维码的图像并返回,默认为 PIL 图像。如果要让二维码有颜色,可以在这里设置。
4、clear:清空数据
5、get_matrix:返回二维码数组。
6、print_ascii(out=None, tty=False, invert=False):这个方法就比较有趣了,可以用字符画的形式来输出二维码,但是扫的时候一般都扫不出来。
其中的invert参数是决定是否反转颜色的参数,默认为假,如果为真的话会这样:
其他方法:
1、bestfit(start=self.version):找到适合数据所需的最小尺寸。
2、bestmaskpattern():找到最有效的掩模图案。
3、makeImpl(test, maskpattern):生成二维码的直接函数
4、mapdata:(内部函数,无需了解)
5、printtty(out=None):用TTY颜色输出二维码,如果没有给出out参数,会使用sys.stdout。
6、setuppositionadjustpattern:(内部函数)
7、setuppositionprobepattern:(内部函数)
8、setuptimingpattern:(内部函数)
9、setuptypeinfo:(内部函数)
10、setuptypenumber:(内部函数)
属性:
1、border:
2、boxsize:
3、datacache:
4、datalist:
5、errorcorrection:
6、imagefactory:
7、maskpattern:
8、modules:
9、modules_count:
10、version:
生成 SVG 图像
qrcode可以生成三种不同的svg图像,一种是用路径表示的svg,一种是用矩形集合表示的完整svg文件,还有一种是用矩形集合表示的svg片段。第一种用路径表示的svg其实就是矢量图,可以在图像放大的时候可以保持图片质量,而另外两种可能会在格子之间出现空隙。
这三种分别对应了svg.py中的SvgPathImage、SvgImage和SvgFragmentImage类。在调用qrcode.make函数或者实例化QRCode时当作image_factory参数的值传入就可以了。
生成 PNG 图像
执行命令安装pymaging相关模块:
然后给image_factor参数传入qrcode.image.pure.PymagingImage就可以生成PNG图片了。
这是作者推荐的方式,但是我个人认为,完全没有必要这么麻烦,直接用默认的 PIL 就可以获取 PNG 图片了,例子看下文。
make 方法
make方法实际上就是在内部调用了QRCode(要转换的文本).make_image(),最后(默认)返回了一个PIL图像对象。
# 显示图片qrcode.make("hello world!").show()
# 保存 PNG 图片qrcode.make("hello world!").save('hello.png')
run_example 方法
生成一个作者项目网站地址的二维码并显示出来。
原文发布时间为:2018-07-24
本文作者:以茄之名
本文来自云栖社区合作伙伴“ Python中文社区”,了解相关信息可以关注“ Python中文社区”