1.1 实验内容

本课程通过调用MyQR接口来实现生成个人所需二维码，并可以设置二维码的大小、是否在现有图片的基础上生成、是否生成动态二维码。

本课程主要面向Python3初学者。

1.2 知识点

Python3基础

MyQR库

1.3 效果截图

1.3.1 普通二维码

1.3.2 带图片的艺术二维码

1.3.3 动态二维码

1.4 实验环境

python-3.5.2

MyQR-2.3.1

二、实验准备

2.1 创建环境

打开终端，进入 Code 目录，并将其作为我们的工作目录。

$cd Code

2.2 下载MyQR

$ sudo pip3 install MyQR

2.3 下载所需资源文件并解压

Code/ $ wget http://labfile.oss.aliyuncs.com/courses/1126/Sources.zip #这里提供制作二维码所需要的图片资源

Code/ $ unzip Sources.zip

2.4 FreeImage

由于虚拟环境缺少了一些FreeImage依赖。我们在这里手动添加。

在shiyanlou根目录里打开终端:

shiyanlou/ $ mkdir .imageio && cd .imageio

.imageio/ $ mkdir freeimage && cd freeimage

freeimage/ $ wget http://labfile.oss.aliyuncs.com/courses/1126/libfreeimage-3.16.0-linux64.so

三、实验步骤

接下来，我们会自己制作普通二维码、带有图片的艺术二维码和动态二维码。

3.1 普通二维码

确保当前目录为Code,在命令行中输入 python3 ，进入 python3 环境：

Code/ $ python3

在 python3 环境中输入以下代码：

>>>from MyQR import myqr

>>>myqr.run('https://www.shiyanlou.com')

大功告成，那么来看一看自己制作的第一张二维码图片吧!

先退出python3环境

>>>quit()

再使用火狐浏览器预览

Code/ $ firefox qrcode.png

效果图：

快快拿起手机扫一扫，看看是否有效，若成功，将跳转到实验楼主页。

下面我们来详细的讲解一下 myqr.run() 函数里面的参数

参数含义详细

words

二维码指向链接

str，输入链接或者句子作为参数

version

边长

int，控制边长，范围是1到40，数字越大边长越大,默认边长是取决于你输入的信息的长度和使用的纠错等级

level

纠错等级

str，控制纠错水平，范围是L、M、Q、H，从左到右依次升高，默认纠错等级为'H'

picture

结合图片

str，将QR二维码图像与一张同目录下的图片相结合，产生一张黑白图片

colorized

颜色

bool，使产生的图片由黑白变为彩色的

contrast

对比度

float，调节图片的对比度，1.0 表示原始图片，更小的值表示更低对比度，更大反之。默认为1.0

brightness

亮度

float，调节图片的亮度，其余用法和取值与 contrast 相同

save_name

输出文件名

str，默认输出文件名是"qrcode.png"

save_dir

存储位置

str，默认存储位置是当前目录

3.2 带图片的艺术二维码

光是二维码，是否太单调了呢？没关系，我们能加上我们想要的图片，使二维码更具辨识度！ 我们准备了实验楼的Logo：

实验楼Logo图片：

当然，Sources文件夹里有更多的图片，你也可以选择你个人喜爱的一张来制作艺术二维码！

让我们将这张图加入到我们的二维码中，加入过程需要在参数里指定实验楼Logo图片的地址，我们也要设置新图片的保存名，以免和上一张二维码图片冲突。

>>>myqr.run(

... words='https://www.shiyanlou.com',

... picture='Sources/shiyanlouLogo.png',

... save_name='artistic.png',

...)

再次退出python3环境

>>>quit()

使用火狐浏览器打开图片

Code/ $ firefox artistic.png

黑白实验楼Logo二维码：

黑白的，似乎不是那么好看，彩色的如何呢？ 实现彩色也非常简单，在参数里将 colorized 参数值设为 True。

>>>myqr.run(

... words='https://www.shiyanlou.com',

... picture='Sources/shiyanlouLogo.png',

... colorized=True,

... save_name='artistic_Color.png',

...)

打开图片

Code/ $ firefox artistic_Color.png

彩色实验楼Logo二维码：

好看多了，但我们的实验并没有到此为止哦！

3.3 动态二维码

其实生成动态二维码，并没有想象的那么复杂。 在这里，我们使用美丽的新垣结衣GIF！

新垣结衣GIF:

在生成动态二维码的过程中，值得注意的一点是，我们生成保存的文件也必须是.gif 格式哟。 让我们赶快开始！

>>>myqr.run(

... words='https://www.shiyanlou.com',

... picture='Sources/gakki.gif',

... colorized=True,

... save_name='Animated.gif',

...)

新鲜出炉的动图，新垣结衣动态二维码：

效果很不错呢，拿起手机试着扫扫看。

四、MyQR源码解读

MyQR源码来自于github上的sylnsfar/qrcode项目，大家可以通过克隆的方式下载源码来学习，可以使用如下命令行：

Code/ $ git clone https://github.com/sylnsfar/qrcode.git

如果下载速度较慢的话，也可以下载我们服务器上面的源码，可以通过如下命令：

Code/ $ wget http://labfile.oss.aliyuncs.com/courses/1126/qrcode-master.zip

Code/ $ unzip qrcode-master.zip

下面我们将一起来读下MyQR的源码内容，并且针对重点部分给大家详细讲解。

1.MyQR文件结构

qrcode

│ LICENSE.md

│ README.md

│ requirements.txt #环境依赖文件

|myqr.py

|

└───MyQR

│ │ __init__.py

│ │ myqr.py #调用的文件

│ │ terminal.py #设置参数

||

│ └───mylibs

│ │ __init__.pt

│ │ constan.py #数据分析

||data.py #数据编码

│ │ ECC.py #纠错编码，Error Correction Codewords

||structure.py #数据结构

||matrix.py #获得QR矩阵

||draw.py #生成二维码

||theqrmodule.py #结合函数

│

└───example

│ 0.png

│ 1.png

|2.png

|...

2.生成二维码的步骤

2.1 数据分析MyQR/mylibs/constan.py

确定编码的字符类型，按相应的字符集转换成符号字符。

2.2 数据编码MyQR/mylibs/data.py

将数据字符转换为位流，每8位一个码字，整体构成一个数据的码字序列。

2.3 纠错编码MyQR/mylibs/ECC.py

按需要将上面的码字序列分块，并根据纠错等级和分块的码字，产生纠错码字，并把纠错码字加入到数据码字序列后面，成为一个新的序列。

2.4 构造最终数据信息MyQR/mylibs/structure.py + matrix.py

在规格确定的条件下，将上面产生的序列按次序放入分块中，将数据转成能够画出二维码的矩阵。

创建二维码的矩阵

# MyQR/mylibs/matrix.py

def get_qrmatrix(ver, ecl, bits):

num = (ver - 1)* 4 + 21

qrmatrix = [[None]* num for i in range(num)]

# 添加查找器模式和添加分隔符

add_finder_and_separator(qrmatrix)

# 添加校准模式

add_alignment(ver, qrmatrix)

# 添加时间模式

add_timing(qrmatrix)

# 添加涂黑模块和保留区域

add_dark_and_reserving(ver, qrmatrix)

maskmatrix = [i[:] for i in qrmatrix]

# 放置数据位

place_bits(bits, qrmatrix)

# 蒙版操作

mask_num, qrmatrix = mask(maskmatrix, qrmatrix)

# 格式信息

add_format_and_version_string(ver, ecl, mask_num, qrmatrix)

return qrmatrix

2.5 生成二维码MyQR/mylibs/draw.py

使用 draw.py 画出二维码。

def draw_qrcode(abspath, qrmatrix):

unit_len = 3

x = y = 4*unit_len

pic = Image.new('1', [(len(qrmatrix)+8)*unit_len]*2, 'white') #新建一张白色的底图

'''

循环矩阵中的单位，在需要涂黑的单位启用dra_a_black_unit()函数涂黑。

'''

for line in qrmatrix:

for module in line:

if module:

draw_a_black_unit(pic, x, y, unit_len) #画出黑单位

x += unit_len

x, y = 4*unit_len, y+unit_len

saving = os.path.join(abspath, 'qrcode.png')

pic.save(saving) # 保存二维码图片

return saving

3.合并图片的原理

让我们来看一下 /MyQR/myqr.py 中的 combine() 方法,此方法调用了 Pillow 库

读取图片操作

qr = Image.open(qr_name) #读取二维码图片

qr = qr.convert('RGBA') if colorized else qr #判断二维码是否有色

bg0 = Image.open(bg_name).convert('RGBA') #读取要合并的图片

bg0 = ImageEnhance.Contrast(bg0).enhance(contrast) # 调节对比度

bg0 = ImageEnhance.Brightness(bg0).enhance(brightness) # 调节亮度

将新加的图片覆盖原有的二维码图片，生成新的图片并保存。

for i in range(qr.size[0]-24):

for j in range(qr.size[1]-24):

if not ((i in (18,19,20)) or (j in (18,19,20)) or (i<24 and j<24) or (i<24 and j>qr.size[1]-49) or (i>qr.size[0]-49 and j<24) or ((i,j) in aligs) or (i%3==1 and j%3==1) or (bg0.getpixel((i,j))[3]==0)):

qr.putpixel((i+12,j+12), bg.getpixel((i,j)))

源码简单的解读就是这些，如果想更深入的了解，请直接点击此处亲自阅读源码。

五、实验总结

二维码的内容，就到此结束了。二维码在日常生活中的使用场景很多，大家可以结合实际生活来使用。

本实验主要的知识点如下：

调用MyQR库

了解MyQR库的具体实现原理