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.
Terrain & Water 示例的 GPU 帧耗时(2026-10-25 实测)
用 node tools/terrain-water-cost.mjs 量:导出真实的示例包,在无头 Chromium 里按变体各跑一遍,每个变体拿掉或调低一样东西(一个效果、阴影、植物、多重采样……),用游戏自己的时钟步进若干帧并读回最后一帧,取每帧毫秒的中位数。一个部分的成本是它与原场景的差。无窗口,不启动编辑器。
**机器与口径:**RTX 3060,ANGLE/D3D11,WebGL2(包里的 ?headless 钩子固定 WebGL2,WebGPU 没量),1920×1080,质量 high,每个变体 7 组各 12 帧(其他机位 5 组)。同一场景重复量两次的漂移约 1.6 ms,所以小于 2 ms 的差不下结论。
**这不是逐 pass 的 GPU 计时。**引擎只有整个渲染图的一个 GPU 计时器,而场景的网格绘制在图外,所以这里用的是拿掉某部分后的差,不同部分的差不能相加(去掉最后一个后处理效果会连带去掉别的)。
一帧多长
| 机位 | 每帧 ms | CPU ms(含剖析开销) |
|---|---|---|
| 场景自己的相机 | 44.7 | 8.6 |
| 花海(C 键 1) | 93.3 | 12.3 |
| 湖边(2) | 75.2 | 14.4 |
| 湖与河口(3) | 72.6 | 26.2 |
| 沿河而上(4) | 51.2 | 10.0 |
任何一个机位都到不了 60 fps(16.7 ms),而 CPU 只占零头:这个场景受 GPU 限制,而且主要受像素限制。
各部分拿掉后省多少毫秒
| 变体 | 默认机位 | 花海 | 湖边 | 湖与河口 | 沿河 |
|---|---|---|---|---|---|
| 无植物 | −22.2 | −68.3 | −49.0 | −49.7 | −27.9 |
| 太阳不投影 | −12.1 | −38.5 | −20.9 | −24.3 | −19.2 |
| 不开多重采样(4× → 1×) | −11.1 | −27.6 | −13.4 | −17.0 | −6.6 |
| 渲染比例 0.75 | −14.6 | −44.0 | −26.1 | −23.9 | −17.5 |
| 无后处理体积 | −13.7 | −12.9 | −6.1 | −11.7 | −11.4 |
| 天空大气关 | −10.0 | −0.7 | +3.3 | −8.5 | −6.8 |
| 高度雾关 | −7.1 | +2.8 | +6.1 | −4.7 | −6.0 |
只在默认机位量的:
| 变体 | 省 ms |
|---|---|
| 地形(连同长在上面的植物) | −26.3,去掉植物后地形本身约 4 |
体积光(u_volumetric 1 → 0) |
−1.4 |
| GTAO | −2.2 |
| bloom / 镜头光晕 / 调色 + LUT / FXAA / 自动曝光 | 各约 −1.5 到 −2.3 |
| 阴影级联 4 → 2 | −1.8 |
| 阴影图集 4096 → 2048 | −2.1 |
| 水波 4 → 2 | −2.6 |
| MSAA 2× | −6.7 |
| 植物细节比例 0.5 | +2.1(变慢,绘制数 610 → 672) |
质量 medium |
−7.1(37.6 ms) |
质量 low |
−22.4(22.3 ms) |
读法
- 植物是最大的一块,占默认机位的一半、花海的四分之三。引擎计数:默认机位 610 次批绘制、1.89 M 三角形,其中阴影绘制 432 次;花海 2.81 M 三角形、阴影绘制 1161 次。
- 阴影第二,12 到 38 ms,但把级联减半或图集减半只省 2 ms 左右:代价在被投影的几何(植物进四级级联)和着色时的采样,不在分辨率。
- 渲染比例 0.75 省下的比例远大于面积之外的零头:帧里和像素数成正比的部分占了大头,所以是片元受限(植物的叶片、4× 多重采样、地形与水的着色),不是顶点受限。
- **先前的推断有一条不成立:**体积光在这个机位只花 1.4 ms,不是头号嫌疑。天空和雾合起来 10 到 17 ms,但分布看机位(花海里去掉天空反而变慢,说明量到了和别的 pass 的牵连)。
- 植物细节比例调到 0.5 反而慢,值得单独查(多出的 62 次绘制)。
- 地形网格本身便宜(约 4 ms),CDLOD 已经起作用。
没量到或有牵连的
- 水在第一轮没有单独量出来(拿掉水体时植物也消失大半),后来量了,见最后一节。
- WebGPU 没量;一块显卡,一个分辨率。
- 在“湖与河口”机位拿掉水体,页面崩溃(
Target crashed),重试同样崩;默认机位的同一变体第一次跑也崩过一次,重跑正常。没有查原因。 tools/terrain-water-cost.mjs把导出目录里的场景与配置改写后在退出时还原;原始数据在output/perf/(被忽略,不入库)。
植物(2026-10-25 第二轮)
按层与按部件拿掉植物,默认机位:
| 变体 | 每帧 ms | 三角形 |
|---|---|---|
| 原样 | 43.1 | 1.89 M |
去掉 groves 层(树) |
28.9 | 0.45 M |
去掉 cover、drifts、reeds、banks、stones、sea、shoals 任一层 |
都在噪声内(±3) | |
| 植物不投影 | 不变,阴影绘制 432 → 2 | |
| 树只画远景卡片 | 28.2 | 0.49 M |
| 树 95 米外就换成卡片(原 380 米) | 32.2 | 0.59 M |
| 树的 lod1 提前到四分之一的距离 | 44.4(不变) | 1.89 M |
- 植物的成本几乎全在树:一个层(
groves)占 14 到 18 ms,其余七个层加起来在噪声里。花海机位里树占 45 ms 以上。 - 植物投影本身不花钱。阴影的 12 到 38 ms 是接收端:每个像素的着色都在采样级联。
- 树在 60 到 170 米之间最贵:art 给的 lod1 只有 lod0 的一半三角形(一棵橡树约 2 万,每块叶片卡片是独立的小四边形),从 60 米起就是约 1 万三角形盖几百个像素,而卡片要到 380 米才接手;层又只在 170 米内长出树本身。把 lod1 提前没有用(上表最后一行),缺的是 lod1 和卡片之间的一级。
- 管线的
meshSimplify带LockBorder,叶片卡片合不拢(橡树叶片部件锁边后一个三角形也减不掉);不锁边、带Sparse才能降到十分之一。
**做了什么:**每个部件可以有第三个网格 lod2Mesh,种类有 lod2Distance,到了这个距离换用它。树各有一份(约原来的十分之一:橡树两个部件 1588 与 2182 个三角形),examples/terrain-water/tools/plant-lod2.mjs 生成,换用距离 80 米(lod 为 60 米)。不动引擎:两组实例各画自己的距离段(MeshInstances 的 minDistance / drawDistance),所以两段交界处,中心距离在交界上下一个树冠半径之内的树两个网格都画。
同一次运行里 A/B(有第三个网格 vs trees-no-lod2,每个机位各量两次取平均):
| 机位 | 之前 ms | 之后 ms | 差 | 三角形 |
|---|---|---|---|---|
| 默认 | 43.4 | 34.8 | −8.6 | 1.89 → 0.88 M |
| 花海 | 102.7 | 87.9 | −14.8 | 2.81 → 2.20 M |
| 湖边 | 84.9 | 70.8 | −14.1 | 2.49 → 1.86 M |
| 湖与河口 | 75.3 | 66.6 | −8.7 | 2.57 → 1.74 M |
| 沿河 | 54.1 | 54.4 | +0.4 | 0.94 → 0.95 M |
(这一轮机器比第一轮热,绝对值偏高;只看同一轮里的差。)四个机位的截图对比看不出差别,远处山脊上的松树从网格换成了卡片的位置略有不同。
**还剩的:**花海里只把树换成卡片,帧就从 88 降到 40 ms,所以近处(60 米内)的树仍是最大的一块。把 lod1 提前到 40 米、lod2 提前到 80 米,在没有预通道时花海再省约 8 到 13 ms,但近处树冠明显变疏;这是画面取舍。预通道之后重新量过,见最后一节。
阴影接收端(2026-10-25 第三轮)
接收端是 shadowFactor3D(ShaderParser.cpp 里 GLSL 与 WGSL 各一份)。太阳有大小时,每个像素先在 24 个阴影图纹素的圆盘里用 16 个采样找遮挡物,找到了再按本影宽度用 32 个采样滤波。没有遮挡物的像素(大部分地面)只付前 16 个采样,所以成本主要在这 16 个采样和它们每个自带的运算,不在级联的挑选(每像素至多四次矩阵乘,和 48 个采样比可以忽略)。
做了什么(同一个引擎构建、同一个导出包、交替运行,默认机位与花海各两次):
- 采样点的位置改成常数表。螺旋的每个点原来在像素里算一次
sin、cos、sqrt(48 个点),它们和像素无关;现在是 8、16、32 点的常数表,每个像素只转一次(cos/sin一次)。 - 遮挡物采样的“宽容深度”改成线性式。每个采样原来做一次 4×4 矩阵乘加一次除法;
stepFor在步长上是线性的,所以先把矩阵作用在光的方向上一次(m * vec4(L, 0)),每个采样沿它移动裁剪空间位置。数学上相同,只差浮点舍入。 - 本影内直接返回 0:16 个遮挡物采样全部命中,说明在阴影里面,32 个滤波采样只会得出 0。
- 窄半影用更少的采样:半径小于 1.5 个纹素用 8 个点,小于 4 个用 16 个,其余仍是 32。
| 机位 | 之前 ms | 1 + 2 之后 | 加上 3 + 4 之后 |
|---|---|---|---|
| 默认 | 34.0 | 31.5 | 30.5 |
| 花海 | 82.9 | 76.5 | 72.5 |
(ms 是同一轮里交替量的均值。1 + 2 是精确的重排,每个机位约省 7%;3 + 4 再省约 1 ms,是取舍:窄半影变得稍粗,螺旋逐点旋转,留下的是颗粒而不是条带。)三维阴影的 20 个像素验收(mesh-shadow*、sun-shadow*、soft-shadow*、spot-shadow、point-shadow*)在 WebGL2 与 WebGPU 上都通过。同一个包两次运行之间云和水就有 2% 到 3% 的像素不同,所以没有做逐像素差的结论。
**没有动的:**阴影的 12 到 38 ms 是拿掉阴影后的差,接收端占了其中大部分;这里在默认机位省下约 3.5 ms,花海约 10 ms,约为这个函数成本的三成。剩下的主要是“每个被着色的像素都付 16 个采样”,而植物叶片多层叠,一个像素被着色多次(前向渲染,没有深度预通道)。要再省下去,是深度预通道让被遮住的像素不再着色,而不是继续改这个函数。
深度预通道(2026-10-25 第四轮)
前向渲染没有深度预通道:不透明的网格按状态排序、各画各的,一个像素被树叶、草、地面依次着色,最后只有一个留下。树叶是 alpha-to-coverage 的镂空卡片,层叠最多,也是植物里最贵的部分。
**先量:**场景 opaque 网格里,默认机位 1507 个中 1013 个是镂空(alphaIsCoverage),只有 494 个是实心的,32 个是顶点被材质弯曲(地形)。只让实心的做预通道,默认机位省 0.6 ms,花海省约 10 ms;让镂空的也做,才是大头。
做了什么:
- 渲染管线
PipelineDesc加colorWrite(不写颜色)与depthEqual(深度等于也通过);GL 与 WebGPU 两个后端都实现。 - 一个网格 draw 有
depth_shader_id:只写深度的程序,顶点阶段就是它自己的(mesh.esshader的SHADOW_DEPTH变体,与着色用的是同一份顶点源;gl_Position/ WGSL 的位置都标了invariant,两个程序算出同一个深度)。 - 镂空材质用新的
PREPASS_COVERAGE变体:写出与着色片元相同的覆盖率(同一个表达式、同一个输入、同一个顺序),所以在 alpha-to-coverage 下两遍画出同样的采样点。只对引擎自己的Model着色器这样做,别的(头发、自带顶点阶段)留在预通道之外。 DrawList::execute多了DrawPass:先DepthPrepass,再ColorAfterPrepass(参与的 draw 用depthEqual、不再写深度)。- 质量档位加
depthPrepass:high、medium 开,low 关,质量系统关掉时也关。分块 GPU(手机)上这一遍是几何画两次,所以默认不开。
带顶点钩子的材质(地形)一开始被排除了:让地形的深度程序走 shadowProgram,中远景地形块的深度与着色那遍对不上,整块不画出来。原因见下一节,后来修好,地形现在也参加。
同一个包里的开关前后(no-prepass 是 depthPrepass: false,RTX 3060,1080p,每个值 5 组 12 帧):
| 机位 | 没有预通道 ms | 有预通道 ms | 差 |
|---|---|---|---|
| 默认 | 34.4 | 30.6 | −3.9 |
| 花海 | 81.1 | 45.0 | −36.1 |
| 湖边 | 69.4 | 48.0 | −21.4 |
| 湖与河口 | 63.8 | 45.8 | −18.0 |
| 沿河 | 50.8 | 40.4 | −10.4 |
三角形数不变;绘制数不变(预通道 607 个 draw,是同一批)。预通道在 render.prepass.draws,没有参加的原因在 render.prepass.cutout/bent/noProgram。
**检查:**帧对比没有看到空洞或光晕;与上一个构建的像素差,树和花的带状区域有 0.12% 的像素差大于 24,在同一个包两次运行 0.01% 的参照之上,看截图是远处镂空卡片边缘的取样不同,和重叠的共面卡片在 LEQUAL 下谁盖谁。像素验收:原来的 128 个网格/阴影/深度/天空相关的场景在 WebGL2 通过、WebGPU 通过(device-loss-* 的四个在 WebGPU 上先前就失败);新增 11 个 *-prepass 孪生场景(同一画面、预通道开着,并要求至少有一个 draw 参加),WebGL2 与 WebGPU 都通过。WebGPU 上没有量帧耗时。
**限制:**只在一块 NVIDIA 显卡的 D3D11 上量过;预通道要求两个程序的位置逐位相同,靠 invariant 保证,在别的驱动上没有试过(出问题时的表现是着色那遍的像素被深度测试挡掉,画面上有洞)。
地形为什么对不上(2026-10-26)
MaterialStore::variantProgram(着色那遍的程序)建好之后调 seedSamplers:把材质用 #pragma param … texture 声明的采样器设到它声明的纹理单元上。shadowProgram(深度程序,阴影图用,预通道也用)建好之后没有调,所以它的采样器全是默认的 0 号单元。地形的顶点钩子读 u_heightPages(高度页),深度程序读到的是 0 号单元上别的纹理,顶点的高度错了,写进预通道的深度和着色那遍的深度就不是同一个。近处的块高度页恰好和 0 号单元差得不大,中远景的块整块落在深度测试之外,画不出来。
修法是一行:shadowProgram 建好程序后同样 seedSamplers(*shader, material)。
**这也是一个旧的阴影缺陷:**地形(和任何顶点钩子读纹理的材质)往阴影图里画时一直在读 0 号单元的纹理,所以它投出的阴影用的不是它自己的高度。修好之后阴影图里的地形才是画面里的地形。WebGPU 的纹理按组与单元绑定,没有这个问题。
**防回归:**夹具 prepass-hook:一个立方体,材质的顶点钩子读一张黑纹理把顶点往眼睛方向抬(网格自己的纹理是白的)。程序读对了纹理,立方体不动,画出来;读成 0 号单元的白纹理,深度程序把它抬走,着色那遍的深度测试挡掉整个立方体。prepass-hook(无预通道)和 prepass-hook-prepass 两个场景,WebGL2 与 WebGPU 都通过;把 seedSamplers 那一行拿掉重编,WebGL2 上 prepass-hook-prepass 变红、prepass-hook 仍是绿的。
地形参加之后的帧耗时(no-prepass 对比,同一个包;这一轮机器比前几轮热,绝对值偏高):
| 机位 | 没有预通道 ms | 有预通道 ms | 差 |
|---|---|---|---|
| 默认 | 34.0 | 30.2 | −3.8 |
| 花海 | 81.5 | 42.6 | −39.0 |
| 湖边 | 88.0 | 60.4 | −27.6 |
| 湖与河口 | 71.9 | 48.0 | −23.9 |
| 沿河 | 57.3 | 42.2 | −15.1 |
和地形不参加时(上一节)比,差别在机器的波动里:地形自己几乎没有过度绘制,所以它参加与否对速度没有可见影响;这一步的意义是:任何带顶点钩子的不透明材质(风吹的植被、被弯曲的网格)现在都能参加预通道,且深度是对的。
镂空且带顶点钩子的材质仍不参加(它的覆盖率程序只为 Model 着色器写)。
多重采样与 FXAA(2026-10-26,预通道之后)
先量,没有改引擎。同一个包,quality 档位 high 的配置里只改 msaaSamples / skipEffects;每个机位 5 组 12 帧,基准取两次平均。
| 机位 | 基准 ms | MSAA 2× | MSAA 1× | 去掉 FXAA | MSAA 1× 去掉 FXAA | MSAA 4× 去掉 FXAA |
|---|---|---|---|---|---|---|
| 默认 | 30.4 | −4.1 | −5.0 | −1.0 | −5.1 | +0.1 |
| 花海 | 41.8 | −2.8 | −7.2 | +0.5 | −6.4 | +1.6 |
| 湖边 | 47.6 | −3.3 | −8.4 | −0.1 | −8.5 | +1.2 |
- FXAA 的成本在噪声里(−1.0 到 +0.5 ms,同一个包两次基准就差 1 到 3 ms)。和 4× MSAA 重复是画面上的事(两遍抗锯齿),不是帧耗时的事,所以没有为它改任何东西。
- 4× MSAA 在预通道之后仍是 5.0、7.2、8.4 ms(帧的 16% 到 18%);2× 只拿回其中一半或更少(4.1、2.8、3.3)。
- **花在场景那一遍,不在解析和后处理:**把后处理体积整个拿掉后 4× 与 1× 的差还在(默认机位 17.4 对 12.8,花海 31.3 对 21.9),带着后处理时差是 5.4 与 7.7。解析(深度加颜色)加起来不会超过拿掉阴影后剩下的差:默认机位 0.7 ms,花海 3.8 ms。
- **和接收阴影的片元绑在一起:**拿掉阴影,默认机位 4× 与 1× 只差 0.7 ms(有阴影时 5.4)。镂空的叶片卡片在边缘上被更多的像素碰到,多重采样下每个被碰到的像素都要着色一次,每次都付一遍阴影接收;采样数增加的是着色次数,不是每次着色的价格。
- **软阴影的搜索不是杠杆:**把太阳的
sourceAngle设为 0(硬边,九个采样)并没有更便宜(32.5 对 30.8,42.4 对 40.1 ms),4× 与 1× 的差仍有 5.2 与 6.6 ms。所以让远处的片元改走硬边路径,或者再减采样数,在这里没有收益。 - 这个场景的后处理链没有任何效果会要求场景写第二个表面附件(
ssr、ssgi、rain才会),所以多重采样的第二个附件不在这笔账里。
**结论:**MSAA 的剩余成本是画面质量与着色次数的交换,引擎里没有一处可以不改画面就省下来的浪费。能做的是档位的选择:要这部分时间就用 2×(medium 已经是 2×,省 3 到 4 ms)或 1× 加 FXAA(省 5 到 8 ms,边缘质量不同,需要有人看);要省着色次数而不省采样,方向是让每次着色更便宜(例如镂空卡片的接收阴影),不是动 MSAA。
阴影接收的固定成本(2026-10-26)
怎么量:shadowFactor3D(GLSL)在三处各截断一次,各建一个引擎、各导出一个包,交替运行,每个机位两轮,返回值里带一个 1e-9 级的项让编译器不能把前面的计算丢掉:
- B0:一进函数就返回 1.0(阴影图仍然在画,什么都不读);
- B1:算完选瓦片、矩阵、纹素大小和要比较的深度之后返回;
- B2:再加上 16 个采样的遮挡物搜索,不做滤波。
| 机位 | 完整 ms | B2(无滤波) | B1(无搜索) | B0(不读) |
|---|---|---|---|---|
| 默认 | 30.0 | 29.5 | 26.1 | 26.9 |
| 花海 | 41.2 | 41.4 | 36.5 | 37.1 |
- 整个接收端是 3 到 4 ms,约帧的 10%。
- 选瓦片、矩阵、纹素大小这些固定的部分几乎是零(B1 与 B0 差在噪声里)。
- 成本在遮挡物搜索的 16 个采样(B2 比 B1 多 3.3 与 4.9 ms)。滤波一段几乎不花钱(0.6 与 −0.2 ms):绝大多数片元是亮的,搜索里一个遮挡物也没找到就返回了。
试了两个改法,都没有留:
- 光照在表面背面的片元跳过阴影查找。 精确的(漫反射、镜面、光泽都乘 N·L;只有头发、涂层、散射表面读背面的光,这几种仍然查)。前后对比三个机位:30.8 → 31.0、42.9 → 43.3、46.7 → 46.1 ms,在噪声里,没有收益。
- 遮挡物搜索先用 4 个分散的采样,一个遮挡物都没有就当作亮的,不读另外 12 个。 反而慢了:+1.2、+1.2、+2.3 ms(分两段循环、分支发散的代价大于省下的采样),也会漏掉小遮挡物(叶片阴影的斑点)。
加上前面的结果(把太阳设成没有大小、走 9 个采样的硬边路径并不更便宜):这个函数的成本不随采样数线性走,少读几个采样不是杠杆;所以镂空叶片的每次着色在阴影接收上没有可以不改画面就拿走的东西。要再省,方向只剩着色次数(多重采样和镂空卡片的边缘像素)和阴影本身的范围(shadowDistance、级联数)。
另:构建会重新生成并被 git 跟踪的 ShaderEmbeds.generated.hpp,预通道那次提交没有带上它的更新(原生构建读它),这次补上。
水(2026-10-26)
**怎么在不动世界生成的前提下量水:**拿掉水体、或者把水体设成不可见,植物都会跟着消失(绘制数 610 → 50):世界生成每次读的是活着的水体。所以不碰实体,把 WaterZone.rings 设为 0:水面的网格环没有了(截图里海床干着,植物、木箱、地形都在,网格数不变),水体和水场还在。变体 water-norings。
| 机位 | 基准 ms | 去掉水面 | 占帧 |
|---|---|---|---|
| 默认 | 29.1 | −3.5 | 12% |
| 花海 | 41.2 | −2.3 | 6% |
| 湖边 | 42.3 | −1.0 | 2% |
| 湖与河口 | 43.0 | −1.3 | 3% |
| 沿河 | 37.2 | −5.2 | 14% |
这个数里还含着水面带来的整帧开销:水折射要看见身后的画面,场景得分成两遍画,中间拷一份颜色(和深度)。
水的质量档位没有一个动得了它(waterDisplacement、waterCaustics、waterMirror、waterRippleCells、waterWaves,相对基准都在 −1.2 到 +1.5 ms 之间,同一个包两次基准就差 1 到 3 ms):在这些机位上它们要么作用在水下(镜面、焦散),要么作用在顶点上(位移、波数、涟漪),而成本在像素和那次分遍。
多重采样关掉后水的成本:默认机位 3.0 → 2.4,沿河 3.1 → 6.1(这一组的基准漂得厉害,不下结论)。
**结论:不值得现在优化。**水一共 1 到 5 ms(平均 2.7),是这个示例里最小的一块(植物 22 到 68,阴影 12 到 38,多重采样 5 到 8),而且没有一个现成的旋钮可以动它。真要动,杠杆只有两个,都得先单独量:折射用的场景拷贝(缩小分辨率或只拷水面范围),和水面片元里的反射步进(20 步)。
阴影范围:级联数与 shadowDistance(2026-10-26)
先说一个前提:这个示例的太阳有固定范围(shadowExtent: 16000,即 160 米),阴影是一张那么大的图,shadowCascades 和 shadowDistance 在它身上不起作用(ext16-casc-1 与基准一样:+0.1、+0.6、−0.1、−1.9 ms,噪声)。级联只在太阳的 shadowExtent 为 0 时才有(阴影按视锥切成几段),所以下面的“级联”各行都把太阳的范围改成了 0。
帧耗时,相对基准(基准:默认 28.4、花海 38.7、湖边 41.1、湖与河口 42.3 ms;每个值 4 组 12 帧):
| 设置 | 默认 | 花海 | 湖边 | 湖与河口 | 阴影绘制数(默认 / 花海) |
|---|---|---|---|---|---|
| 示例原样(一张 160 米的图) | 0 | 0 | 0 | 0 | 432 / 1221 |
| 范围 80 米(一张图) | −0.5 | +1.0 | 0 | −2.2 | 144 / 1069 |
| 范围 320 米(一张图) | +0.4 | +0.1 | −0.8 | −2.3 | 641 / 1221 |
| 1 级联,到场景尽头 | +1.0 | −0.2 | −1.2 | −2.5 | 642 / 1221 |
| 2 级联 | +2.6 | +4.7 | +4.5 | +2.9 | 1262 / 2442 |
| 3 级联 | +3.4 | +8.3 | +10.0 | +7.4 | 1659 / 3606 |
| 4 级联 | +10.6 | +12.2 | +14.1 | +11.1 | 2163 / 4739 |
| 4 级联,到 100 米 | +2.7 | +8.3 | +7.9 | +8.3 | 395 / 1941 |
| 4 级联,到 200 米 | +3.8 | +10.3 | +11.0 | +14.0 | 805 / 2795 |
| 4 级联,到 400 米 | +4.5 | +13.1 | +13.8 | +15.7 | 1253 / 3789 |
| 2 级联,到 100 米 | +2.1 | +2.7 | +1.9 | +3.9 | 381 / 1357 |
| 2 级联,到 200 米 | +1.2 | +3.1 | +4.0 | +5.8 | 643 / 1733 |
耗时跟着阴影图里重画的投射体走(阴影绘制数栏):每多一个级联,树和草就在那一张图里再画一遍,植物这样稠的场景里一个级联就是 3 到 4 ms。一张图的范围(80 米、160 米、320 米)几乎不花钱,因为投射体只画一遍。
画面差别(同一个包,相对原样;两次运行之间云和水就会变,所以只数两次基准里都不变的像素;对照是“什么也没改”的 ext16-casc-1,平均差 0.3 到 0.6,差大于 24 的像素 0%,湖与河口那一视角对照本身就有 2.0):
- 2 到 4 个级联、到不同距离、一张 80 米或 320 米的图:平均差 1.0 到 2.6(湖与河口 4.2 到 6.1,那一视角的对照本身是 2.0),差大于 24 的像素 0.3% 到 1.3%(湖与河口 1.9% 到 3.9%)。截图里(花海近处的树下)看不出区别:近处的软阴影和原样一样。
- 1 个级联明显更差(平均差 2.7 到 7.7,差大于 24 的像素 2.3% 到 6.9%):一个级联铺满整个视野,纹素太粗,近处地面上的树影整片没有了。
**结论:这个示例已经在最便宜的一端,没有可以拿的。**一张 160 米的图在耗时和近处的画面上都不输级联;级联只会在“要看很远的阴影”时才值得,而且每多一个就是多画一遍投射体。如果要把阴影看到更远,代价是级联(2 个,到 200 米,约 +1 到 6 ms),不是把范围放大(免费,但纹素变粗)。
四个级联的阴影绘制数是一个级联的四倍多,这一点后来查清了,见下一节:不是剔除没做。
级联为什么都画了差不多所有的投射体(2026-10-26)
**问题:**4 个级联的阴影绘制数是 1 个的 4 倍多,是不是每个级联都画了整个范围的投射体,没有按各自那一段剔除?
**量法:**临时在 executeShadowPass 里给每张图记它收集到的绘制数和实例数,在 buildShadowPlan 里记每个级联的半径和投射距离(量完已拿掉,没有留在引擎里)。太阳范围改为 0,4 个级联,花海机位:
| 设置 | 级联 | 半径(米) | 绘制数 | 实例数 |
|---|---|---|---|---|
| 到场景尽头(默认) | 0 / 1 / 2 / 3 | 89 / 173 / 339 / 1350 | 1076 / 1221 / 1221 / 1221 | 7872 / 9027 / 9027 / 9027 |
| 到 200 米 | 0 / 1 / 2 / 3 | 15 / 31 / 66 / 224 | 151 / 439 / 984 / 1221 | 1345 / 3554 / 7269 / 9027 |
**结论:剔除是做了的,而且是对的;绘制数多是因为级联太大。**每张图收集的是它那一段的包围球在光方向上拉出的柱体里的东西(一个投射体可以在柱体外的任何地方,只要它的影子落在这一段里,所以柱体要一直拉向光源)。这样到 200 米时第一级只收 151 个绘制,往后逐级变多,是剔除在起作用。默认的范围是“场景尽头”,这个世界有 28 公里宽的地形,四段的半径是 89、173、339、1350 米:第一段就已经包住了周围 120 米内所有植物能投影的范围,后面几段更是,所以每张图都收到几乎全部(最多 9027 个实例,受植物自己的阴影距离 120 米限制)。
这也解释了为什么级联模式下近处的阴影不比一张图好:默认范围下第一级的纹素是 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 一致、只合并三角形)或者用不同的叶片替代,不是移动阈值。
水:折射用的场景拷贝与反射步进(2026-10-26)
先量,两个都不是杠杆,真正的成本在别处。
| 量什么 | 做法 | 结果 |
|---|---|---|
| 场景拷贝(颜色与深度两次全屏) | 引擎里把两次拷贝拿掉,留下分遍(变体 E1) | 水的成本 0.4 到 3.1 ms,和不拿掉(1.5 到 3.3)在噪声里 |
| 分遍加拷贝都拿掉 | 水不再折射,和别的一起画(E2) | 水的成本 1.3 到 4.9 ms,没有更便宜 |
| 反射步进(20 步) | 着色器里关掉那一段(C6) | 和完整一样(3.7 对 3.0,3.0 对 2.8,1.3 对 1.5) |
| 波浪、区域、涟漪(C1) | 算完法线就返回 | 水的成本 ≈ 0 |
| 折射、焦散、泡沫、光照(C2 到 C4) | 依次在每段后面返回 | 每一档都 ≈ 0 |
(都是“基准减去没有水面”的差,同一个包里算,抵消机器的漂移。)所以水着色器的数学几乎不花钱;成本在着色器末尾那条 discard:去掉它水的成本从 2.4、2.1、2.0 降到 0.9、1.0、0.6 ms(变体 C7,画面不对,只为量它)。
**原因(推断):**着色器里有 discard,就不能让深度测试先于着色器做完,被地形或树挡住的水面像素(一整块 28 公里的海面在山后面)也要把整段着色器跑完才被深度测试丢掉。那条 discard 只在海岸之外(shoreDist < 0)才会真的丢,所以把判断挪到前面、先算它再算波浪和光照也行(变体 C8:1.9、1.0、0.8 ms)。
**做了什么:**把这三条语句(film、under、discard)原样移到场景深度读出之后、算波浪之前。它们用到的值都不依赖波浪和光照,所以结果相同,只是不是水的像素早早离开。只改了 WebGL2 的 GLSL;WGSL 孪生没动(没有引擎侧的水夹具能验它,编辑器的水检查在 CI 里)。
交替 A/B(同一个引擎,只有水着色器不同,每个机位两轮):
| 机位 | 之前 帧 / 水 ms | 之后 帧 / 水 ms |
|---|---|---|
| 默认 | 26.5 / 2.8,25.8 / 2.6 | 24.9 / 1.6,24.8 / −0.2 |
| 花海 | 38.9 / 1.0,41.5 / 5.4 | 34.9 / 0.7,35.5 / 0.1 |
整帧省 1 到 5 ms(这一对包的机器漂移比水本身大,保守地读成 1 ms 左右)。像素:沿河机位里两次基准都不变的 84% 的像素,新旧平均差 0.36,差大于 24 的 0.23%(对照一般 0.3 到 0.6)。
现在整帧在哪(同一天,所有改动之后)
| 默认机位 | 沿河 | |
|---|---|---|
| 帧 | 24.8 ms | 32.0 ms |
| 后处理链整个 | 12.4 | 12.7 |
| 其中天空大气 | 7.9 | 7.2 |
| 其中高度雾 | 5.1 | 5.1 |
| 其中 GTAO | −0.2(噪声) | 2.8 |
| 其中体积光 | −0.3(噪声) | −0.6(噪声) |
| 其中 bloom | 0 | 1.4 |
| 植物 | 4.3 | 12.1 |
| 阴影 | 3.6 | 9.8 |
最大的一块已经变成天空大气加高度雾:默认机位上这两个就占了帧的一半以上(不是互相独立的,去掉一个另一个的成本会变,所以不能相加)。这是下一步最值的方向,见 docs/GPU_PERFORMANCE_OPTIONS.md。
逐 pass 读数(2026-10-26)
渲染图每个 pass 现在有自己的 GPU 计时(node tools/terrain-water-cost.mjs --only base --passes --view N,RTX 3060、1080p、WebGL2)。各 pass 之和与整图计时吻合,与墙钟也吻合,所以这是一张可以相加的表,消融那张不是。
| pass | 机位 0 | 机位 1 | 机位 3 |
|---|---|---|---|
| scene(不透明加预通道) | 9.4 | 16.1 | 18.1 |
| heightFog | 5.0 | 5.0 | 5.0 |
| skyAtmosphere | 4.1 | 4.3 | 4.0 |
| scene-glass(水等透明) | 2.8 | 1.4 | 3.0 |
| shadow-atlas | 0.4 | 4.3 | 4.2 |
| lensFlare | 0.75 | 0.75 | 0.76 |
| gtao_ao | 0.26 | 0.44 | 0.44 |
| scene-grab | 0.3 | 0.3 | 0.3 |
| 其余(bloom 五级、色彩分级、FXAA、曝光…)每个 | ≤0.1 | ≤0.1 | ≤0.1 |
| 整图 / 墙钟 | 24.2 / 25.7 | 33.8 / 35.3 | 36.5 / 38.7 |
比消融表多告诉我们的几件事:
- 天空大气单独是 4 ms,不是消融里的 7.9:消融把“拿掉它之后后面的 pass 少读了什么”也算进去了。高度雾 5.0 ms 在三个机位上一样,是与画面内容无关的固定成本(全屏、每像素一次),是后处理里最先该动的一块。
- 不透明场景加预通道是帧的 40% 到 50%,随机位涨到 16 到 18 ms;阴影图在机位 1/3 上是 4.2 到 4.3 ms,机位 0 上只有 0.4。
- 镜头光晕(
lensFlare)0.75 ms 是固定的,没有人想到过它。 - 其余全屏 pass(bloom、分级、FXAA、曝光、gtao 的模糊)加起来不到 1.5 ms:合并它们(选项第 7 项)的上限很低。
天空与雾的半分辨率(2026-10-26)
先量清成本落在哪(--passes,机位 0):天空的 4.1 ms 里,云的步进加地面上的云影占了 3.2 ms(关掉云,天空只剩 0.86 ms);雾的 5.0 ms 里,云的光柱(u_cloudShade)占 3.7 ms,其余的体积光加解析雾只有 1.25 ms。也就是说“天空和雾”的成本几乎全是云和云的光柱,而且它们是平滑的、只随方向或世界位置变。(之前的消融把雾的 3.7 ms 记在了天空头上,因为关云会同时关掉云光柱。)
做法:云层(colour * T + L 的映射)、地面上的云影、雾里太阳穿过雾的光(体积光)各自在半分辨率的 pass 里算,全分辨率的合成 pass 用双线性权重乘以深度近度(云影与雾按世界点/射线长度的近度加权,天空按有无天空纹素)读回;读不到的像素(天际线缝隙)天空与云影回到逐像素的原算法,雾不回退(平滑权重总有答案——一个叶缘像素回退会让整个 warp 都走一遍循环,第一版就是这样没省到)。
| 机位 | 之前整图 | 之后整图 | 天空 | 雾 |
|---|---|---|---|---|
| 0 | 25.6 | 20.1 | 4.1 → 0.8 + 1.5 | 4.9 → 1.25 + 1.3 |
| 1 | 35.3 | 29.9 | 天空 1.1 + 1.5 | 雾 1.3 + 1.3 |
| 3 | 38.7 | 33.4 | 天空 1.0 + 1.5 | 雾 1.3 + 1.3 |
画面:机位 0 与之前的截图逐像素比(排除两次运行本来就不同的部分),平均差 0.34/255,超过 24 的像素 0.05%,天际线和树缘放大看不出光晕。两个后端:GLSL 与 WGSL 都有,sky-fog 渲染场景在 WebGL2 与 WebGPU 上读出同样的颜色。**没有量的:**手机(半分辨率的 pass 在分块 GPU 上多一次读写),夜晚与阴天的云。
scene pass 里面是什么(2026-10-26)
--detail(加上 --passes):剖析器打开时,scene pass 按“同一个着色器的一串绘制”切成段,每段一个计时查询(scene/<着色器名>,预通道是 scene/prepass:<着色器名>)。只在 WebGL2 上(WebGPU 的时间戳按整个 pass 挂,不能切);页面里用 module.esGpuDetail = true 打开,harness 的 --detail 做这件事。
默认机位(scene 共 9.3 ms):
| 段 | ms | 说明 |
|---|---|---|
| scene/Model | 5.4 | 所有植物(树、灌木、草、花、石头、芦苇),用的是同一个 Model 着色器 |
| scene/Terrain Layers | 3.2 | 地形四层混合 |
| scene/prepass:Model + Terrain | 0.67 | 深度预通道 |
| scene-glass/Water | 2.8 | 水面(不在 scene 里,在 scene-glass) |
重机位(机位 1,整图 28.4):Model 12.3、预通道 1.85、地形 1.9、阴影图 4.1、水 1.4。机位 3:Model 13.6、预通道 1.4、地形 2.9、阴影图 4.2、水 3.0。植物(Model 加它的预通道和阴影)是重机位的一半以上,地形反而是 2 到 3 ms 的固定块。
拿掉一样东西之后,各段的变化(机位 1,Model 段):
| 变化 | Model | 说明 |
|---|---|---|
| 整个树丛层(groves)拿掉 | 12.3 → 6.9 | 树本身 5.4,加预通道 1.2、阴影图 3.0:树合计约 9.6 ms,整图的三分之一 |
| 4× MSAA → 1× | 12.3 → 7.6(−4.7);机位 3 13.6 → 7.6(−6.0) | 植物的边缘像素多,多重采样把每个边缘像素着色最多 4 次 |
| 阴影不接收 | 12.3 → 10.0(−2.3);机位 3 −2.7 | 植物着色里的阴影查找 |
| 只拿掉一个配方(grove-oak、grove-birch…) | 每个只少 0.1 到 0.9 | 加起来远小于整层:拿掉一种,另一种照样盖住那些像素。所以成本是被覆盖的像素数乘每像素的着色成本,不是实例数 |
其他读数:
- 水 2.8 ms,关掉阴影后降到 1.4(机位 0)和 0.18(机位 1):水面着色器自己在做阴影查找,是水的主要成本,不是波浪或折射。
- 地形 3.2 ms(机位 0)里阴影接收约 0.5,MSAA 约 0.5;其余是四层混合本身。
- 单个植物配方拿掉后阴影图最多少 1.1 ms(grove-oak),
undergrowth少 1.0:低矮植物也投影。 - 这些读数与消融一致:树的叶片卡片(镂空、阴影接收、4× MSAA 边缘像素)是 scene pass 的最大一块;没有哪一个“着色器阶段”是主要成本,是三者相乘(像素数 × 阴影查找 × 多重采样)。
没有量的:植物着色器里每个阶段(光照、阴影、风、透射)各占多少——要做就像之前量阴影接收那样,剪一个着色器重编一次;顶点阶段(三角形数 0.75M 到 2M)的成本也没有单独量。
植物着色器(Model)里各阶段占多少(2026-10-26)
方法:把 Model 着色器(SDK 里的 builtinShaders.ts)或光照函数(ShaderParser.cpp)里的一个阶段剪掉,各导出一个包,在同一机位用 --detail 比较 scene/Model 一段。机位 1(Model 段 12.27 ms,output/model-variants.mjs):
| 剪掉 | Model 段 | 这一阶段的成本 |
|---|---|---|
| 一切(只剩底色贴图、镂空测试、光栅与多重采样) | 3.01 | 下限 3.0(25%) |
| 整个灯循环 | 4.48 | 灯循环 7.8(64%) |
| 其中阴影接收 | 7.82 | 阴影接收 4.45,其余灯循环(空槽的光照数学)3.3 |
| 环境反射 | 11.81 | 0.46 |
| 法线贴图与切线、镜面抗锯齿 | 11.88 | 0.39 |
| 遮挡、金属粗糙度、自发光三张贴图 | 11.98 | 0.29 |
| 环境光 | 12.44 | 0 |
默认机位(Model 5.64):下限 1.08、灯循环 3.95(阴影接收 2.25)、环境 0.58。风、透射、半透明都不在 Model 里:风是顶点里的另一个着色器,透射与半透明在这里是 uniform 分支,植物的材质不开,成本为 0。
**意外的一块:3.3 ms 是空灯槽。**灯块有 16 个槽,场景只有一个太阳,但灯循环对 16 个槽都做一遍:距离、方向、整个高光叶(GGX、菲涅尔)都算,只是乘以 0 强度加零。一个强度为 0 的槽现在直接返回(GLSL 与 WGSL 一份),结果逐位相同:
| 机位 | 之前 Model 段 | 之后 | 整图 |
|---|---|---|---|
| 1 | 12.27 | 7.07 | 28.2 → 22.3 |
| 0 | 5.64 | 3.21 | 18.9 → 14.8 |
比“少算 3.3 ms 的数学”省得更多(机位 1 少了 5.2 ms),因为着色器变短后占用率也上来了。画面与之前逐像素比,平均差 0.09/255。这条对每个有光照的网格都成立,不只这个示例。
水面的阴影(2026-10-26,更正)
上一节说“水的主要成本是它自己的阴影查找”,这个说法错了。水着色器里自己的那一次阴影采样(焦散处)和焦散本身都量了:剪掉后水段不变(1.18 对 1.18、2.15 对 2.13)。关掉阴影后水变便宜,是因为水面用 applyLightingSurface 打光,太阳的软阴影(16 个找遮挡点的采样加最多 64 个滤波采样)是在那里面。海面几乎不在阴影里、边缘又被波浪盖住,所以现在水着色器在打光前设 g_shadowHard = 1,阴影按“没有大小的光源”读成 9 个采样的硬边:水段 2.16 → 1.68(机位 0)、2.28 → 1.71(机位 3),画面平均差 0.24/255 和 0.54/255,放大看海面上的云影还在。g_shadowHard 和 g_hairShadow 一样是着色器在打光前设的一个全局,别的着色器也可以用。
太阳阴影图只画照得到相机的投射体(2026-10-26)
示例的太阳有固定的 shadowExtent,所以画的是一张覆盖整个岛的图,图的内容和相机无关,但画进图里的投射体原来是图范围里的全部(再按到相机的距离砍一次)。一个投射体的影子是它的包围球沿光线扫到最低接收面的一段;这段在相机视锥之外,就不会遮住相机看得到的任何东西,不必画进图。(CollectContext::castsIntoView,用 Frustum::intersectsSweptSphere 判,只对有固定范围的太阳,有平面反射时不做,没有场景包围盒时不做。)
| 机位 | 阴影 pass 之前 | 之后 | 阴影绘制数 | 整图 |
|---|---|---|---|---|
| 1 | 4.04 | 1.69 | 1223 → 609 | 23.6 → 21.1 |
| 2 | 4.69 | 1.42 | 1302 → 447 | 26.5 → 23.3 |
| 3(相机在岛上空,看得到整个岛) | 4.69 | 4.51 | 1302 → 1177 | 不变 |
| 0 | 0.42 | 0.36 | 432 → 385 | 不变 |
画面与之前逐像素比(排除运行间本来就不同的部分):平均差 0.03 到 0.39/255,差超过 24 的像素为 0。mesh-shadow-cull 渲染场景在两个后端上钉住两件事:相机身后的投射体仍然给前面的地面投影,一个在图里但影子落在视野外的被画少一个(render.shadow.castersCulled = 1)。
**没做的:缓存。**图的内容随相机变(植物只在相机的绘制距离内有),缓存一张整图要么常常失效,要么要像虚拟阴影图那样分页;这次的剔除是不改变任何像素的那一半,先拿了。**另一个发现(已查清并修了,见下一节):**固定范围过大时小投射体的影子消失。
固定范围过大时小投射体的影子消失(2026-10-26,查清并修了)
**现象:**同一个场景(一块 60 单位宽的投射体在相机身后给前面的地面投影),shadowExtent 1500 和 3000 时影子正常,4000 时影子变成斑点,8000 时整个没有;把投射体放大到 200 单位,8000 时又正常。
**原因:**不是图的分辨率不够,也不是偏置或深度精度。软阴影先在 24 个纹素半径的圆盘里找遮挡点(kShadowDisc),只用 16 个采样,而且这些采样按半径的平方根分布,离这一点 4 个纹素以内一个采样也没有,采样之间相隔约 12 个纹素。一个窄于这个间隔的投射体,即使正好站在这一点上方,也大概率一个采样都碰不到,hits < 0.5 就当成“没有遮挡”,返回全亮。纹素越大(范围越大)投射体占的纹素越少,所以随范围增大先变成斑点再消失。示例的太阳范围是 16000(纹素约 31 个世界单位),灌木、石头、花的影子就是这样没有的。
**修:**先问这一点自己的纹素和它周围一步半的四个纹素(5 个采样),结果和后面 16 个一样进遮挡平均,hits > 20.5 才算在影子里面。两个后端都改了。
| 修之前 | 修之后 | |
|---|---|---|
| 范围 8000,60 单位投射体 | 没有影子 | 有,边缘干净 |
| 范围 4000 | 斑点 | 实心 |
| 示例 Model 段(机位 1 / 3) | 6.72 / 6.69 ms | 7.13 / 6.86 ms(多 0.2 到 0.4) |
| 画面平均差 | 0.27 / 1.12 / 1.42(机位 1 / 0 / 3),差超过 24 的像素 0.1% 到 0.3%:灌木、石头、箱子的影子出现了 |
mesh-shadow-small 渲染场景在两个后端上钉住它(范围 8000,60 单位投射体的影子必须在)。18 个阴影与光照场景在两个后端都通过。
Web:着色器首次编译(2026-10-26)
node tools/shader-compile-cost.mjs [--dir 包] [--async]:包上的 WebGL 调用都被计时,浏览器的着色器缓存关掉(等于第一次访问)。示例在 Chrome、D3D11 上:
| 同步(原来) | asyncShaderCompile 开 |
|
|---|---|---|
| 页面被编译卡住的总时长 | 42.6 s | 约 1 s |
| 最长的一帧 | 10.0 s | 1.1 s |
| 场景画全的时刻(页面时间) | 55.8 s | 20.1 s |
- **链接才是慢的地方,不是编译。**一个 50 到 73 KB 片元的光照着色器,
COMPILE_STATUS几毫秒,LINK_STATUS3 到 10 秒(ANGLE 在链接时才把 GLSL 翻成 HLSL 再交给 D3D 编译)。示例首次访问共 39 个程序。 - **并行是真的。**把同一个 3.2 秒的程序复制 6 份:一份份等是 19.2 s,全部发出去再等是 5.1 s,发出去只要 1 ms,轮询
COMPLETION_STATUS_KHR期间页面一直在响应(1100 次定时器)。机器 20 个核。 - 只做"延迟链接"不够。材质变体是一帧一个、创建完马上要画的,没有重叠(43.5 s 对 49.8 s);要让帧别等:没好的程序,画它的绘制先跳过(
GfxDevice::setSkipPendingPrograms)。材质着色器、后处理着色器、默认网格着色器、网格变体都是排队创建,第一个要用的才等(GfxShaderSource::deferLink、Shader::whenLinked)。 - **试过没用的:**把阴影采样改成
textureLod(想让 ANGLE 不展开循环)——编译反而慢了一个数量级(单个程序 37 到 82 s),已还原。哪些代码贡献最多(剪掉实验):阴影接收约 60%(10.9 s → 4.4 s),地形 8 层混合循环约 55%(10.9 → 5.0 s);灯循环只占一成多。减小这些着色器本身还能再省,没做。 - 选项默认关,和动态分辨率一样是显式开启:开了以后第一次看到的画面会有东西"长出来"。编辑器里在项目设置 → 渲染 → "着色器编译"(后台编译、启动页预热、预热超时);画质档位为"关闭"时同样生效——打包时只要其中任何一项开着,
quality块就会随游戏发出。 - 预热:
quality.prewarmShaders(配asyncShaderCompile)在启动页后面把第一个场景画到没有着色器在编译为止再打开(warmShaders(app),上限prewarmTimeoutMs,默认 30 s),打开时是完整画面。预备好的场景(readyRenderPrograms)也等编译队列清空才报告就绪。 - **编译成本再削:**平铺光源没有阴影图,
shadeLight加了shadow3D参数,平铺那处调用传false,编译器把那份拷贝里的阴影滤波整段丢掉:受光着色器首次链接合计 −23%(模型着色器约 −40%),运行时无变化。把循环合并成动态循环能再省 40% 编译,但模型段多 ~1 ms,没要。 - 三种方式在示例包上的实测(Chrome、D3D11,关掉着色器磁盘缓存,首次访问,1280x720,像玩家一样直接打开,
output/prewarm-probe.mjs的做法):同步:19.8 s 才出画面,之后 25 s 里最长一帧 9.1 s,16 帧超 50 ms;asyncShaderCompile:2.4 s 出画面,画面逐步长全,40 帧超 50 ms、最长 513 ms;asyncShaderCompile+prewarmShaders:启动页停到 20.0 s(同步的等待时间,但页面一直在响应、启动页进度在走),打开即完整画面,之后 25 s 里 0 帧超 50 ms,最长 22.9 ms。