Python轮子：amzqr

原文链接：http://www.juzicode.com/python-module-amzqr

AMZQR（原MyQR）是Python的创意二维码生成库，支持普通文本、网址、文件等内容转换，提供颜色定制、图片融合、动态效果等功能，适用于营销推广、艺术设计等场景。

应用场景

• 企业宣传海报二维码设计
• 社交媒体动态二维码生成
• 产品包装创意二维码制作
• 活动邀请函美化二维码
• WiFi信息可视化分享
• 支付链接艺术化呈现

安装与导入

# juzicode.com/VX公众号:juzicode
pip install amzqr
from amzqr import amzqr

使用方法

直接调用run方法即可生成二维码图片，run()方法的入参比较多，含义如下：

• words：要生成二维码的文字信息，可以是网址等信息；
• version：边长，范围是1至40，数字越大边长越大；
• level：纠错等级，范围是L、M、Q、H，H的纠错能力最强；
• picture：背景图片的路径+文件名称；
• colorized：是否彩色，在选择背景图片时生效；
• contrast：对比度，1.0 表示原始图片，更小的值表示更低对比度，更大反之，默认为1.0；
• brightness：亮度，用法和取值与contrast相同；
• save_name：生成二维码的文件名称，格式可以是 .jpg， .png ，.bmp ，.gif，默认输出文件名是“qrcode.png”；
• save_dir：生成二维码图片的保存路径，默认为当前工作目录。

1）生成基础二维码

将文本内容转换为标准二维码， words传入编码内容，save_name传入文件名称。

# juzicode.com/VX公众号:juzicode
from amzqr import amzqr
version, level, qr_name = amzqr.run(
    words='http://www.juzicode.com',
    save_name='basic.png'
)
print(f"生成结果: {qr_name}")

运行结果：

2）融合图片生成灰度二维码

将Logo图片嵌入二维码中心，colorized设置为False可以生成灰度背景图片。

# juzicode.com/VX公众号:juzicode
from amzqr import amzqr
amzqr.run(
    words='http://weixin.qq.com/r/Ejr54d-EkYLurZuC928A',
    version=10,
    level='H',
    picture='logo.png',
    colorized=False,
    contrast=1.0,
    brightness=1.0,
    save_name='with_logo_gray.png',
)

运行结果：

3）融合图片生成彩色二维码

将Logo图片嵌入二维码中心，colorized设置为True可以生成彩色背景图片。

# juzicode.com/VX公众号:juzicode
from amzqr import amzqr
 
amzqr.run(
    words='http://weixin.qq.com/r/Ejr54d-EkYLurZuC928A',
    version=10,
    level='H',
    picture='logo.png',
    colorized=True,
    contrast=3.0,
    brightness=1.0,
    save_name='with_logo_color.png',
)

运行结果：

4）生成动态二维码

创建GIF格式的动态效果二维码， picture传入gif文件名称。

# juzicode.com/VX公众号:juzicode
from amzqr import amzqr
amzqr.run(
    words='http://weixin.qq.com/r/Ejr54d-EkYLurZuC928A',
    version=3,
    picture='animation.gif',
    colorized=True,
    save_name='animation_qr.gif'
)

运行结果：

5）容错率控制

level入参设置不同容错等级应对复杂背景。

# juzicode.com/VX公众号:juzicode
from amzqr import amzqr
amzqr.run(
    words='http://weixin.qq.com/r/Ejr54d-EkYLurZuC928A',
    version=3,
    picture='animation.gif',
    colorized=True,
    save_name='animation_qr.gif'
)

运行结果：

总结

AMZQR的核心优势：

• 支持静态/动态二维码生成
• 提供丰富的视觉定制选项
• 兼容文本/二进制内容输入
• 平衡艺术性与可识别性

使用时需要注意：

• 图片融合需保证中心区域清晰
• 动态二维码建议控制GIF复杂度
• 颜色对比度需大于30%以保证识别率
• 长文本建议使用较高容错等级