V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
推荐学习书目
Learn Python the Hard Way
Python Sites
PyPI - Python Package Index
http://diveintopython.org/toc/index.html
Pocoo
值得关注的项目
PyPy
Celery
Jinja2
Read the Docs
gevent
pyenv
virtualenv
Stackless Python
Beautiful Soup
结巴中文分词
Green Unicorn
Sentry
Shovel
Pyflakes
pytest
Python 编程
pep8 Checker
Styles
PEP 8
Google Python Style Guide
Code Style from The Hitchhiker's Guide
Cheez
V2EX  ›  Python

茄子详解 Python qrcode 二维码模块

  •  
  •   Cheez · 2018-07-16 17:54:30 +08:00 · 2427 次点击
    这是一个创建于 2327 天前的主题,其中的信息可能已经有所发展或是发生改变。

    安利一波我开的专栏: https://segmentfault.com/blog/cheez_pythonhttps://zhuanlan.zhihu.com/cheezpython

    https://github.com/lincolnloop/python-qrcode

    声明

    import qrcode
    

    使用

    QRCode 方法

    qrcode.QRCode(
        version=1,
        error_correction=qrcode.ERROR_CORRECT_L,
        box_size=10,
        border=4,
        image_factory=None,
        mask_pattern=None
    )
    
    参数解释:
    1. version:控制二维码的大小,取值范围从 1 到 40。取最小值 1 时,二维码大小为 21*21。取值为 None (默认)或者使用fit=true参数(默认)时,二维码会自动调整大小。
    2. error_correction:控制二维码纠错级别。
      1. ERROR_CORRECT_L:大约 7%或者更少的错误会被更正。
      2. ERROR_CORRECT_M:默认值,大约 15%或者更少的错误会被更正。
      3. ERROR_CORRECT_Q:大约 25%或者更少的错误会被更正。
      4. ERROR_CORRECT_H:大约 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参数时,将会调用best_fit方法来找到适合数据的最小尺寸。如果没有设置mask_pattern,将会调用best_mask_pattern方法来找到找到最有效的掩模图案。最后将这些数据传递给makeImpl方法来生成二维码。qrcode本体的make方法不一样的是,这个方法没有任何返回值。
    3. make_image(fill_color=None, back_color=None,image_factory=None):创建二维码的图像并返回,默认为 PIL 图像。** 如果要让二维码有颜色,可以在这里设置。**
    4. clear:清空数据
    5. get_matrix:返回二维码数组。
    6. print_ascii(out=None, tty=False, invert=False):这个方法就比较有趣了,可以用字符画的形式来输出二维码,但是扫的时候一般都扫不出来。image其中的invert参数是决定是否反转颜色的参数,默认为假,如果为真的话会这样:image

    其他方法:

    1. best_fit(start=self.version):找到适合数据所需的最小尺寸。
    2. best_mask_pattern():找到最有效的掩模图案。
    3. makeImpl(test, mask_pattern):生成二维码的直接函数
    4. map_data:(内部函数,无需了解)
    5. print_tty(out=None):用 TTY 颜色输出二维码,如果没有给出out参数,会使用sys.stdout
    6. setup_position_adjust_pattern:(内部函数,无需了解)
    7. setup_position_probe_pattern:(内部函数,无需了解)
    8. setup_timing_pattern:(内部函数,无需了解)
    9. setup_type_info:(内部函数,无需了解)
    10. setup_type_number:(内部函数,无需了解)

    属性(这些大家基本都不用管):

    1. border:
    2. box_size:
    3. data_cache:
    4. data_list:
    5. error_correction:
    6. image_factory:
    7. mask_pattern:
    8. modules:
    9. modules_count:
    10. version:

    生成 SVG 图像

    qrcode可以生成三种不同的 svg 图像,一种是用路径表示的 svg,一种是用矩形集合表示的完整 svg 文件,还有一种是用矩形集合表示的 svg 片段。第一种用路径表示的 svg 其实就是矢量图,可以在图像放大的时候可以保持图片质量,而另外两种可能会在格子之间出现空隙。

    这三种分别对应了 svg.py 中的 SvgPathImage、SvgImage 和 SvgFragmentImage 类。在调用qrcode.make函数或者实例化QRCode时当作image_factory参数的值传入就可以了。

    import qrcode.image.svg
    
    if method == 'basic':
        # Simple factory, just a set of rects.
        factory = qrcode.image.svg.SvgImage
    elif method == 'fragment':
        # Fragment factory (also just a set of rects)
        factory = qrcode.image.svg.SvgFragmentImage
    else:
        # Combined path factory, fixes white space that may occur when zooming
        factory = qrcode.image.svg.SvgPathImage
    
    img = qrcode.make('Some data here', image_factory=factory)
    

    生成 PNG 图像

    执行命令安装pymaging相关模块:

    pip install git+git://github.com/ojii/pymaging.git#egg=pymaging
    
    pip install git+git://github.com/ojii/pymaging-png.git#egg=pymaging-png
    

    然后给image_factor参数传入qrcode.image.pure.PymagingImage就可以生成 PNG 图片了。

    import qrcode
    from qrcode.image.pure import PymagingImage
    img = qrcode.make('Some data here', image_factory=PymagingImage)
    

    这是作者推荐的方式,但是我个人认为,完全没有必要这么麻烦,直接用默认的 PIL 就可以获取 PNG 图片了,例子看下文。

    make 方法

    make方法实际上就是在内部调用了QRCode(要转换的文本).make_image(),最后(默认)返回了一个 PIL 图像对象。

    # 显示图片
    qrcode.make("hello world!").show()
    # 保存 PNG 图片
    qrcode.make("hello world!").save('hello.png')
    

    run_example 方法

    生成一个作者项目网站地址的二维码并显示出来。

    翻译自作者的Github 地址中的 README 和具体代码注释。

    7 条回复    2018-07-17 01:34:11 +08:00
    Cheez
        1
    Cheez  
    OP
       2018-07-16 18:50:02 +08:00 via Android
    挽尊
    GTim
        2
    GTim  
       2018-07-16 19:10:18 +08:00
    声明,兄弟啊...
    Cheez
        3
    Cheez  
    OP
       2018-07-16 19:31:55 +08:00 via Android
    @GTim 怎么了
    Cheez
        4
    Cheez  
    OP
       2018-07-16 21:53:19 +08:00 via Android
    挽尊
    omph
        5
    omph  
       2018-07-16 22:50:23 +08:00
    怎么生成一个好看的 QR 码?
    Cheez
        6
    Cheez  
    OP
       2018-07-16 23:11:16 +08:00 via Android
    @omph 这个我一般都是用微信小程序之类的,自己生成的最多就是彩色,然后再加个 logo😂
    Cheez
        7
    Cheez  
    OP
       2018-07-17 01:34:11 +08:00 via Android
    挽尊
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5555 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 43ms · UTC 08:37 · PVG 16:37 · LAX 00:37 · JFK 03:37
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.