Skip to content

perf(text): cache glyph advances per fixed-size font face - #114

Merged
sudoevolve merged 1 commit into
sudoevolve:devfrom
Linductor-alkaid:perf/text-glyph-advance-cache
Oct 21, 2026
Merged

sudoevolve merged 1 commit into
sudoevolve:devfrom
Linductor-alkaid:perf/text-glyph-advance-cache

Conversation

@Linductor-alkaid

@Linductor-alkaid Linductor-alkaid commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

问题

Closes #113。最新 dev ad7e9e7 的文字测量对每个字符重复 FT_Load_Glyph,相同字形也反复解析轮廓;短文、长文、输入框重排和Emoji都受影响。先完成本地修复及重复性能验证,再创建 issue 和本 PR。

修改

  • 每个固定字号 FontFace 用512槽直接映射缓存原始 advance/height,约6KiB;碰撞常数时间替换,字体owner销毁即释放,移动字体保留缓存。
  • 不缓存失败加载;保留Tab/组合字符、彩色fallback每次高度钳制与绘制slot语义。不改变字体资源、公共API、shaping规则或依赖,不新增线程。
  • 新增独立FreeType oracle、普通/大字号6类场景基准与144行原始统计。

性能与正确性

同机3轮交错A/B、每case预热5次/统计60次,CFF与随包TTF,20.272/46.336物理px。普通文字/长文/Emoji的测量中位耗时约快10–75倍;CFF长混排 4.962→0.183ms,短混排 0.053→0.0024ms。3000个不同汉字 9.874→9.791ms,不宣称此类工作集有显著加速。72组caret位置及UTF-8索引指纹前后完全一致。峰值RSS略增,缓存预算及全部p50/p95见 docs/text-measurement-performance.md 和原始JSONL。

下游仍有页面历史组合开销,本PR不将测量收益宣称为全页面帧率保证。

影响

4文件:修改1、新增3、删除0;+388/-9行(含144行原始统计);追踪内容净增34593 bytes(33.8 KiB)。无新增依赖、资源、二进制或生成代码。

本机环境

Ubuntu24.04.5 / Linux7.0.0-38 x86_64;Intel Core Ultra5 225H(14核)、30GiB内存;GCC13.3、CMake3.28.3、Release -O3。后端运行在私有Xvfb,Mesa25.2.8 llvmpipe LLVM20.1.2;未据此声称硬件GPU或Windows实机性能。

验证

  • GLFW + OpenGL:独立Release构建、36/36测试;安装SDK消费者1/1
  • SDL2 + OpenGL:独立Release构建、36/36测试;安装SDK消费者1/1
  • GLFW + Vulkan:独立Release构建、36/36测试;安装SDK消费者1/1
  • SDL2 + Vulkan:独立Release构建、36/36测试;安装SDK消费者1/1
  • 下游原生Release5/5、ASAN4/4、UBSAN4/4;正常/最小、明暗四张截图逐字节相同

首轮四矩阵并行测试共享了image_cache夹具的固定临时路径,SDL2/Vulkan一项失败;隔离各自TMPDIR/XDG后完整四组36/36通过,没有修改或跳过失败用例。基准在编译/回归结束后运行。方法、原始数据和限制均随PR提交。

@sudoevolve
sudoevolve merged commit 22f0ca3 into sudoevolve:dev Oct 21, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants