amazing-qr 实现原理详解数字/字母数字/字节三种二维码编码模式与版本自动选择指南【免费下载链接】amazing-qr amazing QRCode generator (supporting animated gif) - amazing 二维码生成器支持 gif 动态图片二维码项目地址: https://gitcode.com/gh_mirrors/am/amazing-qramazing-qr是一款 Python 二维码生成器支持静态、艺术及动态 GIF 二维码。本文将深入拆解它的编码流水线如何自动判定数字、字母数字、字节三种编码模式以及二维码版本矩阵大小是如何被容量表自动选出的。流水线全景从字符串到二维码图片的 5 个阶段amazing-qr 的生成入口在 amzqr/mylibs/theqrmodule.py 的get_qrcode函数整条流水线分为五个阶段阶段模块职责1. 数据编码amzqr/mylibs/data.py选模式、选版本、把字符串变比特串、分块2. 纠错编码amzqr/mylibs/ECC.py生成 Reed-Solomon 纠错码3. 结构拼装amzqr/mylibs/structure.py交错后拼成最终比特流4. 矩阵构建amzqr/mylibs/matrix.py定位图形、数据放置、掩码5. 绘制输出amzqr/mylibs/draw.py每个模块画 3×3 像素并保存图片本文聚焦阶段 1——它是决定二维码长什么样的关键也是三种模式与版本自动选择的发生地。自动编码模式判定数字、字母数字、字节怎么选 在 amzqr/mylibs/data.py#L56-L62 的analyse函数中项目按优先级从高到低做两轮字符集检查数字模式numeric若所有字符都在0-9中num_list字母数字模式alphanumeric若所有字符都属于 45 个字符的集合alphanum_list即0-9、A-Z及空格和$%*-./:字节模式byte其余情况按 1 字节 1 字符兜底。之所以要分模式是因为三种模式的压缩率完全不同模式模式指示符字符集编码效率numeric00010-93 个数字 ≈ 10 bit约 3.3 bit/位alphanumeric001045 个字符2 个字符 11 bit5.5 bit/字byte0100单字节1 字符 8 bit模式指示符定义在 amzqr/mylibs/constant.py#L287。同样的内容用数字模式编码后比特串更短留给纠错的空间就更大——自动选择最高效模式正是生成更小巧二维码的第一步。三种模式的比特编码规则 每种模式对应一个编码函数data.py#L81-L121数字模式每 3 位数字转成一个整数再取 10 bit不足 3 位时尾组用 7 bit 或 4 bit。例如123456789分成 3 组得到 30 bitdata.numeric_encoding(123456789) # 0001111011 01110010 001100013 × 10 bit字母数字模式每 2 个字符按v1×45 v2折算成 11 bit长度为奇数时末尾单字符用 6 bit 编码。以规格书中的经典样例AC-42为例A10、C12data.alphanumeric_encoding(AC-42) # A,C 10*4512 462 00111001110 # - ,4 41*454 1849 11100111001 # 2 (落单) 000010字节模式每个字符取其 8 bit 编码iso-8859-1Ab即01000001 01100010。这些规则都有对应的回归测试守护见 tests/test_data.py其中AC-42用例被标注为 QR 规格的黄金标准样例方便读者自行验证。二维码版本自动选择容量表决定矩阵大小 选完模式后analyse接着回答多大的矩阵才装得下。核心是一张预计算的容量表 char_capchar_cap[纠错等级][版本][模式] 该版本可容纳的字符数。选取逻辑在 data.py#L64-L78从 version 1 到 40逐个版本检查容量找到第一个容量大于内容长度的版本fit_ver最终版本取max(用户指定版本, fit_ver)——版本只能升不能降用户指定的版本若更大则尊重用户若 version 40 都装不下例如 5000 个数字超出 v40-H 容量抛出ValueError。以 H 级最高纠错为例感受一下不同版本的能力版本numericalphanumericbytev117 字符10 字符7 字符v7154 字符93 字符64 字符v403057 字符1852 字符1273 字符所以一段短网址若含大写字母自动判定为字母数字模式可能 v1 就够用10 字符换成同样的纯数字串v1 就能装下 17 个——这就是模式选择直接影响版本选择的地方。数据填充与分块把比特串塞满矩阵确定版本和模式后data.py#L26-L51 的encode函数完成最后的装配拼接头部模式指示符(4 bit) 字符计数指示符(CCI) 数据编码。CCI 的位宽随版本变化如 v1–9 数字模式为 10 bit逻辑见 get_cci终止符末尾补至多 4 个0标记数据结束对齐字节补0使总长是 8 的倍数填充字节若仍短于该版本的数据区容量required_bytes 表给出的字节数交替填充111011000xEC与000100010x11分块按 grouping_list 中该版本/纠错等级的分组方案把数据码字切成若干块——后续 Reed-Solomon 纠错就是逐块计算的。从码字到矩阵编码阶段的最终产出数据编码完成后比特流被送入矩阵构建。矩阵边长由版本决定(版本 - 1) × 4 21个模块version 1 是 21×21version 40 是 177×177matrix.py#L6-L8。get_qrmatrix 依次写入三个角的定位图形、校正图形、时序图案再Z字形铺放数据比特并选出最优掩码。结构细节可参考 tests/test_matrix.py 中的不变量测试。应用示例编码成果的最终形态经过上述流水线编码效率最高的字符串往往能落在更小的版本上生成的二维码也更小更精致。而配合图片参数amazing-qr 还能把编码好的数据区与背景图合成艺术二维码下面这张来自官方示例文档的图片就是一个典型形态这类图案嵌入数据区的效果正是建立在上述精确的模式编码与容量计算之上——矩阵每一格能放多少数据早已在第一步就算清楚了。小结模式判定全数字 → numeric全属 45 字符集 → alphanumeric否则 byte永远选最省比特的模式版本选择查char_cap容量表从 v1 扫到 v40取装得下的最小版本且不小于用户指定值数据装配模式指示符 CCI 编码数据 → 终止符 → 填充字节0xEC/0x11→ 按分组表分块关键源码data.py模式与版本、constant.py容量/分组表、test_data.py规格验证用例。理解这条编码流水线后你就能预判任意字符串会被判定为哪种模式、生成几版二维码——这也是用好 amzqr 命令行-v与-l参数、生成最省空间二维码的理论基础。【免费下载链接】amazing-qr amazing QRCode generator (supporting animated gif) - amazing 二维码生成器支持 gif 动态图片二维码项目地址: https://gitcode.com/gh_mirrors/am/amazing-qr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
amazing-qr 实现原理详解数字/字母数字/字节三种二维码编码模式与版本自动选择指南【免费下载链接】amazing-qr amazing QRCode generator (supporting animated gif) - amazing 二维码生成器支持 gif 动态图片二维码项目地址: https://gitcode.com/gh_mirrors/am/amazing-qramazing-qr是一款 Python 二维码生成器支持静态、艺术及动态 GIF 二维码。本文将深入拆解它的编码流水线如何自动判定数字、字母数字、字节三种编码模式以及二维码版本矩阵大小是如何被容量表自动选出的。流水线全景从字符串到二维码图片的 5 个阶段amazing-qr 的生成入口在 amzqr/mylibs/theqrmodule.py 的get_qrcode函数整条流水线分为五个阶段阶段模块职责1. 数据编码amzqr/mylibs/data.py选模式、选版本、把字符串变比特串、分块2. 纠错编码amzqr/mylibs/ECC.py生成 Reed-Solomon 纠错码3. 结构拼装amzqr/mylibs/structure.py交错后拼成最终比特流4. 矩阵构建amzqr/mylibs/matrix.py定位图形、数据放置、掩码5. 绘制输出amzqr/mylibs/draw.py每个模块画 3×3 像素并保存图片本文聚焦阶段 1——它是决定二维码长什么样的关键也是三种模式与版本自动选择的发生地。自动编码模式判定数字、字母数字、字节怎么选 在 amzqr/mylibs/data.py#L56-L62 的analyse函数中项目按优先级从高到低做两轮字符集检查数字模式numeric若所有字符都在0-9中num_list字母数字模式alphanumeric若所有字符都属于 45 个字符的集合alphanum_list即0-9、A-Z及空格和$%*-./:字节模式byte其余情况按 1 字节 1 字符兜底。之所以要分模式是因为三种模式的压缩率完全不同模式模式指示符字符集编码效率numeric00010-93 个数字 ≈ 10 bit约 3.3 bit/位alphanumeric001045 个字符2 个字符 11 bit5.5 bit/字byte0100单字节1 字符 8 bit模式指示符定义在 amzqr/mylibs/constant.py#L287。同样的内容用数字模式编码后比特串更短留给纠错的空间就更大——自动选择最高效模式正是生成更小巧二维码的第一步。三种模式的比特编码规则 每种模式对应一个编码函数data.py#L81-L121数字模式每 3 位数字转成一个整数再取 10 bit不足 3 位时尾组用 7 bit 或 4 bit。例如123456789分成 3 组得到 30 bitdata.numeric_encoding(123456789) # 0001111011 01110010 001100013 × 10 bit字母数字模式每 2 个字符按v1×45 v2折算成 11 bit长度为奇数时末尾单字符用 6 bit 编码。以规格书中的经典样例AC-42为例A10、C12data.alphanumeric_encoding(AC-42) # A,C 10*4512 462 00111001110 # - ,4 41*454 1849 11100111001 # 2 (落单) 000010字节模式每个字符取其 8 bit 编码iso-8859-1Ab即01000001 01100010。这些规则都有对应的回归测试守护见 tests/test_data.py其中AC-42用例被标注为 QR 规格的黄金标准样例方便读者自行验证。二维码版本自动选择容量表决定矩阵大小 选完模式后analyse接着回答多大的矩阵才装得下。核心是一张预计算的容量表 char_capchar_cap[纠错等级][版本][模式] 该版本可容纳的字符数。选取逻辑在 data.py#L64-L78从 version 1 到 40逐个版本检查容量找到第一个容量大于内容长度的版本fit_ver最终版本取max(用户指定版本, fit_ver)——版本只能升不能降用户指定的版本若更大则尊重用户若 version 40 都装不下例如 5000 个数字超出 v40-H 容量抛出ValueError。以 H 级最高纠错为例感受一下不同版本的能力版本numericalphanumericbytev117 字符10 字符7 字符v7154 字符93 字符64 字符v403057 字符1852 字符1273 字符所以一段短网址若含大写字母自动判定为字母数字模式可能 v1 就够用10 字符换成同样的纯数字串v1 就能装下 17 个——这就是模式选择直接影响版本选择的地方。数据填充与分块把比特串塞满矩阵确定版本和模式后data.py#L26-L51 的encode函数完成最后的装配拼接头部模式指示符(4 bit) 字符计数指示符(CCI) 数据编码。CCI 的位宽随版本变化如 v1–9 数字模式为 10 bit逻辑见 get_cci终止符末尾补至多 4 个0标记数据结束对齐字节补0使总长是 8 的倍数填充字节若仍短于该版本的数据区容量required_bytes 表给出的字节数交替填充111011000xEC与000100010x11分块按 grouping_list 中该版本/纠错等级的分组方案把数据码字切成若干块——后续 Reed-Solomon 纠错就是逐块计算的。从码字到矩阵编码阶段的最终产出数据编码完成后比特流被送入矩阵构建。矩阵边长由版本决定(版本 - 1) × 4 21个模块version 1 是 21×21version 40 是 177×177matrix.py#L6-L8。get_qrmatrix 依次写入三个角的定位图形、校正图形、时序图案再Z字形铺放数据比特并选出最优掩码。结构细节可参考 tests/test_matrix.py 中的不变量测试。应用示例编码成果的最终形态经过上述流水线编码效率最高的字符串往往能落在更小的版本上生成的二维码也更小更精致。而配合图片参数amazing-qr 还能把编码好的数据区与背景图合成艺术二维码下面这张来自官方示例文档的图片就是一个典型形态这类图案嵌入数据区的效果正是建立在上述精确的模式编码与容量计算之上——矩阵每一格能放多少数据早已在第一步就算清楚了。小结模式判定全数字 → numeric全属 45 字符集 → alphanumeric否则 byte永远选最省比特的模式版本选择查char_cap容量表从 v1 扫到 v40取装得下的最小版本且不小于用户指定值数据装配模式指示符 CCI 编码数据 → 终止符 → 填充字节0xEC/0x11→ 按分组表分块关键源码data.py模式与版本、constant.py容量/分组表、test_data.py规格验证用例。理解这条编码流水线后你就能预判任意字符串会被判定为哪种模式、生成几版二维码——这也是用好 amzqr 命令行-v与-l参数、生成最省空间二维码的理论基础。【免费下载链接】amazing-qr amazing QRCode generator (supporting animated gif) - amazing 二维码生成器支持 gif 动态图片二维码项目地址: https://gitcode.com/gh_mirrors/am/amazing-qr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
