体素光线的秘密:Raymarched 体积聚光灯原理详解——Dioramas 电影感 God Rays 完整指南
体素光线的秘密:Raymarched 体积聚光灯原理详解——Dioramas 电影感 God Rays 完整指南
🎬 Dioramas 是一个免费开源的电影级交互式 3D 网站框架,用 AI 生成资产(Nano Banana 2 + Meshy 7.1)和 20 个示例站点,打造出 Awwwards 级别的落地页。其中最具"电影感"的一招,就是Raymarched 体积聚光灯——也就是你在预告片里常见的 God Rays(上帝光线):光束穿过烟雾、雨幕和尘埃,打在机甲、摩托车和水晶上。
本文不堆代码,只用一张张图,带你彻底看懂这套体积光背后的原理,以及它在 Dioramas 中的实现方式。
一、原理拆解:Raymarching 是怎么让光"可见"的
先说一个反直觉的事实:普通 3D 渲染里,光是不可见的。three.js 的 SpotLight 只负责照亮表面,空气里没有任何东西——你看不见光束本身。
而电影镜头里的 God Rays,本质是光在悬浮颗粒(烟、雨、尘埃)上的散射。Dioramas 用一种叫 Raymarching(光线步进) 的技术来模拟它:
- 逐像素发射视线:对屏幕上的每个像素,从相机位置向场景发射一条射线;
- 沿射线取样:把射线切成 32 个小步长(见 src/core/volumetric.js),每一步判断"这个点是否在某个聚光灯的圆锥里";
- 累加亮度:在锥内的点按噪声密度累加颜色,最终得到一个漂浮的"光束";
- 深度截断:取样到场景深度图就立刻停下——所以光束会正确地落在地面上、被柱子挡住、从物体背后穿过,这是体积光"以假乱真"的关键。
此外还有两个点睛细节:
- 双层噪声 + 风场:用两层不同频率的 3D 噪声(
vnoise)模拟烟絮,再让噪声随时间沿wind方向漂移,光束就有了缓缓流动的尘埃感; - 二次衰减:亮度按
1/(1 + d²·range)随距离衰减,光锥近亮远暗,自然消散在黑暗里。
💡 一句话总结:不是画了一根"光的管子",而是逐像素"计算空气里该有多亮"。
二、Dioramas 里的体积光:一个后处理效果
在 Dioramas 中,这套技术被封装成一个后处理 Effect:VolumetricSpotEffect,源码位于 src/core/volumetric.js。它挂在 post.pre(色调映射之前)执行,最多同时支持 4 盏聚光灯。
核心用法只有两步(详见 docs/ENGINE.md):
- 构造效果:
new VolumetricSpotEffect(camera, { density, noise, noiseScale, maxDist, wind, floorY }) - 把场景里现成的
THREE.SpotLight交出去:.add(spotLight, { scale, range, softness })
你不需要自己摆"体积光"——效果会自动追踪 SpotLight 的位置、朝向、颜色和强度。灯光一关,光束就消失。这正是 20 个示例里"签名交互"的魔法所在。
关键参数速查表
| 参数 | 作用 | 推荐范围 |
|---|---|---|
density |
雾的密度,控制光束整体亮度 | 0.02–0.05(相机在光束内时) |
noise |
噪声调制比例(0=均匀雾) | 0.8–0.95 |
noiseScale |
噪声频率,越大颗粒越细碎 | 0.5–3.4 |
maxDist |
射线最远步进距离 | 12–75 |
wind |
尘埃漂移方向与速度 | 小数值向量 |
floorY |
雾从哪个高度开始出现 | 地面 y 值 |
scale |
灯光强度到光束亮度的换算 | 0.001–0.05 |
softness |
光锥边缘柔化程度 | 0.2–0.6 |
三、案例赏析:同样的引擎,五种完全不同的光束
Dioramas 的 20 个示例站共享同一套体积光引擎,但每个世界都调出了截然不同的氛围。挑几组最有代表性的看:
🌊 Keeper(守夜人灯塔):旋转的灯塔双光束在雨夜的海面上扫过,雨越大光束越"实"。它的签名交互是用鼠标接管光束——把光柱停在远处小船上方 2 秒,船就被"引航"回港。
🏍️ Racer(雨夜车房):按下空格,头灯瞬间点亮,一束体积光束穿透雨丝打在湿漉漉的沥青上,配合霓虹反射,像一张汽车广告大片。
🐙 Abyssal(万米深渊):深潜器的 LED 泛光灯组射入 11km 深的黑水,光束在海水里缓慢扩散、消散。
💎 Lithos(晶洞珠宝):一盏低调的聚光灯掠过紫水晶晶洞,光束密度压得很低(density: 0.026),只留下一丝"空气感",衬托晶体的星光。
四、进阶玩法:每个世界都有专属"魔改"版
核心引擎是 4 灯 32 步的通用版,但每个需要"签名效果"的世界都会在自己目录里 fork 一份并改造(src/core 是只读共享层)。两个典型:
- examples/hangar/volumetric.js:8 盏灯 + 前向散射 + 高度雾层。它加了一个
phase项——当光锥指向观察者时额外增亮,正是《泰坦陨落》那种"光对着你脸打"的镜头感; - examples/abyssal/beams.js:热核心光锥。增加了轴心高光(
core)和灯口附近的"咽喉"亮斑,并把步进提到 48 步,让 LED 光束的边缘锐利不抖。
👉 这正是 Dioramas 的工程哲学:共享引擎保底,页面级魔改出彩。
五、快速上手:3 步跑起来,亲眼调参
git clone https://gitcode.com/gh_mirrors/di/dioramas
cd dioramas
npm install
npm run dev # 访问 http://127.0.0.1:5190/
然后按 F12 打开控制台改 density、noise 实时观察,或参考 docs/ENGINE.md 的完整 API 说明和 README.md 了解全部 20 个示例。
⚠️ 调参避坑清单(官方踩过的坑)
- 相机在光束内会整屏发雾——把
density压到 0.02–0.05,靠噪声塑形而不是加密度; - SpotLight 的
.target要加进 scene,否则光锥方向是乱的; - 效果必须放
post.pre(色调映射之前),否则 HDR 亮度会被压扁; - 想要"更脏更电影"的光,抄 examples/hangar/volumetric.js 的
phase前向散射项即可。
写在最后
Raymarched 体积聚光灯没有魔法,只有逐像素、逐射线、逐噪声的耐心累加。而 Dioramas 把这套原理封装成一个"接入即电影感"的后处理模块,再交给 20 个风格迥异的世界反复验证——这就是它能持续产出 Awwwards 级画面的底气。想动手构建自己的"世界"?把一个 brief + docs/ENGINE.md 交给你的编码 Agent 即可。




