Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(perf): pulling the trees' lod1 and lod2 nearer saves 0 to 2 ms after the prepass and thins the crowns, so it stays at 60 and 80 m

yhhafc5a025abe0
diff --git a/docs/TERRAIN_WATER_GPU_COST.md b/docs/TERRAIN_WATER_GPU_COST.md
index 640ea2bd9..27529d342 100644
--- a/docs/TERRAIN_WATER_GPU_COST.md
+++ b/docs/TERRAIN_WATER_GPU_COST.md
@@ -95,7 +95,7 @@
(这一轮机器比第一轮热,绝对值偏高;只看同一轮里的差。)四个机位的截图对比看不出差别,远处山脊上的松树从网格换成了卡片的位置略有不同。
-**还剩的:**花海里只把树换成卡片,帧就从 88 降到 40 ms,所以近处(60 米内)的树仍是最大的一块。把 lod1 提前到 40 米、lod2 提前到 80 米,花海再省约 8 到 13 ms,但近处树冠明显变疏;这是画面取舍,没有改。
+**还剩的:**花海里只把树换成卡片,帧就从 88 降到 40 ms,所以近处(60 米内)的树仍是最大的一块。把 lod1 提前到 40 米、lod2 提前到 80 米,在没有预通道时花海再省约 8 到 13 ms,但近处树冠明显变疏;这是画面取舍。预通道之后重新量过,见最后一节。
## 阴影接收端(2026-10-25 第三轮)
@@ -285,3 +285,21 @@
这也解释了为什么级联模式下近处的阴影不比一张图好:默认范围下第一级的纹素是 2 × 89 米 / 1024 ≈ 17 厘米,和一张 160 米的图(15.6 厘米)差不多。
**能改的是 `shadowDistance`,不是剔除**:给个有限的值(这个示例到 200 米,第一级纹素约 3 厘米),级联才真的把近处分出去,绘制数也跟着降(默认机位 2163 → 805,花海 4739 → 2795);但前面的表说它仍比一张图贵 4 到 14 ms。把默认的“场景尽头”改成别的值会改变所有项目远处的阴影,没有在没有人看过画面的情况下动它。
+
+## 近处的树:lod1 提前到 40 米、lod2 提前到 80 米(2026-10-26,预通道之后)
+
+变体 `trees-lod-mid`(lod1 40 米、lod2 80 米,示例现在是 60 米与 80 米)和 `trees-lod-tight`(30 米与 60 米),每个机位 5 组 12 帧,基准取两次平均:
+
+| 机位 | 基准 ms | 40/80 米 | 30/60 米 | 三角形(基准 → 40/80 → 30/60) |
+|---|---|---|---|---|
+| 花海 | 37.9 | −1.0 | −3.4 | 1.96 → 1.74 → 1.54 M |
+| 湖边 | 41.0 | −1.9 | −4.0 | 1.66 → 1.50 → 1.23 M |
+| 湖与河口 | 40.8 | −0.4 | −4.4 | 1.62 → 1.51 → 1.21 M |
+| 默认 | 27.6 | −0.3 | −0.3 | 0.75 → 0.75 → 0.75 M |
+| 沿河 | 34.5 | +0.6 | −0.9 | 0.91 → 0.90 → 0.77 M |
+
+**预通道之后,这一步只剩 0 到 2 ms(40/80 米)或最多 4 ms(30/60 米),不到一成**:没有预通道时的 8 到 13 ms 里,大头原来是被遮住的叶片着色,现在由预通道拿掉了,三角形少一些只省顶点和光栅化。
+
+**画面:**花海近处树冠的截图(左基准,右 40/80 米):树冠明显变疏——叶片的数量少了、单片变大,枝干的粗细和分叉也不一样,天空从叶隙漏得更多;30/60 米与 40/80 米在这棵树上一样(它在 40 到 60 米之间,两者都已经是 lod1)。用两次基准里都不变的像素数差别:40/80 米的平均差 2.5 到 4.5,差大于 24 的像素 1.7% 到 4.2%;30/60 米 3.5 到 7.1,4.1% 到 8.9%;同一个包什么也不改的对照在 0.3 到 2.0,0%。
+
+**决定:不落地。**为了 0 到 2 ms(1% 到 5%)换近处树冠的外观,不值得;这个外观的变化来自美术给的 lod1 网格本身(它的叶片更大更少),不是距离的问题,所以把它再往近处拉,近处就是一棵不同的树。要省这一块,方向是更好的 lod1(叶片数量与 lod0 一致、只合并三角形)或者用不同的叶片替代,不是移动阈值。