Path 合批
Core 与 ECS 中,重复的实色 Path 填充可以共享几何与实例页。本示例主动开启这项实验优化;两个包的默认值均为关闭。优化减少提交次数,保留原始路径精度。
本示例主动开启合批;两个包默认均关闭。点击或框选原始 Path,切换平移后拖动或滚轮缩放。交替几何会打断相邻批次,颜色变化不会。
Core
- 可见 Path
- 0
- drawcalls
- 0
- 索引 / 顶点
- 0 / 0
ECS
- 可见 Path
- 0
- drawcalls
- 0
- 索引 / 顶点
- 0 / 0
- 选中
- 0
指标是各画布最近完成的屏幕帧中真实 WebGL 提交,含背景与交互覆盖层;索引和顶点乘以实例数,二者分开统计。静止时保留最近一帧,导出帧不计入。此计数不是 GPU 耗时或帧率基准。
正在准备 Path 场景…
对比重复与交替路径
- 保持交替几何关闭。路径几何一致,颜色不同。在相同相机位置切换 Path 合批,比较两个画布的可见数量与真实 drawcall 数。
- 开启交替几何。两种路径按绘制顺序交替排列,没有相邻的兼容路径对。开关无法跨越中间几何合批。
- 选择 1,000 条路径,平移、缩放或调整页面宽度。总览分别适配两个画布。点击或框选路径,比较计数前点击取消选择清除选择和悬停覆盖层。
- 点击对应的 PNG 按钮预览完整精度的栅格导出。导出始终走普通的完整 Path 渲染路径,不受屏幕优化影响。
计数器只观察本示例各自 WebGL 上下文中的真实原生提交,包括背景和选择、悬停覆盖层。索引与非索引顶点数量乘以实例数,表示提交的工作量,不是唯一几何存储量。画布静止时保留最近完成的屏幕帧,导出帧不计入。计数不表示帧率或 GPU 耗时,观测本身也有开销。
1,000 条相同路径全部可见且没有交互覆盖层时,当前场景通常从 1,001 次提交降至 2 次:1,000 个独立填充变为一个实例填充,另有一次背景绘制。交替几何仍为 1,001 次。悬停或选择会增加计数。每个兼容实例页最多容纳 4,096 条路径;不支持的画笔、描边、效果、不同线性变换及其他渲染屏障使用完整路径。Core 对只有一个对象的连续段也使用普通 Mesh。
在自己的画布中开启
ts
// Core:画布开关和每条 Path 的显式资格缺一不可。
canvas.pathInstancing = true;
const path = new Path({
d: 'M0 0 H20 V20 H0 Z',
fill: '#2563eb',
batchable: true,
});
canvas.appendChild(path);ts
// ECS:两个字段均不写入文档数据。
api.setPathInstancingEnabled(true);
await api.edit(
(editor) => {
const node = editor.getNodeById('your-path');
editor.getEntity(node).write(Renderable).batchable = true;
},
{ capture: 'NEVER' },
);将画布开关改回 false 即可恢复普通绘制。拾取、包围盒和选择保留原始几何,文档 JSON、历史与协作数据不变。此优化与文字 LOD 相互独立。