墨穗app.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v1.0.165 · 墨穗笔记
笔记

Notebase墨穗
静水流深,落墨成穗。

0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →

笔记

0
加载中...

工具

0

此页用于记录用户反馈问题后的每一次改进

关于

笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

不想公开、只想临时给人看:点“分享”生成一条带密码和有效期的链接,到期自动失效,你也能随时撤销。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势

// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

TrueType 字体内的 QR 码生成器:Jim 的 QR Font 深度解析

2026-07-07编程开发

一个 TrueType 字体实现 QR 码生成,将方括号内文本实时渲染为二维码,同时保留周围可读文字。

引言:字体即程序——当 OpenType 遇上二维码

在传统认知中,字体文件只是字符形状的集合。但 Jim Paris 的 QR Font 项目颠覆了这一概念:它利用 OpenType 的 GSUB(字形替换)特性,在字体内部嵌入了一个完整的 QR 码生成逻辑。这意味着,只要你的系统支持 OpenType 字形替换(几乎所有现代操作系统和浏览器都支持),你就能在任意文本输入框中输入 [hello],瞬间看到它变成一个可扫描的 QR 码,而前后的普通文字保持不变。

这不仅是技术魔术,更是对字体引擎计算能力的一次极限压榨。

核心原理:用 GSUB 查表代替运行时计算

QR 码生成通常需要编程实现:数据编码、纠错码计算、模块排列、掩码应用。但 QR Font 将这些步骤全部转化为了静态的 OpenType 上下文查找表(contextual lookup)。

1. 输入约束与版本选择

QR Font 只处理方括号 [...] 内的可打印 ASCII 字符(0x20-0x7E)。根据 QR 码版本不同,最大字符数限制为:

  • 1-L:21×21 模块,最多 17 字符
  • 2-L:25×25 模块,最多 32 字符
  • 3-L:29×29 模块,最多 53 字符

所有版本固定使用 Byte 模式(而非数字或字母数字模式)和 掩码模式 0(即 (row + column) mod 2 == 0 的 XOR 规则)。

2. 构建流程:从 Python 脚本到 OpenType 特征文件

字体并非手工绘制,而是通过 Python 脚本自动生成。核心构建工具链如下:

bash

默认完整构建(包含 Reed-Solomon 纠错电路)

make

快速布局测试(使用占位零校验,跳过纠错计算)

make fast-placeholder

使用自定义基础字体

uv run tools/build_font.py --base-font /path/to/BaseFont-Regular.ttf

构建脚本执行以下步骤:

  1. 字符映射:将可打印 ASCII 字符从 Liberation Sans Regular 中提取,缩放到字体 em 方格内。
  2. 分隔符解析:生成识别 [ 和 ] 的上下文规则。
  3. 字节扩展:将 ASCII 字符按 QR Byte 模式编码为 8 位数据块。
  4. Reed-Solomon 纠错电路:计算纠错码字,这是最复杂的部分,需要生成数千条上下文查找规则。
  5. 模块放置:按照 QR 规范将数据位和纠错位填入 21/25/29 网格。
  6. 固定掩码应用:应用掩码模式 0 并添加功能图形(定位图案、格式信息等)。

最终输出 .fea 文件(OpenType 特征描述),再由 makeotf 或类似工具编译为 .ttf。

3. Reed-Solomon 的“电路”隐喻

QR 码使用 Reed-Solomon 纠错,需要计算多项式除法。在字体引擎中,没有循环和变量,只能通过 字形替换链 模拟逻辑。

例如,一个简单的加法操作在 GSUB 中可能表现为:

  • 查找模式:如果当前字形是 "A" 且下一个是 "B",替换为 "C"(表示 A+B=C)。
  • 对于 RS 计算,需要数百次这样的替换才能完成一个伽罗瓦域乘法和加法。

完整的 RS 电路(make full-parity)会生成数千条这样的规则,编译时间显著增长。占位模式则直接插入零值纠错码,仅用于验证布局正确性。

4. 渲染体验:文本与 QR 码的共存

字体将方括号视为特殊标记。当文本流中出现 [hello] 时:

  • [ 触发上下文查找,开始 QR 模式。
  • 每个字符被替换为对应的 QR 模块字形(黑色或白色方块)。
  • ] 结束替换,后续字符恢复为普通 Liberation Sans 字形。

因此,abc[hello]ghi 在屏幕上显示为:普通文本 "abc" → 一个 21×21 的 QR 码 → 普通文本 "ghi"。

技术细节:字体引擎的极限

为什么选择 Liberation Sans?

Liberation Sans 是 SIL Open Font License 下的开源字体,与 Arial 度量兼容。项目将其作为基础字体,但根据许可证要求,生成的字体不能以 "Liberation" 命名,因此改名为 QR Font 1-L、QR Font 2-L、QR Font 3-L。

构建依赖

  • Python + uv 包管理器(用于依赖管理)
  • FontTools:Python 的字体操作库,用于生成 OpenType 特征
  • makeotf(来自 Adobe AFDKO):将 .fea 编译为二进制字体

已知限制

  1. OpenType 依赖:字体必须运行在支持 GSUB 的渲染环境中。大多数现代浏览器和操作系统满足此要求,但部分终端模拟器或旧软件可能不显示 QR 码。
  2. 输入限制:仅支持可打印 ASCII,不支持中文、表情符号等 Unicode 字符。
  3. 固定掩码:仅使用掩码 0,可能在某些数据模式下导致 QR 码可读性下降(但实际测试中影响较小)。
  4. 性能:完整 RS 电路构建需要数分钟,且生成的字体文件较大(因为包含大量替换表)。

实际应用与演示

项目提供了在线演示:https://qr.jim.sh/

你可以直接输入 [https://example.com] 并看到它变成 QR 码。这特别适用于:

  • 在文档中嵌入可扫描链接
  • 在终端或代码注释中生成小型 QR 码
  • 作为技术演示,展示字体引擎的图灵完备性

构建你自己的版本

如果你想尝试修改或扩展:

bash
git clone https://github.com/jimparis/qr-font.git
cd qr-font
uv sync
make fast-placeholder # 快速测试

如果要使用不同的基础字体(例如等宽字体),确保该字体也使用 SIL OFL 许可证,然后:

bash
uv run tools/build_font.py --base-font /path/to/your-font.ttf

总结:当字体成为最小程序

QR Font 是一个令人惊叹的概念验证。它证明了 OpenType 的 GSUB 机制不仅用于连字和替代字符,还能模拟有限的计算。虽然实际应用可能受限于性能和兼容性,但它为字体设计开辟了新思路:字体文件可以是一个微型编译器,将输入文本转换为完全不同的视觉输出。

对于技术爱好者,这个项目是理解 QR 码规范、Reed-Solomon 纠错以及 OpenType 内部机制的绝佳案例。

原文链接:https://github.com/jimparis/qr-font

相似推荐
uBlock Origin 开发版被 Chrome 商店拒绝:一场关于扩展单一用途政策的争议逆向工程实战:我如何绕过亚马逊Kindle网页端的DRM加密Heroku的丑陋秘密:云之王如何背离Rails并欺骗客户Firefox 成为最后一个支持 uBlock Origin 的主流浏览器:广告拦截的终局之战GitHub Codespaces 深度解读:云端开发环境如何重塑编码工作流认知负荷才是关键:软件设计的根本度量
编写使用方法
Markdown 格式 · Ctrl+Enter 确定
0 字新建笔记
欢迎回来
登录你的墨穗笔记账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属墨穗笔记
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

隐私提醒

取消
编辑工具
受控分享
为这篇笔记生成限时 / 带密码的临时链接
关闭