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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs(perf): where the shadow receiver's cost is, and two ways of cutting it that did not
yhhc20a879d3ed5
diff --git a/docs/TERRAIN_WATER_GPU_COST.md b/docs/TERRAIN_WATER_GPU_COST.mdindex 84e5bf27f..140a624d1 100644--- a/docs/TERRAIN_WATER_GPU_COST.md+++ b/docs/TERRAIN_WATER_GPU_COST.md@@ -190,3 +190,29 @@- 这个场景的后处理链没有任何效果会要求场景写第二个表面附件(`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):绝大多数片元是亮的,搜索里一个遮挡物也没找到就返回了。++**试了两个改法,都没有留:**++1. **光照在表面背面的片元跳过阴影查找。** 精确的(漫反射、镜面、光泽都乘 N·L;只有头发、涂层、散射表面读背面的光,这几种仍然查)。前后对比三个机位:30.8 → 31.0、42.9 → 43.3、46.7 → 46.1 ms,在噪声里,没有收益。+2. **遮挡物搜索先用 4 个分散的采样,一个遮挡物都没有就当作亮的,不读另外 12 个。** 反而慢了:+1.2、+1.2、+2.3 ms(分两段循环、分支发散的代价大于省下的采样),也会漏掉小遮挡物(叶片阴影的斑点)。++加上前面的结果(把太阳设成没有大小、走 9 个采样的硬边路径并不更便宜):**这个函数的成本不随采样数线性走**,少读几个采样不是杠杆;所以镂空叶片的每次着色在阴影接收上没有可以不改画面就拿走的东西。要再省,方向只剩着色次数(多重采样和镂空卡片的边缘像素)和阴影本身的范围(`shadowDistance`、级联数)。++另:构建会重新生成并被 git 跟踪的 `ShaderEmbeds.generated.hpp`,预通道那次提交没有带上它的更新(原生构建读它),这次补上。diff --git a/src/esengine/renderer/rhi/ShaderEmbeds.generated.hpp b/src/esengine/renderer/rhi/ShaderEmbeds.generated.hppindex bb05860c7..61beca1c4 100644--- a/src/esengine/renderer/rhi/ShaderEmbeds.generated.hpp+++ b/src/esengine/renderer/rhi/ShaderEmbeds.generated.hpp@@ -568,6 +568,10 @@ inline constexpr const char* MESH = R"esshader(#pragma shader "Mesh"+#pragma feature PREPASS_COVERAGE+++@@ -640,6 +644,10 @@ void applyMorph(inout vec3 position, inout vec3 normal) {}}+++invariant gl_Position;+out vec2 v_texCoord;out vec4 v_color;#ifdef MESH_LIGHTMAP@@ -843,6 +851,14 @@ void main() {highp vec2 was = v_velPrev.xy / max(v_velPrev.w, 1e-6);fragColor = vec4((was - now) * 0.5, gl_FragCoord.z, v_velPrev.w > 1e-6 ? 1.0 : 0.0);#elif defined(SHADOW_DEPTH)+#ifdef PREPASS_COVERAGE+++ highp float baseAlpha = texture(u_texture, v_texCoord).a * v_color.a * u_tint.a;+ highp float coverage = (baseAlpha - u_alphaCutoff) / max(fwidth(baseAlpha), 1e-4) + 0.5;+ if (coverage <= 0.0) discard;+ fragColor = vec4(0.0, 0.0, 0.0, min(coverage, 1.0));+#else#ifdef SHADOW_ALPHA@@ -853,6 +869,7 @@ void main() {fragColor = vec4(packDepth(clamp(v_shadowClip.z / v_shadowClip.w * 0.5 + 0.5,0.0, 1.0)), 1.0);+#endif#elsevec4 base = texture(u_texture, v_texCoord) * v_color;#ifdef LIT@@ -928,7 +945,7 @@ struct VSIn {@builtin(vertex_index) vertexIndex : u32,};struct VSOut {- @builtin(position) pos : vec4f,+ @builtin(position) @invariant pos : vec4f,@location(0) v_texCoord : vec2f,@location(1) v_color : vec4f,#ifdef LIT@@ -1173,6 +1190,16 @@ fn packNormal(n : vec3f) -> vec2f {let was = v.v_velPrev.xy / max(v.v_velPrev.w, 1e-6);return vec4f((was - now) * 0.5, v.pos.z, select(0.0, 1.0, v.v_velPrev.w > 1e-6));#elif defined(SHADOW_DEPTH)+#ifdef PREPASS_COVERAGE++ let duvx = dpdx(v.v_texCoord);+ let duvy = dpdy(v.v_texCoord);+ let baseAlpha = textureSampleGrad(t0, s0, v.v_texCoord, duvx, duvy).a * v.v_color.a * mc.u_tint.a;+ let edge = max(fwidth(baseAlpha), 1e-4);+ let coverage = (baseAlpha - mc.u_alphaCutoff) / max(edge, 1e-4) + 0.5;+ if (coverage <= 0.0) { discard; }+ return vec4f(0.0, 0.0, 0.0, min(coverage, 1.0));+#else#ifdef SHADOW_ALPHAlet duvx = dpdx(v.v_texCoord);@@ -1184,6 +1211,7 @@ fn packNormal(n : vec3f) -> vec2f {return vec4f(packDepth(clamp(v.v_shadowClip.z / v.v_shadowClip.w * 0.5 + 0.5,0.0, 1.0)), 1.0);+#endif#else