From 6daa01aea41de9d0b23d22daa3af318964dd8a70 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 28 Oct 2026 12:10:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(UI):=20=E5=AD=97=E4=BD=93=E5=8F=A3?= =?UTF-8?q?=E5=BE=84=E6=9B=B4=E6=AD=A3=E2=80=94=E2=80=94218=20=E6=98=AF?= =?UTF-8?q?=E4=B8=8D=E5=90=AB=20ASCII=20=E7=9A=84=E6=B1=89=E5=AD=97/?= =?UTF-8?q?=E7=AC=A6=E5=8F=B7=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit §7「字体体积」原写「218 字（含 ASCII/符号，共 313 字形）」与全仓其余五处口径矛盾： 实测 ui_cn_chars.txt 的 218 个码点**全是非 ASCII**（汉字与 ▶/，/： 等符号）， ASCII 0x20~0x7E 那 95 个字形是 make_font 用 -r 0x20-0x7E 另外打进去的（见同文件 §4 命令行）。 改成本仓统一口径并补上算术：字形数 = 218 + 95 = 313， glyph_dsc 数组实含 notdef 共 314 条（逐条实测计数）。 其余各处在 94b0d790 与本轮同步里已是正确写法（UI_设计架构 §1 表、界面制作流程 C3、 菜单页面设计、simulator/README、架构总览 §3、产品需求 §8.5），本次是消除最后一处反例。 同段旧数 185 字/280 字形、183 字/278 字形（未回填）按历史快照保留不动。 验证：check_doc_links --all --sections-strict 通过（210 个文档）；check_ids --strict 无错误； check_bom_drift / check_mojibake 通过，git diff --check 干净。纯文档。 --- docs/UI设计/UI_中文字体生成与配置.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/UI设计/UI_中文字体生成与配置.md b/docs/UI设计/UI_中文字体生成与配置.md index e71752d3..6da3d417 100644 --- a/docs/UI设计/UI_中文字体生成与配置.md +++ b/docs/UI设计/UI_中文字体生成与配置.md @@ -152,7 +152,8 @@ OK 67325 bytes -> ...\Drivers\BSP\UI\ui_font_cn_12.c 1. **1bpp 细笔画发虚**：宋体在 1bpp 下可能丢像素。若上板/客户端中文偏淡，把第 4 节 `--bpp` 改为 `2` 重生成即可（子集小，体积可接受）。 2. **字符集变更**：以后新增中文菜单项，须重跑第 3、4 节（重新提取 `ui_cn_chars.txt` 并生成），否则新字显示为方框。 3. **编码**：UI 源文件须为 **UTF-8（带 BOM）**，LVGL 按 UTF-8 解码中文串；字体 `.c` 为纯 ASCII，无编码风险。当前 Keil 已加 Misc Controls 抑制项，无需额外 `--locale=english`。 -4. **字体体积**：12px + 1bpp + 218 字（含 ASCII/符号，共 313 字形）源文件 ≈ 65.7KB（2026-10-28 实测 67,325 B；改前 185 字/280 字形/58.2KB，旧文本 183 字/278 字形系未回填）；ROM 增量以 `.map` 为准（2026-10-25 扩 60 字实测 `RO-data` +1,528 B、RAM 0；同日 SOE 显示名再用 4 字实测 `RO-data` +108 B、RAM 0——1bpp 12px 一个字约 27 B，含字形描述符）；改 bpp 2 约翻倍，仍在 F407 Flash 余量内。 +4. **字体体积**：12px + 1bpp + 218 个汉字/符号（**不含 ASCII**——ASCII 0x20~0x7E 由 make_font 的 -r 参数一并打进子集， + 故字形数 = 218 + 95 = **313**，`glyph_dsc` 数组实含 notdef 共 314 条；2026-10-28 实测)源文件 ≈ 65.7KB（2026-10-28 实测 67,325 B；改前 185 字/280 字形/58.2KB，旧文本 183 字/278 字形系未回填）；ROM 增量以 `.map` 为准（2026-10-25 扩 60 字实测 `RO-data` +1,528 B、RAM 0；同日 SOE 显示名再用 4 字实测 `RO-data` +108 B、RAM 0——1bpp 12px 一个字约 27 B，含字形描述符）；改 bpp 2 约翻倍，仍在 F407 Flash 余量内。 5. **换字体**：黑体用 `simhei.ttf`（单文件免抽取）；其余字体同理替换 `--font` 路径后重生成。 ---