本文作者：HelloGitHub-LITTLECHIEH
這是 HelloGitHub 推出的《講解開源項目》[1]系列，今天給大家推薦一個 Python 開源生成二維碼的項目——qrcode
一、介紹
1.1 二維碼
二維碼又稱二維條碼，常見的二維碼為 QR Code，QR 全稱 Quick Response。是一個近幾年來移動設備上超流行的一種編碼方式，在現在的生活中二維碼隨處可見。我們可以用它支付、瀏覽網站等，為什么他會這么流行？下面說幾個特點：
- 可存儲的信息量大：可容納多達 1850 個大寫字母或 2710 個數字或 1108 個字節或 500 多個漢字。
- 容錯能力強：具有糾錯功能，這使得二維條碼因穿孔、污損等引起局部損壞時，照樣可以正確得到識讀，損毀面積達 30% 仍可恢復信息。
- 譯碼可靠性高：它比普通條碼譯碼錯誤率百萬分之二要低得多，誤碼率不超過千萬分之一。
- 激光可識別。
比如我們現在常見的公眾號二維碼，他就利用了二維碼容錯能力強的特點，在二維碼中間加入了公眾號的圖標。雖然中間的圖片遮蓋了一部分二維碼的真實數據，但因為其強大的容錯能力，所以并沒有影響二維碼要傳遞的數據。
1.2 二維碼的組成
一圖勝千言，好了這里二維碼的基本知識就介紹完成了。
1.3 生成二維碼庫
二維碼是一個很方便的傳遞信息的載體，但是像上面黑白的二維碼感覺非常缺少‘靈魂’。下面就介紹今天的主角：qrcode
這是一個由 Python 編寫的二維碼生成器，支持生成 GIF 動態、圖片二維碼，讓你的二維碼變得有趣起來。
項目地址：https://github.com/sylnsfar/qrcode
二、qrcode 庫的優點
為什么需要使用到這個二維碼生成器來生成二維碼呢？
- 使用簡單：快速上手，僅需 2 行代碼，即可開始使用！
- 在二維碼中增加圖片：可以讓用戶通過二維碼中的圖片，初步了解該二維碼是和什么東西有關。（該二維碼加入了 HG 的 logo）
3. 在二維碼中增加動圖：通過動圖，讓二維碼活過來。
4. 使用方式多樣：有以下的 3 種使用方式
- 命令行方式
- 導入文件方式（import）
- 可執行文件[2]
5. 用就對了：我不要你覺得，我要我覺得 滑稽
三、快速上手
演示環境
操作系統：windows | Python 版本：3.5
3.1 安裝
我們通過 Python 的 pip 包管理工具進行安裝：
pip install myqr
注：此處可能需要升級 pip，升級命令 pip install --upgrade pip
安裝完成之后，就可以直接在命令行中使用了！下面逐一講解各種二維碼的生成方法
3.2 普通二維碼
首先生成一個普通二維碼
- 打開 cmd
- 輸入命令
myqr https://github.com -n helloword.png
- 參數 -n：生成二維碼的文件名
這樣就會得到一個二維碼圖片，生成的圖片保存在了當前目錄，后面可以通過傳入參數修改默認目錄。
3.3 彩色二維碼
- 先準備一張圖片放在目錄下（方形的圖片效果最好）
2. 將圖片名稱修改為 github.jpg（后綴根據自己的照片格式而定）
3. 在命令行中輸入：
myqr https://github.com -n mypicture.png -p github.jpg -c
參數：
- -n：生成二維碼的名稱
- -p：二維碼加入的圖片，支持 jpg、gif、png 格式
- -c：選擇是否生成彩色二維碼，如果不設置默認為黑白
- 更多參數請看下面附錄部分
3.4 動態二維碼
步驟和彩色二維碼的方法一致，但是需要注意：
- 增加圖片為 gif
- 修改生成二維碼的后綴為 gif
四、附錄
4.1 MyQR 參數
從官方文檔整理的常用參數如下：
- -n：生成二維碼的名稱
- -p：二維碼加入的圖片，支持.jpg、.gif、.png、.bmp 格式
- -c：選擇是否生成彩色二維碼，如果不設置默認為黑白
- -v：控制邊長，范圍是 1 至 40，數字越大邊長越大
- -l：控制糾錯水平，范圍是 L、M、Q、H 從左到右依次升高
- -d：控制輸出二維碼的存儲位置
- -con：用以調節圖片的對比度，1.0 表示原始圖片，更小的值表示更低對比度，更大反之。默認為 1.0
- -bri：用來調節圖片的亮度，其余用法和取值與 -con 相同
4.2 cmd 切換盤符
打開命令行有個小技巧，可以將 cmd 迅速切換到想要的目錄，避免了切換盤符的麻煩：
- 利用文件管理，找到目標文件夾
- 頂部地址欄輸入 cmd，然后‘回車'
3. 切換盤符的坑：直接切換盤符會失敗
4.3 二維碼分類介紹
二維碼有以下幾種分類
1.黑白和彩色碼
- 黑白碼
- 彩色碼
2. 融合和視覺碼
- 融合碼：就是將內容與二維碼融合使它們成為一個整體，圖片由二維碼組成，二維碼就是圖片的一部分。這種比較適合使用構造簡單的圖片或者文字做美化主體內容
- 視覺碼：以圖片為背景，再在圖片上構建很多特殊的點，這些點不會影響背景的視覺效果
3. 藝術碼
- 藝術二維碼，就是將二維碼進行的各個“碼眼”按照設計師的構思進行分析、拆解、合并，再在那些“碼眼”區域填充上一些小素材元素，最后形成一個別具特色二維碼。
五、最后
以上就是本篇文章的全部內容了，相信你對二維碼更加了解了。并且對 qrcode 庫的常用參數有了一定了解，那就快去生成一個有趣、有‘靈魂’的二維碼吧！
有好玩的庫，但不會用，看著干著急？歡迎告訴我們，同時也歡迎加入我們。我們的愿景：“讓對開源感興趣的人不再畏懼，開源項目的發起者不再孤單。”
六、參考資料
- 小技巧｜還在用黑白二維碼？弱爆了！教你點新的技能！[3]
- PDF 淺談 QR Code[4]
- QRcode[5]
References
[1]《講解開源項目》: https://github.com/HelloGitHub-Team/Article
[2]可執行文件: https://github.com/sylnsfar/qrcode_win
[3]小技巧｜還在用黑白二維碼？弱爆了！教你點新的技能！: https://www.jianshu.com/p/5f8df373be7a
[4]PDF 淺談 QR Code: https://www.csie.ntu.edu.tw/~kmchao/bcc15spr/20150325_QR_Code.pdf
[5]QRcode: https://github.com/sylnsfar/qrcode/blob/master/README-cn.md
