Communitygithub.com

WebGL 电影级渲染引擎

在浏览器中实现电影画质实时渲染:全屏光线步进、TAA抗锯齿、动态分辨率、ACES色调映射,适用于黑洞、体积云等场景。

WebGL 电影级渲染引擎 是什么?

该技能提供了一个完整的 WebGL 电影级渲染管线,专为浏览器中的实时 3D 渲染而设计。它涵盖了从头构建一个高质量渲染器的所有关键步骤:使用 Halton 序列抖动的 TAA(时序抗锯齿)消除闪烁和锯齿,基于 Karis 平均的泛光特效,ACES 色调映射,以及动态分辨率缩放。技能文档深入解释了渲染管线的具体顺序(场景→TAA→升采样→泛光→合成),并给出了速度优化技巧,例如如何避免 Windows/ANGLE 下 D3D 编译陷阱(使用 uniform 变量控制循环)以及利用 KHR_parallel_shader_compile 并行着色器编译。此外,还包括了黑盒(Schwarzschild 度规)的 Verlet 积分光线步进,体积云的二次采样,3D 星场的 DDA 遍历,以及无缝多尺度世界的双坐标系统实现。参考实现在 `templates/event-horizon/js/blackhole.js` 中,约 1300 行,零依赖。该技能适用于 Claude Code、Cursor、Codex 等 AI 编码工具,也适用于 Three.js 用户移植高质量后处理效果。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/webgl-cinematic-engine

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

WebGL 电影级渲染引擎 是做什么的?

参考实现:templates/event-horizon/js/blackhole.js(约 1,300 行,零依赖)。 阅读它,复用它。以下管线已在桌面 GPU 和中等配置手机上验证。

1. 帧管线(严格保持此顺序)

  1. 场景渲染 → raw RGBA16F 渲染目标,使用动态内部分辨率(仅视口大小 — 绝不重新分配)。 在投影上应用亚像素 Halton(2,3) 抖动,8 帧循环。
  2. TAA 解析 → 历史缓冲乒乓。在色调映射空间中进行 3×3 邻域限制 (c/(1+luma)),混合 0.86 − motion*6,下限 0.3。在缩放变化或场景切换时重置历史。 消除星点闪烁、闪烁、阶梯效应,并允许使用 30–50 % 更少的采样。
  3. 升采样 到全画布分辨率,使用温和的 4 拍锐化 (0.08 + 0.35*(1−scale))。
  4. 泛光:6 级 Mip 链。首次降采样= 13 拍 CoD 滤波器,带 Karis 平均 + 软膝 阈值(约 1.6–1.8 HDR);升采样= 9 拍帐篷滤波器,累加。强度 0.05–0.08。绝不对 UI 应用泛光。
  5. 合成:微弱的色差(≤ 0.004 — 更大会模糊星星),曝光度 ~0.95–1.05,ACES fitted, Gamma,暗角 0.7–1.0,三角形颗粒噪点 0.025(也可抖动 8-bit 色带),可选淡入淡出。

当存在 EXT_color_buffer_float 时使用 RGBA16F 渲染目标,否则使用 RGBA8。使用全屏三角形,而非四边形。

2. 比任何事都重要的速度规则

  • Windows/ANGLE 编译陷阱:D3D 会展开循环并内联所有内容 → 链接时间 7 秒以上。 添加 uniform int uZero;(始终为 0)并将每个循环写为 for(int i=uZero; i<N; i++)。 经测量:黑洞着色器链接 7 秒 → 0.9 秒。
  • KHR_parallel_shader_compile:立即启动所有 linkProgram,使用 setTimeout 轮询 COMPLETION_STATUS_KHR(rAF 在隐藏标签页中会暂停),仅等待第一个屏幕所需的程序。在后台编译后续场景。
  • 烘焙不动的部分:仅方向性天空(星云、遥远星系、从内部看到的银河) → 在加载时一次烘焙为立方体贴图(384–768 像素/面)。逐像素 fbm 是 GPU 开销的第一大户。
  • 动态分辨率:每 0.6 秒测量平均帧毫秒数;>19.5 ms → 缩放 −0.06 并设置一个 上限(缩放−0.02)以避免振荡;<17.6 ms 持续 4 个窗口 → +0.04。范围 0.42–1.0。
  • 像素上限:桌面 maxPixels 3.2 MP,手机 1.0 MP;桌面 DPR 上限 1.5 / 手机 1.25。
  • JS 中无逐帧分配;帧循环中无布局读取(在大小调整时缓存偏移量)。
  • 在 visibilitychange 时暂停;处理 webglcontextlost (preventDefault) / restored (reload)。
  • 预热:在加载器后方渲染 2–3 帧第一场景,调用 gl.finish(),然后显示。

3. 光线步进配方

黑洞(史瓦西,rs = 1) — 使用速度 Verlet 算法积分光子路径: a = −1.5·h²·p/r⁵,h = |p × v|,步长 dt = clamp(0.075·r, 0.008, 2.6),第一步使用交错梯度噪声抖动。当 r < 1 时捕获;当 r > far 且向外移动时逃离。 薄盘:检测 y 符号变化,插值交点,从前到后 alpha 合成。 盘着色 → 参见 space-realism §黑洞。桌面 220 步,手机 150 步。

体积(星系、星云、云):与包围盒/球相交,使用二次间距 t = t0 + (t1−t0)·f²(近眼处密集) 进行 36(桌面)/ 24(手机)次采样,逐像素逐帧抖动;累加 col += T·emission·dt; T *= exp(−extinction·dt); 在 T < 0.02 时提前退出。TAA 将噪点转化为平滑渐变。

具有真实视差的 3D 星场:在网格单元中执行 3D-DDA(22 步),每个单元一个哈希星, 亮度 ∝ 1/t²(限制),高斯足迹 ≥ 0.75 像素,密度来自场景的质量分布。随缩放级别缩小单元大小,使星星始终流动。

分析物体(行星、环、卫星):sph() 光线-球体相交,环 = 平面命中 + 半径带, 通过对光源的第二条光线产生阴影。对于球体来说,比网格更便宜、更锐利。

4. 无缝多尺度世界(星系 → 行星,无切换)

Float32 无法在同一个坐标系中容纳“星系”和“行星”。使用共享一个相机朝向的两个帧: 星系单位和系统单位,K = 1e5。 使用 JS 双精度 计算两个眼睛位置:eyeS = (eyeG − sunG)·K。从 eyeG 渲染星系, 从 eyeS 渲染行星。在远处时,太阳是一个星状点,其通量遵循 (角半径/像素)² — 它自然变成可分辨的圆盘。进入星系内部后,将体积星系交叉淡化为真实全景(或烘焙立方体)。结果:一个不间断的 10⁸× 缩放。

5. 纹理

  • 等距柱状投影图使用 eqUV(n) = (0.5 + atan(n.z,n.x)/2π, 0.5 − asin(n.y)/π) 采样。
  • 无接缝:使用 textureLod 和基于像素足迹的分析 LOD (log2(texW·0.159·pixAng·t/R/μ) − 0.5),绝不使用带分支导数的 texture()。
  • 每帧从队列上传一个纹理(使用 createImageBitmap 在非主线程解码), 颜色使用 SRGB8_ALPHA8,数据(云、Alpha)使用 RGBA8,带 Mipmap + 8× 各向异性。
  • 在每个采样器上绑定一个 1×1 哑纹理,直到真实纹理到达(避免类型冲突错误)。
  • 基于照片的浮雕:有限差分反照率亮度 → 扰动法线(k≈5 岩石,≈1 气体)。

6. Three.js 移植(当用户坚持时)

相同规则:WebGLRenderer({antialias: false, powerPreference: 'high-performance'}), EffectComposer 配合 HalfFloat 目标,自有的 TAA 或 TAARenderPass,UnrealBloomPass (阈值 ≥ 1.5,强度 ≤ 0.6),OutputPass 配合 ACES。将全屏光线步进效果作为全屏三角形上的 ShaderMaterial 实现。不要在手机上混合 50 个网格和后处理效果。

7. 调试工具(发布时带,通过 ?debug 参数隐藏)

暴露 window.__engine。计时一个场景:渲染一次,gl.finish(),渲染 ×4,readPixels 1 像素以强制同步,然后除法。通过针对渲染目标执行 readPixels(FLOAT) 探查 NaN —— 一个 NaN 像素 会通过泛光扩散并使整个帧变黑。常见的 NaN 来源:pow(neg, x)、 smoothstep(e,e,x)、ACES 中的 Inf。限制输入。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能