3D-RE-GEN的Blender渲染实战:HDRI灯光、Filmic色调映射与渲染参数完整指南
3D-RE-GEN的Blender渲染实战:HDRI灯光、Filmic色调映射与渲染参数完整指南
3D-RE-GEN 是一个用生成式框架完成单张室内照片 3D 场景重建的开源项目,而 Blender 渲染正是它的收官一步:把前面流程拼出来的场景 GLB 文件,用 Cycles 引擎 + HDRI 环境光 + Filmic 色调映射,输出可用于对比与评估的高质量渲染图。这篇文章带你从零理解 Blender 渲染参数该怎么配。
渲染环节在整个流水线中的位置 🧭
3D-RE-GEN 的完整流程分 9 步,Blender 渲染是第 8 步。它不是凭空渲染,而是消费前面步骤的产物:
| 前置步骤 | 产出 | 渲染环节如何使用 |
|---|---|---|
| 第 4 步 VGGT | 相机参数 camera.npz |
精确还原拍摄机位 |
| 第 7 步 场景重建 | combined_scene.glb |
作为主场景模型导入 |
| 第 7 步 背景重建 | ground_aligned.glb + 烘焙贴图 |
给房间"套上"墙面地板 |
| 点云分支 | combined_scene.ply |
可选:渲染点云做对比 |
渲染脚本由主入口以无头模式(blender -b -P ...)启动,配置文件统一走 src/config.yaml,无需打开 Blender 图形界面。想单独重跑渲染,只需执行:
python run.py -p 8
下面是两张典型的输入照片,它们就是整条流水线的起点,最终都会变成可 360° 查看的三维场景:
读懂配置:Blender 渲染参数一览
所有渲染开关都集中在 src/config.yaml 的 "Blender Rendering Configuration" 区段。仓库给出的参考配置如下(参数名 + 当前值):
output_render: "../output/rendering/"
hdri_path: "../input_images/raw/brown_photostudio_02_8k.hdr"
hdri_strength: 1.0 # HDRI 光照强度
hdri_rotation: 130 # HDRI 水平旋转角度(度)
hdri_white_bg: false # true 则放弃 HDRI,用纯白背景
blender_render_samples: 8 # Cycles 采样数
look: "Medium Contrast"
view_transform: "Filmic"
exposure: 0.4
gamma: 0.8
渲染脚本 src/blender_rendering/run.py 会读取这些键,逐项应用到 Cycles 场景里。下面按"灯光 → 色调 → 画质 → 输出"的顺序拆解。
HDRI 灯光设置:强度、旋转与白色背景开关
HDRI(高动态范围图像)是室内渲染最自然的打光方式——它把真实照片的光照环境直接变成"虚拟摄影棚"。
1. 强度 hdri_strength
控制环境光的整体亮度。1.0 是物理标准亮度;场景偏暗可以提到 1.5 ~ 2.0,偏亮则往下调。脚本中的 setup_hdri() 函数会把该值写入世界环境的 Background 节点。
2. 旋转 hdri_rotation
以角度为单位旋转 HDRI(绕 Z 轴)。室内场景中窗户方向决定了光线从哪面墙打进来,所以这一步很关键:转一圈看渲染结果,让主光源落在最"像窗光"的位置。
3. 白色背景开关 hdri_white_bg
设为 true 时完全跳过 HDRI,改用纯白背景(Strength 2.0)——适合只展示几何、不关心氛围的场景;设为 false 则启用完整 HDRI 光照。脚本还有一个兜底逻辑:HDRI 文件不存在时会自动回退到白背景,不会中断流程。
4. 半球模式 as_hemisphere
GT 真值渲染分支会用半球遮罩(只保留上半球光、下半球压黑),让地面反射更干净。普通渲染分支默认关闭,新手不需要动它。
💡 HDRI 文件放在
input_images/raw/目录,仓库内置了kloofendal_overcast_puresky_1k.hdr可直接使用。
Filmic 色调映射:四个色彩参数逐个说
Cycles 输出的是线性 HDR 数据,直接看会"过曝发白",必须经过**视图变换(View Transform)**转换。项目默认选择 Filmic——它对高光滚降平滑,室内白墙不容易"炸成一片死白",是室内场景的首选。
这组参数由 set_color_management() 函数统一写入,对应 Blender 中"输出设置 → 色彩管理"面板:
| 参数 | 配置键 | 默认值 | 作用 |
|---|---|---|---|
| 视图变换 | view_transform |
Filmic |
决定整体色调曲线 |
| 外观 | look |
Medium Contrast |
对比度风格(如 Low Contrast) |
| 曝光 | exposure |
0.4 |
全局提亮/压暗(对数刻度) |
| Gamma | gamma |
0.8 |
调整中间调明暗 |
实用调法:先固定 view_transform: Filmic,再按"曝光 → look → gamma"的顺序微调——曝光差得多就调 exposure(±0.3 步进),对比不对再换 look,最后用 gamma 做精细打磨。
Cycles 引擎、采样与去噪:画质和速度的平衡
脚本启动时会把渲染引擎固定为 Cycles 并启用 GPU:
- 采样数
blender_render_samples:Cycles 的核心质量参数,数值越高噪点越少。仓库配置为8,属于"够用的快渲"级别;出正式对比图建议提到 64 ~ 128,时间成本线性增长。 - 去噪:脚本中开启了 Cycles Denoising(
use_denoising = True),即使低采样也能得到干净的成图,这是它能用 8 个采样跑通流水线的关键。 - 分辨率自动匹配:渲染分辨率默认取输入照片的尺寸,且长边被限制在 1280 像素以内——保证渲染图和原图一一对应,方便后续逐像素评估。
- 透明底片:
render_camera()会打开film_transparent = True,让场景外区域透明,随后用 PIL 贴回白色背景,产出_white_bg.png成图。
双机位渲染与点云可选模式
脚本会建立两台相机各渲一张:
- Camera_Main:从
camera.npz精确还原原始拍摄位置,用于和输入照片正面对比(对应predicted_image评估项); - Camera_Rotated(或 VGGT 分支下的俯视相机):旋转 90° 或环绕场景,用来检查场景背面是否也合理。
成图会写入 output_render 目录,文件名形如 render_cam1.png、render_cam2.png,白底版本为 render_cam1_white_bg.png。
如果开启 render_pc: true,还会额外导入 combined_scene.ply 点云并用几何节点转成圆点渲染(点大小由 pointcloud_scale 控制,默认 0.002),生成 render_pointcloud_cam1/2 两组对比图——调试几何质量时非常直观。
材质模式:烘焙贴图与完整 PBR
场景"空房间"背景的材质由 use_baked_image_only 切换:
true(烘焙模式):直接把 AI 生成的空房间图作为 Albedo 投影到背景网格上,再叠加roughness_strength/metallic_strength/normal_strength控制粗糙度、金属度与法线强度。速度快、效果稳定,是默认推荐;false(完整 PBR):加载 albedo / roughness / metallic / normal 四张贴图构建完整 PBR 材质链,质感上限更高,但需要对应贴图文件齐全。
常见问题速查 ✍️
| 现象 | 排查方向 |
|---|---|
提示 GLB scene file not found 并跳过 |
先跑完 1~7 步,combined_scene.glb 才会生成 |
提示 HDRI file not found |
检查 hdri_path 是否存在;脚本会自动回退白背景 |
| 画面整体偏暗/偏亮 | 先调 hdri_strength,再调 exposure |
| 窗光方向不对 | 以 30° 步进旋转 hdri_rotation |
| 低采样有噪点 | 提高 blender_render_samples 到 64 以上(去噪已默认开启) |
| 纹理与网格错位 | 确认 UV 投影使用的相机与 camera.npz 一致 |
小结
3D-RE-GEN 的 Blender 渲染环节可以概括为"三件大事":
- HDRI 环境光:
hdri_strength+hdri_rotation控制亮度与窗光方向,hdri_white_bg一键切白底; - Filmic 色调映射:
view_transform/look/exposure/gamma四个参数决定最终观感; - Cycles 画质:采样数 + 去噪 + 分辨率自动匹配,兼顾速度与评估需求。
所有参数都收敛在 src/config.yaml 一个文件里,改完跑 python run.py -p 8 即可看到变化。理解这些参数后,你也能为自己的 3D 场景搭出灯光自然、色调讨喜的渲染结果 🎬

