Files
MeowOS 553a7d5d9e reader R1: os.meow.reader 书架+TXT 垂直链路骨架
- core: 编码检测(BOM→UTF-8严格→GB18030/Big5统计, Big5与GB重叠按GB18030兜底, §3.5风险注明)
  + GB18030双字节码表(uint16[126][190]=47880B, tools/gen_gb18030_table.py 生成, 生成物入仓)
  + 流式排版器(贪心断行+Kinsoku避头尾+分页+重排锚定, rd_meas_fn 测量回调替 FreeType, 宿主可测)
  + TXT 流式加载器(按段读, 不整文件入内存, \n 恒独立换行可安全分段)
- engine: FreeType 封装(FT_New_Face 按需读文件, NO_HINTING/LIGHT 灰阶, LRU 512 key=码点+字号,
  blend565, rdft_advance 只测宽不栅格化)
- app: 书架(扫 Books/ 识别 5 后缀, 最近读置顶, 空态提示) + 阅读页(W_CUSTOM 画布 3 栏翻页
  +中央菜单占位(字号±/行距±/返回) +顶栏进度%/章节名) + 书桥(段表+flat 页索引, 渲染, 重排回锚)
  + 进度持久化(MeowData/os.meow.reader/progress/, path hash→seg/ch/fs/ls/ts)
- 取舍: 正文字体 FreeType 直读 TF MeowOS/fonts/ TTF/OTF; 无字体回退 SDK 位图字库(meow_ui_text,
  未打包字体(许可/体积), 全 glyph 兜底 R2); 页位图缓存当前+前后各1页(3×691KB), 翻页动画默认无
- 内存实测(宿主 --wrap malloc, 73页书): 书结构 130KB + 当前段刮擦~1.6MB(行/页容量按 n 偏高,R2 收紧)
  + 字形缓存~650KB + 3页位图 2.07MB ≈ 4.45MB 动态, 在 ≤8MB 阅读态预算内
- 测试: 宿主 core 58/58(enc/gb18030金标准/kinsoku/page/reflow/txt); qemu-mipsel ft_smoke PASS
  + book_smoke(12页/渲染有墨/翻页/重排回锚) PASS; reader 交叉 -Wall -Wextra 0 warning
- 产物: reader(mipsel 静态1.2MB)+build_reader.sh(vendor FreeType 可复现); vendor/二进制 gitignore
2026-09-01 23:26:42 +08:00

64 lines
2.9 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
"""gen_gb18030_table.py — 生成 GB18030 双字节 → Unicode BMP 码位表(源码生成物,入仓)。
输出:core/gb18030_table.h 的 `static const uint16_t gb_2byte[126][190]`。
为什么这样生成(对齐 devdocs/plan/READER_ENGINE_NOTES.md §3.4):
- 用 Python 内置 `gb18030` codec 枚举全部 2 字节码位(GB18030 向后兼容 GBK,
故本表覆盖 GBK 全部合法双字节对 + 部分扩展)。
- 表大小 = 126 引导字节(0x81..0xFE)× 190 尾字节 = 23,940 项 × 2B = 47,880 B。
- 0 值 = 未映射;解码器查表得码位,命中 0 → U+FFFD。
- 尾字节列布局 = [0x40..0x7E] 紧接 [0x80..0xFE](跳过 0x7F);索引 idx(b):
b in 0x40..0x7F -> b-0x40 ;b in 0x80..0xFE -> b - 0x41
(即 b - 0x40 - (b>=0x80))。
用法:`python3 tools/gen_gb18030_table.py > core/gb18030_table.h`
(可用 env GB18030_TABLE_H 覆写输出路径。)
"""
import sys
LEADS = list(range(0x81, 0xFF)) # 0x81..0xFE → 126 个
TRAILS = list(range(0x40, 0x7F)) + list(range(0x80, 0xFF)) # 0x40..0x7E,0x80..0xFE → 190 个
INDEX_OF = {b: i for i, b in enumerate(TRAILS)} # 尾字节 → 列号
def build():
g = [0] * (len(LEADS) * len(TRAILS))
for k, lead in enumerate(LEADS):
for j, tr in enumerate(TRAILS):
try:
s = bytes([lead, tr]).decode('gb18030')
if len(s) == 1 and ord(s) <= 0xFFFF:
g[k * len(TRAILS) + j] = ord(s)
except UnicodeDecodeError:
pass
return g
def emit(g):
rows, cols = len(LEADS), len(TRAILS)
out = sys.stdout
out.write("/* gb18030_table.h — GB18030 双字节 → Unicode BMP 码位表(生成物,勿手改;\n")
out.write(" * 由 tools/gen_gb18030_table.py 用 python3 `gb18030` codec 生成)。\n")
out.write(" * 布局:gb_2byte[lead-0x81][trail_col];列号 idx(b)= b-0x40-(b>=0x80);\n")
out.write(" * 值 0 = 未映射(解码器输出 U+FFFD)。46 bytes 行格式可读。*/\n")
out.write("#ifndef RD_GB18030_TABLE_H\n#define RD_GB18030_TABLE_H\n\n")
out.write("#include <stdint.h>\n\n")
out.write("#define RD_GB_LEADS %d\n" % rows)
out.write("#define RD_GB_TRAILS %d\n" % cols)
out.write("#define RD_GB_LEAD0 0x81\n")
out.write("#define RD_GB_TRAIL0 0x40\n\n")
out.write("/* gb_2byte[126][190]:rdgb_lookup(lead, trail) 返回 BMP 码位或 0。 */\n")
out.write("static const uint16_t gb_2byte[%d][%d] = {\n" % (rows, cols))
for k in range(rows):
out.write(" {")
for j in range(cols):
v = g[k * cols + j]
if j % 8 == 0:
out.write("\n " if j else "")
out.write("0x%04X,%s" % (v, "" if j == cols - 1 else ""))
out.write("\n }%s\n" % ("," if k != rows - 1 else ""))
out.write("};\n\n#endif /* RD_GB18030_TABLE_H */\n")
if __name__ == '__main__':
emit(build())