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.
动态全局光照设计(Lumen 式,方案 B)
状态:设计稿,未开始实现。写于 2026-11-11。第 1 节是已核对的现状和实测基线,第 2 节起是设计。
1. 现状与基线(已核对)
已有
- 烘焙:光照贴图(
tools/lightmap-wasm/kernel.cpp,BakedLighting反弹和采样可调)和光探针体(LightProbeVolume,renderer/store/ProbeStore.hpp,9 个球谐系数)。静态场景正确,不漏光。 - 运行时:
voxelGI后效(renderer/frame/VoxelGI.cpp,约 800 行,四个 compute 通道:维护、注入、聚集、应用)。体素缓存 128×64×128、随相机移动、环形寻址;光源只有屏幕上的画面和太阳阴影图,聚集用 DDA 在体素里走光线。需要 compute, 即 WebGPU;WebGL2、小游戏没有。
没有:距离场、网格 BVH、表面缓存(card)、屏幕探针、世界空间辐射缓存。引擎里搜不到任何一项。
实测基线(tools/render-lab/gi_oracle.py,Cycles 12 次反弹为准,表中是引擎占 Cycles 光量的比例)
| 场景 | 烘焙 | 体素 GI |
|---|---|---|
gi_room 阴影区 |
0.75–1.00 | 0.10–1.70(遮挡面只有 0.1) |
gi_away 镜头外的墙 |
0.75–1.00 | 0.31–0.52 |
gi_emissive 自发光房间 |
0(烘焙器没有自发光) | 0.07–0.61 |
gi_leak 密闭房间(Cycles 为 0) |
0 | 约 0.005,体素 8 cm 时为 0 |
漏光来源已定位:太阳注入(u_sunAlbedo=0 时恰好为 0),不是光线穿墙。试过的三个局部修补都没改变读数
(见记忆 oracle-render-scenes.md)。根因是缓存里没有几何:缓存只知道“相机见过的表面在哪个体素”,
不知道墙有多厚、墙后是什么。方案 B 就是补上几何。
2. 目标与不做什么
目标(以 gi_oracle.py 的带为验收,见第 7 节):
- 密闭房间不漏光(与 Cycles 一样为 0)。
- 镜头外的表面照样发出和接收间接光(
gi_away占比 ≥ 0.8)。 - 自发光表面照亮周围(
gi_emissive≥ 0.8)。 - 遮挡面的反弹占比 ≥ 0.7(现在 0.1)。
- 动态物体、动态太阳、动态灯即时生效,无需烘焙。
不做:
- 镜面全局反射与折射的追踪(第 2 期之后再评估,现有 SSR 和反射探针继续负责)。
- WebGL2、小游戏上的动态 GI。这些设备继续用烘焙贴图和探针;新方案同样要求 compute。
- 任意网格的实时硬件光追。
3. 总体管线
仿 Lumen 的四层,按 WebGPU compute 裁剪:
网格距离场(离线烘)──▶ 全局距离场(相机跟随的 3 级 clipmap)
│ 光线求交 / 遮挡
表面缓存(card 图集)◀──────────┤ 命中点取光
直接光 + 太阳阴影 + 自发光 + 上一帧间接光(多次反弹)
▲
屏幕探针(每 8×8 像素一个,八面体辐射)──▶ 滤波 ──▶ 应用到画面
光线先走屏幕空间(HZB),再走全局距离场,最后落到世界辐射缓存
世界辐射缓存(相机周围 clipmap 探针)──▶ 远处与未命中
3.1 网格距离场
- 每个静态网格资源在导入时(pipeline,不在运行时)烘一张带符号距离体,分辨率按包围盒长边约 0.1 m 一格,上限 64³,单通道
fp16,和网格同生命周期(
.esmeshsdf旁路资源,进缓存预算,见docs/CACHE_BUDGET.md)。 - 地形用高度场单独表达(已有
sampleHeight),不烘体。 - 动态网格(蒙皮)不入距离场,只作为 card 的光接收者与屏幕空间追踪的遮挡者(第 5 节取舍)。
- 薄墙:导入时 SDF 取无符号距离减半厚,保证 10 cm 墙在 0.1 m 格下仍有负值内部;这正是体素缓存做不到的。
3.2 全局距离场
- 3 级 clipmap(例如 6 m / 24 m / 96 m,各 128³ 的 fp16 = 4 MB 一级),每级随相机按整格平移。
- 每帧只更新变脏的区域:对象变换变化或进出窗口时,把覆盖该区域的网格 SDF 按
min合成进去(compute,按 tile 分派)。 - 查询接口两种:
sphereTrace(origin, dir, maxT)和occlusion(origin, target);统一放一个 WGSL 公共片段。
3.3 表面缓存
- 每个网格资源生成 6 个轴向 card(±x ±y ±z 正交投影),每张 card 在导入时烘:反照率、法线、自发光、深度(8 位到 16 位)。 存成静态图集;运行时只增量刷新光照。
- 运行时每张 card 一张
radiance图集,分配器按屏幕占用和距离给 card 分配分辨率(类似 mip 流送)。每帧只刷新一小部分 card:直接光(平行光带现有阴影图、点光/聚光带现有阴影) + 自发光 + 上一帧间接光 × 反照率。 最后一项让缓存逐帧收敛到多次反弹,和现在体素缓存的做法一致,但存在 card 上而不是模糊的体素里。 - 命中点取光:根据命中点法线选最多 3 个 card,按法线权重混合,深度测试去除背面。
3.4 屏幕探针
- 画面每 8×8 像素放一个探针(自适应:边缘和高频处补加密探针)。每个探针每帧发 64 条光线(八面体 8×8),重要性按上一帧亮度和 BRDF cos 加权。
- 每条光线:先在屏幕空间用 HZB 走几步(命中就取画面色,和 SSR 共用 HZB);未命中则走全局距离场到命中点,取表面缓存; 仍未命中(超出距离场范围或离开 clipmap)则读世界辐射缓存;最后读天空。
- 结果写进探针的八面体图集,再做时间累积(速度重投影)与空间滤波,转成每像素的漫反射间接光(法线加权,深度加权)。
3.5 世界辐射缓存
- 相机周围 clipmap 的探针网格(例如 4 级,各 32³ 个探针,间距 0.5 m 起,每级翻倍),每个探针存低分辨率八面体辐射。
- 作用:屏幕外光源(这就解决
gi_away)、远处光线的终点、屏幕探针的光线预算不足时的平滑后备。 - 更新:每帧更新一部分探针,射线同样走全局距离场和表面缓存。
4. 与现有系统的关系
| 现有 | 处理 |
|---|---|
voxelGI 后效 |
保留作 WebGPU 低配后备和过渡;新方案作为新后效 dynamicGI(分组 esengine/fx-gi,按用才打进包,见 AgX 的拆法)。两者互斥。 |
| 烘焙光照贴图/探针 | 不变。静态烘焙优先:被烘焙的表面不再接收动态间接光,避免重复计算。 |
阴影图(kSun 读回) |
表面缓存直接复用阴影图算直接光,不再把阴影图读回写进体素(漏光源头消失)。 |
| SSR、SSAO、GTAO | 继续存在;HZB 共用。GTAO 仍负责接触阴影,GI 管大尺度。 |
ReflectionProbe |
不变,镜面部分仍由它负责。 |
5. 取舍
- 不做硬件光追:WebGPU 没有。距离场追踪换来的是:薄结构精度差、小物体(< 1 格)丢失。接受,用屏幕空间追踪补细节。
- 动态物体不进距离场:蒙皮角色会没有间接遮挡,但仍接收间接光。后续可给角色加一个胶囊近似。
- card 内存:6 个 card/网格,按需流送;小网格(包围盒 < 0.5 m)不生成 card,只贡献距离场。
- 手机成本:现有体素聚集在手机(Adreno/Vulkan)上曾因聚集里的 atomic 读耗时 1 秒以上,后改为只读数组(见
VoxelGI.cpp注释)。新方案所有读都用只读数组;探针数量和光线数按QualityConfig.power缩放; 目标:桌面 1080p ≤ 3 ms,手机 720p ≤ 6 ms(未验证,第 6 节每期实测后再改)。
5.1 帧时间实测(2026-11-11)
node tools/gi/measure-gi-frame.mjs <web 目录>:无头 Chromium 跑在本机 GPU(NVIDIA Ampere 架构)上,用设备的 timestamp-query 给每个 compute 通道打时间戳,取 200 帧的中位数。场景是 lab 的房间(10 个盒子,约 4 万个 card 像素)。
| 阶段 | 起点(1280×720) | 现在 |
|---|---|---|
| 卡面光照 | 4.3 ms | 0.18 ms |
| 探针 | 4.2 ms | 2.2–2.7 ms |
| 应用 | 0.39 ms | 0.4 ms(720p)/ 0.9 ms(1080p) |
| 合计 | 8.9 ms | 2.8–3.5 ms(1080p 3.3 ms) |
起点到现在的改动,按收益排:
- 卡面一个工作组一个像素、64 个线程各追一条射线(共享内存规约),原来一个线程串行追 64 条,GPU 在等自己那条读取链:4.3→0.18 ms,是最大的一项。只要线程串行追射线,削减要更新的像素数几乎不省时间(16 倍分片仍是 3 ms)。
- 卡面分片:每帧只重新点亮 1/4,混合系数相应放大。
- 距离场里每个格子记下最近的实例(7 位 id,4 个一个字),命中点只查那一个实例的 card,不再遍历全部:每个通道省 0.9–1.5 ms,实例越多越值。
- 探针 2 条里追 1 条,交替,历史补另一半;探针数固定约 160×90,间距随画面高度走(720p 为 8 像素,1080p 为 12),探针成本不随分辨率涨。
- 远离表面时用一次读取代替三线性的 8 次读取:收益很小。
- 精度没变:
gi_oracle.py对 Cycles 的占比与改前一致。
没测的:手机(Adreno/Mali),更大的场景(实例多、距离场更大),以及更高分辨率下应用通道的 0.9 ms 往上的增长。
5.2 多级距离场与点光(2026-11-11)
- 多级 clipmap:后效参数
u_cellSize(世界单位,默认 0)。0 为原来的单窗口(整个场景放进一个 128³ 的场);大于 0 则是三级场,格子依次为 1×、4×、16×u_cellSize,各 128³,跟随相机(相机每走 8 个细格重新居中,只重建新进入的薄片,再整体上传)。着色器里光线走当前点所在的最细一级,走出这一级的窗口就交给下一级;命中点按所在级的格子放宽卡面容差。距离场合成里,离某个实例超过 reach 的格子直接跳过该实例,实验房间合成约 0.4 s。 对 Cycles(dgil:2.5 cm 细格,房间的后半部分只在粗级里):gi_room0.55–1.25、gi_away0.51–0.87、gi_leak室内 0,与单窗口一致。 - 点光和聚光:场景里最近相机的至多 8 盏,按引擎自己的衰减(
distanceFalloff:线性斜坡、反平方、内径,聚光的 smoothstep 锥)给卡面直接光,阴影也是穿过距离场的射线,到灯为止。CPU 参考在surfaceCache.ts(PointLight),对闭式值有 5 个测试;GPU 在lightsDirect。 验证:gi_point实验室(密闭房间,一盏 0.3 强度的灯)。Cycles 的点光是反平方的瓦特,单位对不上,所以参照是 CPU 求解器(与 Cycles 对过太阳的那个)。GPU 对 CPU 参照 0.89–1.06;dgim(网格版)和dgil(多级)同样通过。 - 聚光 GPU 已验证(2026-11-11,
gi_spot实验室):房间里一盏朝下的聚光(内角 25°、外角 50°,强度 0.5,线性衰减到 600),对 CPU 参照:锥内地面 0.99、半影 1.02、锥外(只有反弹)0.80–0.89,墙 1.2;网格版与多级版同样通过。注意半影区梯度陡,CPU 参照取的是 25 cm 的卡面像素,所以半影点选在卡面像素中心(x=98),不然读到的是两种采样的差而不是聚光。 - 没测:点光阴影在大场景、多级场相机移动时的重建与上传成本、手机。
- 帧时间:720p 约 3.6–3.8 ms(多级与一盏灯),比单窗口无灯多约 0.3 ms。
5.3 手机实测(2026-11-11,小米 24129PN74C,骁龙 8 Elite,2530×1200,原生 Dawn)
- 跑通:原生宿主走同一套 SDK 与引擎(
dynamicGISystem经原生堆把场景交给postprocess_setGIScene),手机上画面与电脑一致(色溢、光斑反弹)。系统里取引擎核心原来只认app.wasmModule,原生上为空、GI 整个没喂进去;现在经marshallingCore(app.wasmModule ?? nativeEngineApi())。 - 成本:不开 GI 的帧 7.7 ms,开默认 GI 28.2 ms,GI 约 20.5 ms(电脑 1080p 为 3.3 ms,差约 6 倍)。分解(帧 p50):默认 28.2;卡面分片拉满 26.8(卡面约 1.4 ms);探针每 8 条追 1 条 23.0(探针光线约 5 ms);两者都拉满仍有 22.9,即约 15 ms 与光线数无关。
- 把应用通道里每像素 16 次探针读取改成每探针只存一次位置与朝向(RGBA32F 两个纹素),并先只问最近 4 个,默认从 28.2 降到 23.7 ms(GI 约 16 ms),下限几乎没动(22.6):剩下的约 15 ms 不在探针读取上。
- 未查明:这 15 ms 在哪。候选:场景通道为 G-buffer 和反照率多写两个附件(这在 tile 型 GPU 上按带宽算很贵,体素 GI 也有);应用通道全分辨率读写 RGBA16F;探针通道的固定开销。已加
u_skip(1 卡面、2 探针、4 应用)用来逐项扣除,没有跑完:手机已经发烫,按用户的话停了。 - 发热:反复以不限帧率连续跑了几分钟,CPU 约 78–80 °C、电池 46.6 °C。之后的测量必须限时、限次,中间让手机降温。
5.3.1 那约 15 ms 的追查(2026-11-11,同一台手机,限时限次地跑)
已排除:
- 不是 JS 每帧在重建场景:系统每帧都在算盒子的距离场和卡面,手机上很贵。改成每帧只算一个键(
instanceKey),变了才建。帧时间没变,update(脚本)本来就只有 0.02 ms。这个改动仍然该做。 - 不是多重采样:关掉 MSAA 结果一样(23.7)。
- 不是后处理链本身:只开暗角 7.8 ms(与没有后效 7.7 相同)。
- G-buffer 约 +3 ms:只开 SSAO(同样要深度与 G-buffer)11.0 ms。
- 没喂场景时:开着
dynamicGI但场景里没有立方体(不上传),9.9 ms,与 SSAO 相当。
所以 一旦场景上传,帧时间从 9.9 跳到 23.5。其中卡面与探针的光线本身只占约 6.5 ms(分片拉满加探针步长拉满,23.5→22.6 之前的数是 23.0→22.6,见上表)。把 u_skip 接进后效(它原先没有声明,SDK 不会把它交给原生,所以先前所有 u_skip 的数都是没生效的“默认”,那几行 skip 数据无效)之后的逐项扣除没有跑完:跑到一半手机被拿起来用了(frames: paused),按用户的话停止。
下一步:手机降温、空闲时,按 u_skip = 8(场景已上传,什么都不声明)、3(只有应用)、16(只有卡面和探针,无应用通道)各跑一次,每次 16 s,中间间隔 30 s。
5.3.2 那约 15 ms 找到了(2026-11-11)
之前的 u_skip 没有声明、没传进原生,先前那几行扣除数无效;声明之后重跑(同一台手机,帧 p50,关掉 GI 是 7.7):
| 配置 | 帧 | 比上一行 |
|---|---|---|
| 开着 GI 但场景没喂 / 什么都不声明 | 9.4–9.9 | G-buffer 约 +2 |
| 只有应用通道 | 11.7 | +2.3 |
| 卡面 + 应用 | 12.5 | 卡面约 +0.8 |
| 探针 + 应用 | 22.6 | 探针约 +10.9 |
| 全部(默认) | 23.3 |
探针占了大头,而且不随光线数线性走:每 8 条追 1 条(光线减到 1/4)只省 3.7 ms,探针间距 14→28(探针数 1/4)省 8 ms。拆开是约 4.9 ms 随光线数、约 5.9 ms 随探针数(每探针一个 64 线程的工作组加两次共享内存归约,固定开销在手机上很大)。
改动:
- 安卓上探针行数取 45(1200 高时间距 28)而不是 90,探针数为桌面的 1/4;
u_probeSpacing可手动指定。手机上 GI 从 20.5 ms 降到 约 6.4 ms(帧 14.1,关 GI 为 7.7)。 - 间距变大后画面出现 28 像素的方块:原因不是噪点而是权重在探针集合切换处不连续(最近四个探针之外的、权重还有 0.375 的探针,在跨过 tile 边界时被突然丢掉)。改为最近四个用双线性权重(在 tile 远端恰为 0),只有这四个都不合用时(两面墙的夹角)才用 16 个探针的宽帐篷。方块消失,桌面对 Cycles 的占比不变。
5.5.1 首次建场分帧与按范围交接(2026-11-11)
- 首次建场分帧:新场景(以及任何盒子变化)现在造一个新的
GlobalSdf,盒子只放置(update(instance, true)),整个窗口排队(queueAll),每帧做 3 ms,做完才打包交出。两种模式(单窗口、跟随相机)走同一条路。手机上之前首次建场约 1 s 的停顿(JS 合成三级场)按这个办法拆进帧里。 - 按范围交接:新绑定
postprocess_updateGIField(header, sdfOffset, count),相机移动后只送重建过的级别(通常只有最细一级,10 MB,不是 30 MB),引擎只上传那一段显存。更重要的是:整场交接会把所有卡面的光清零并从第一次反弹重新开始,相机每走一步卡面光照就“回弹”一次;按范围交接不碰卡面,不再回弹。光变化而场没变时只送头部。 - 电脑:相机来回走 12 秒,最坏帧 17.0 ms,无超过 50 ms 的帧;交接 3.4 ms 中位(复制本身便宜,收益主要是不再重置卡面)。手机上这一版还没测(手机锁屏进入休眠,按设计不去绕过)。
5.4 成本断言(2026-11-11)
node tools/gi/check-gi-cost.mjs(门禁 gi-cost,本地范围)。一帧的成本是“工作量 × 设备上每份工作的代价”,第二个因子是设备的(同一份工作,RTX 3 ms,手机 20 ms),第一个因子是引擎的,在 DynamicGI 派发通道的地方计数(DynamicGIStats,经 postprocess_giStats 读回,页面里是 window.__estellaGIStats()),两边一样,所以在 GPU 快得看不出差别的机器上也能拦住回归。
断言(实验房间,默认设置,720p 与 1080p 各跑一次):
- 探针数约 160×90(12000–17000),不随画面分辨率增长;探针每帧光线数 = 探针数 × 64 / 步长;720p 每像素探针光线 ≤ 0.6。
- 卡面每帧重新点亮的只是一片(≤ 总数的 0.3)。
- 应用通道每像素的纹理读取 ≤ 25;并且门禁数内核文本里的
textureLoad与引擎报的数比对,二者不一致就失败(给内核加一次读取而不改统计,会在这里红;已用变异验证:加一次读取,报“引擎报 24,内核是 28”)。 - 开着这个后效而被迫由场景通道多写的字节(G-buffer 8 + 反照率 4)≤ 12 B/像素;常驻显存 ≤ 64 MB(现为 11.2 MB)。
当前读数:14400 个探针,460,800 条探针光线,卡面 920/3678 一片,每像素 24 次读取,12 B/像素强加给场景通道。
它不能说明的:绝对毫秒。手机上约 15 ms 与光线数无关,那一块是带宽和附件,这里只能管住“被迫多写多少字节”和“每像素读几次”,不能说多少毫秒;每个通道的时间仍要在手机上量。
5.5 相机移动的成本(2026-11-11)
node tools/gi/measure-camera-move.mjs:导出带相机来回走动脚本的实验室(CAM_MOVE=1),三级场(u_cellSize 2.5),无头跑在本机 GPU 上,读页面的帧间隔与系统自己记的每次重建的耗时。相机每走 8 个细格(20 单位)重建一次。
| 重建一次(桌面,中位 / 最坏) | 12 秒内帧 | |
|---|---|---|
| 起点 | 49 / 70 ms(盒子 6 + 场 15 + 打包 23 + 交接 4) | 5 帧超过 50 ms,最坏 67 ms |
| 盒子只在场景变化时建 | ||
| 只重打包变了的级别、属主字直接在场里维护 | 20 / 38 ms | 0 帧超过 50 ms,最坏 33 ms |
| 按实例遍历周围的格子(而不是逐格问所有实例) | 17 / 33 ms | |
| 新进入的薄片排队,每帧做 3 ms,做完再一次打包交出 | 一次性部分约 6 ms(打包 2 + 交接 4) | 最坏帧 16.9 ms,无卡顿 |
- 排队期间引擎追踪的是上一次交出的场(窗口落后相机一点,别无坏处);
GlobalSdf.setCenter(p, true)排队,step(ms)做,pending为假时才打包,所以不会读到环形寻址里远端旧内容。 - 手机(同一台,移动相机的实验室):帧 p50 15.1、p90 17.6 ms;系统的重建工作每次 47–73 ms,分摊在帧里;第一次建场约 1 s(JS 在手机上合成三级场),是加载时的一次停顿。
- 还要做:交接的 30 MB 复制与上传(桌面 4–8 ms,手机上更多)可以只送变了的级别;第一次建场可以分帧。
6. 分期
每期独立可验收、可回退,期间旧 voxelGI 一直可用。
| 期 | 内容 | 验收 |
|---|---|---|
| P0 | 网格 SDF 烘焙 + .esmeshsdf 资源类型与加载器 + 全局距离场 clipmap + 公共 WGSL 追踪 |
球、盒、薄墙的距离和追踪与闭式解比对;WGSL 追踪由 tools/gi/check-sdf-wgsl.mjs 在无头 WebGPU 上校验。已落地(2026-11-11):pipeline/src/assets/meshSdf.ts、MeshSdfAssetLoader、sdk/src/gi/globalSdf.ts;导入设置 dynamicGI(默认关)。未做:clipmap 接到渲染帧的网格实例、上传 GPU 存储缓冲、编辑器导入开关 |
| P1 | 表面缓存:card 烘焙、直接光 + 自发光、命中点取光 | 卡面亮度与 Lambert 闭式值一致,SDF 遮挡产生阴影,自发光出现在命中点取光里。CPU 参考已落地(2026-11-11):pipeline/src/assets/meshCards.ts(.esmeshcards,6 个轴向 card)、MeshCardsAssetLoader、sdk/src/gi/surfaceCache.ts(light、lookup)、pipeline/tests/surface-cache.test.ts。未做:基色贴图不读(只用材质基色与顶点色)、图集分配、GPU 刷新通道 |
| P2 | 屏幕探针 + SDF 追踪 + 时间/空间滤波,单次反弹 | gi_leak 为 0;gi_room 阴影区 0.6–1.1。CPU 参考已落地并对 Cycles 验证(2026-11-11):sdk/src/gi/screenProbes.ts(8×8 八面体探针、半球积分、多次反弹迭代),pipeline/tests/gi-lab.test.ts。实测:gi_leak 室内最亮 0(体素 GI 为 0.005);gi_room 与 gi_away 为 Cycles 的 0.46–1.89 倍,屏幕内外一致(体素 GI 是 0.1–1.7 与 0.31–0.52)。未做:GPU 通道(探针追踪/插值到像素/时间滤波)、渲染帧实例接入;精度偏差(天花板 1.9、侧墙 0.5)主要来自 25 cm 的 card 和每探针 64 条光线 |
| P3 | 表面缓存吃上一帧间接光(多次反弹)+ 世界辐射缓存 | gi_room 0.8–1.1;gi_away ≥ 0.8;gi_emissive ≥ 0.8 |
| P4 | 成本:自适应探针、光线预算、QualityConfig 档位、手机与桌面实测 | 帧时间达标;gate 内加成本断言(同阴影通道做法) |
| P5 | 编辑器:设置面板、调试视图(SDF、card、探针)、文档;esengine/fx-gi 分组与包体 |
编辑器检查;包体断言 |
P0、P1 之间没有依赖,可并行;P2 依赖两者。
7. 验证方式
- 所有新带加进
gi_oracle.py的BANDS,并按它的约定:带是方法当前的精度,变差则失败,变好则提示收紧。 - 几何层(P0)用
tools/oracle的闭式场景:SDF 值是公式,不需要 Blender。 - 每期完成后重跑基线表,把表更新进本文第 1 节。
- 变异检验:关掉 SDF 遮挡,
gi_leak必须重新变红;关掉世界缓存,gi_away必须掉出带。
8. 风险
- 距离场精度:薄墙、尖角、细柱在 0.1 m 格下会出错。缓解:导入时做保守化(薄结构向外膨胀半格),并提供按网格覆盖分辨率的选项。
- 更新成本:大场景 clipmap 脏区过大。缓解:分帧、限预算,静态物体只在加载时合成。
- 探针噪点与闪烁:Lumen 靠大量滤波才稳。缓解:先做固定 64 光线 + 时间累积,验证后再加自适应。
- 时间不确定:这是多轮工程(P0–P5 每期至少一轮)。P0 做完前不要对外承诺“Lumen 级”。
- WebGPU 兼容:存储纹理格式、
rg16float等需确认;记忆webgpu-depth-sampling的几个坑(可采样深度附件)同样会碰到 HZB。
9. 需要用户拍板的点
- P0 的 SDF 烘焙放在导入管线(推荐,运行时零成本),还是首次加载时运行时烘(省磁盘,首帧卡顿)?
- 动态物体第一版是否接受“只接收、不遮挡”?
- 新后效是否直接叫
dynamicGI并在稳定后取代voxelGI,还是两者长期并存?