Jim发布TrueType QR码字体

背景

将 QR Code 编码直接嵌入字体是一种非常规但有趣的技术思路。传统上，QR Code 由专门的库或工具动态生成图像，而字体则是静态的字符轮廓。如果能让字体“智能”地识别出文本中的特定标记，并自动渲染为对应的 QR Code 图形，用户只需要输入带方括号的字符串即可在文档中获得标准的 QR Code 符号，这可以极大简化某些场景下的编码流程。这个项目正是基于这一概念，利用 OpenType 的字形替换（GSUB）特性，将方括号内的文本实时转化为 QR Code 符号。

核心内容

该项目发布了一个实验性 OpenType 字体，可将方括号包裹的文本转换为 QR Code 符号，同时保持周围文本正常显示。例如输入 abc[hello]ghi 会呈现为普通文本 "abc"，接着是一个 QR Code 符号（编码 "hello"），然后是普通文本 "ghi"。

在线演示与下载

• 演示地址：https://qr.jim.sh/
• 提供三种版本字体：
  • qrfont-1L.ttf（21×21 模块，最多 17 个字符）
  • qrfont-2L.ttf（25×25 模块，最多 32 个字符）
  • qrfont-3L.ttf（29×29 模块，最多 53 个字符）

技术细节

• 所有字体均采用：Byte 模式、可打印 ASCII 输入、固定掩码模式 0，以及 [ 和 ] 作为定界符。
• 字体并非手工绘制，而是通过构建脚本生成。脚本输出字形轮廓和 GSUB 特征逻辑，然后编译为 dist/qrfont-*.ttf 文件。
• 默认构建路径包括：定界符解析器、字节扩展、Reed-Solomon 奇偶校验电路、QR 模块放置和固定掩码渲染。
• 可打印 ASCII 字形复制自 Liberation Sans Regular，缩放至 QR Font 的 em 方格，因此括号外部的文本以相同字体正常显示。由于源字体许可证中保留 Liberation 为保留字体名称，生成的字体族命名为 QR Font 1-L、QR Font 2-L 和 QR Font 3-L。

构建与使用

• 项目使用 uv 管理 Python 依赖。可直接运行 uv run tools/build_font.py 生成字体。
• 默认从 /usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf 读取 Liberation Sans Regular，也可通过 --base-font 参数指定其他兼容的 TrueType 源字体。
• 提供两种构建模式：
  • make full-parity（默认路径）生成完整的 Reed-Solomon 电路，会输出数千个上下文查找规则，编译时间较长。
  • make fast-placeholder（快速版）使用占位零奇偶校验，仅创建布局规则。
• 可用 uv run tools/shape_debug.py '[a]' '[b]' 检查字形流。

输出产物

• dist/qrfont-*.ttf（三个字体文件）
• dist/index.html（交互式网页演示）
• build/qrfont-*.fea（生成的 OpenType 特征文件）

使用方式
在浏览器中打开 dist/index.html，输入如 [hello] 的带方括号文本。混合文本如 abc[def]ghi 应正常显示为：普通文本 "abc" → QR Code（编码 "def"）→ 普通文本 "ghi"。

许可与限制

• 该字体是 Liberation Sans Regular 的修改版本，基于 SIL Open Font License 1.1 发布。详见 LICENSE-OFL.txt 和 NOTICE.md。
• 这是一个概念验证字体，依赖 OpenType shaping 生效，因此需要支持 GSUB 特征的环境。QR 块内的输入限制为可打印 ASCII，字符数上限分别为 17、32、53（取决于字体版本）。

关键要点

• 项目将 QR Code 编码功能嵌入到 TrueType/OpenType 字体中，通过方括号界定 QR 内容，无需外部图形库。
• 字体基于 Liberation Sans Regular 修改，输出三种规格（1-L、2-L、3-L），分别支持最多 17、32、53 个字符。
• 技术核心是构建脚本自动生成字形轮廓和 GSUB 上下文替换逻辑，包括完整的 Reed-Solomon 奇偶校验电路。
• 支持两种构建模式：完整版（full-parity）和快速占位版（fast-placeholder），前者生成完整纠错码。
• 字体本身依赖 OpenType shaping 引擎，因此需在支持 GSUB 的应用程序/浏览器中使用。
• 输入仅限可打印 ASCII 字符，使用 Byte 模式和固定掩码模式 0。
• 项目是概念验证，目前不提供更高版本（更大容量）或多掩码选择。
• 开源许可为 SIL Open Font License 1.1，保留 Liberation 字体名称。

意义与影响

这个项目展示了 OpenType 字体的潜力远不止于静态字形。通过将复杂的算法（如 Reed-Solomon 编码与模块排列）编译为 GSUB 上下文替换规则，字体可以“执行”动态生成任务，而无需依赖外部脚本。这种方法在文档排版、票据生成、标签打印等场景中具有实用价值——用户只需输入文本，字体自动生成对应 QR Code，无需切换工具或处理图片。

然而，其局限性也很明显：受限于字体引擎的上下文处理能力，输入长度有限（最大 53 字符）；固定使用 Byte 模式与掩码，缺乏灵活性；且需要渲染环境正确支持 OpenType shaping。尽管如此，它为“字体即应用程序”提供了有趣的实验范式，可能启发其他领域的类似尝试，比如将条形码、校验码甚至小型数据结构嵌入字体。同时，该项目也提醒我们，开源字体的修改与分发需要遵循原始许可证（如保留字体名称）。整体而言，这是一次富有创意的技术探索，虽然实际应用范围有限，但思想价值不容忽视。