文字 LOD
缩小文字密集的画布,观察普通文字变成每个非空行一个实色代理。本示例主动开启 LOD;库的默认值仍然关闭。
- 可见文字
- 0
- 完整文字
- 0
- 代理文字
- 0
- 基准屏幕字号
- 18.0 CSS px
本示例主动开启 LOD;库默认关闭。缩小到 6 CSS px 以下进入代理,放大超过 8 CSS px 恢复完整文字。试着从总览和细节两侧进入 7 px 区间,观察滞回。
点击或悬停文字会恢复完整字形,双击可编辑。点击“平移画布”后拖动,或使用滚轮缩放;选中与拾取仍使用原始文字几何。计数是可见文字对象数,不是 drawcall 数或性能基准。
正在准备文字场景…
体验切换
- 从总览开始,切换文字 LOD,在相同相机缩放下比较代理与完整字形。
- 从总览进入 7 px 滞回区间,文字保持代理;先点击查看细节再回到 7 px,文字保持 full。屏幕字号小于 6 CSS px 时进入代理,大于 8 CSS px 时恢复完整文字。
- 选中或悬停可见文字,立即恢复完整字形;取消选择后允许再次使用 LOD。双击文字可以编辑。
- 修改文字数量、平移画布或调整页面宽度。计数沿用原有视口裁剪结果,并包含交互强制 full 的对象。
屏幕字号是本示例 18 px 字体经相机缩放后的 CSS 像素高度,不受设备像素比影响。计数是文字对象数,不是 drawcall 数、GPU 耗时或性能承诺。第一期减少字形工作,文字代理仍独立绘制。
在自己的画布中开启
ts
api.setTextLODEnabled(true);
// 恢复原有的完整文字渲染路径。
api.setTextLODEnabled(false);此开关只属于当前画布的运行时状态,不改变文档 JSON、撤销历史或协作数据。选中、悬停和编辑会恢复 full;拾取、吸附仍使用原始几何,栅格导出始终使用完整字形。复杂样式、效果、裁剪及不支持的文字安全回退 full。
文字 LOD(#674)和保持绘制顺序的实色图形合批优化(#675)均实现在 packages/ecs。合批适用于显式设置 batchable: true 的受支持简单实色 SDF 图形;文字代理尚未接入合批。
本示例使用 ECS 渲染器。旧 Core SDF 文字示例使用另一套渲染路径,不受此开关控制。