Hunyuan3D-2.1 PBR材质入门:albedo与metallic-roughness两张图讲透
Hunyuan3D-2.1 PBR材质入门:albedo与metallic-roughness两张图讲透
Hunyuan3D-2.1 是腾讯混元开源的高质量图像生成 3D 资产模型,本仓库包含形状生成与 PBR 纹理生成两大核心能力。这篇文章以 PBR 材质中最重要的 albedo(基础色贴图) 和 metallic-roughness(金属度-粗糙度贴图,简称 mr) 这两张图为线索,带你快速看懂 Hunyuan3D-2.1 是如何从一张参考图"画"出生产级 3D 材质的,零基础也能读懂。
什么是 PBR 材质:为什么只需要两张贴图
PBR(Physically Based Rendering,基于物理的渲染)是目前游戏和 3D 建模的主流材质标准。它的核心思想是:物体的外观 = 固有色 × 光照响应。
而描述一个物体需要哪些"固有色"和"光照响应",Hunyuan3D-2.1 只需要生成两张图:
| 贴图 | 名称 | 内容 | 直观理解 |
|---|---|---|---|
| albedo | 基础色贴图 | 物体本身的颜色与花纹,不含光影 | 相当于"关闪光灯、均匀光照下拍到的原色" |
| mr | metallic-roughness 贴图 | 金属度 + 粗糙度 | 灰色越亮 = 越粗糙;越偏白(蓝通道)= 金属感越强 |
两者配合,渲染器就能自动算出金属的高光、塑料的磨砂感、布料的漫反射等真实效果。这也是为什么 Hunyuan3D-2.1 的 PBR 设置被固定为 <a href="https://link.gitcode.com/i/7e52429eea33a6d00dddb49342176a39" target="_blank">"albedo", "mr"],可以在 [unet/model.py 和 unet/modules.py 中看到这一配置:
pbr_settings=["albedo", "mr"] # 模型同时生成的两种 PBR 贴图
💡 小提示:albedo 图是"无光照"的,所以它看起来比最终渲染效果更平、更素,这是正常的。
仓库结构速览:三套模型各管一摊
本仓库按功能拆成了几个独立目录,理解它们的关系是入门的关键:
| 目录 / 文件 | 作用 | 关键文件 |
|---|---|---|
hunyuan3d-dit-v2-1/ |
形状生成:Diffusion Transformer 从图片生成 3D 几何 | config.yaml |
hunyuan3d-vae-v2-1/ |
Shape VAE:3D 几何的压缩/解码器 | config.yaml |
hunyuan3d-paintpbr-v2-1/ |
PBR 贴图生成:基于 Stable Diffusion 2.1 的多视角扩散模型 | model_index.json |
hy3dpaint/ |
纹理生成流水线:视角选择、烘焙、超分、导出 | textureGenPipeline.py |
demo.py |
一键演示脚本 | demo.py |
其中 PBR 模型的核心是 PBR 纹理生成器 textureGenPipeline.py,它决定了视角数量、分辨率和最终贴图大小。
一张参考图 → 两张 PBR 贴图:完整流程拆解
整个"上色"过程可以拆成 5 步,对应 demo.py 中的 paint_pipeline 调用:
① 图像变白模:先用 hunyuan3d-dit-v2-1 + hunyuan3d-vae-v2-1 把参考图转成无纹理网格(demo.glb)。
② 视角选择:从候选相机中选出 6~9 个视角(俯视、侧视、环绕),代码见 textureGenPipeline.py。
③ 多视角扩散生成 albedo 与 mr:先渲染出每个视角的法线图和位置图作为"骨架条件",再让扩散模型一次同时生成所有视角的两张贴图。生成结果会按"前半 albedo、后半 mr"拆分,逻辑见 multiview_utils.py:
mvd_image = {"albedo": mvd_image[:num_view], "mr": mvd_image[num_view:]}
④ 超分辨率增强:albedo 和 mr 各自通过 RealESRGAN 放大 4 倍,补齐细节(textureGenPipeline.py)。
⑤ 烘焙到 UV 贴图:多视角结果加权融合、修补遮挡区域后,烘焙成一张 4096×4096 的大贴图,最后导出为 GLB 文件(textureGenPipeline.py)。
深入一层:albedo 和 mr 如何"配对"生成
很多人好奇:一个模型怎么能同时画两种风格完全不同的贴图?秘密在于可学习的材质嵌入(material token)。
PBR 模型的 UNet 为每种材质注册了一组专属的"文字提示"(77 个 token × 1024 维),分别叫 learned_text_clip_albedo 和 learned_text_clip_mr,定义见 modules.py。推理时,模型对每个视角分别用这两组 token 引导去噪,等于让同一个网络"戴上两副眼镜",一副看颜色、一副看材质属性。
此外,扩散过程由 scheduler_config.json 配置(v_prediction 方式),推理默认 15 步(multiview_utils.py),并参考 DINOv2-giant 的图像特征保证多视角颜色一致。
关键参数速查表
跑实验前,这几个参数最值得调整:
| 参数 | 默认值 | 说明 |
|---|---|---|
max_num_view |
6(可调至 9) | 生成视角数,越多覆盖越好,越慢 |
resolution |
512 或 768 | 每个视角的扩散生成分辨率 |
texture_size |
4096 | 最终 UV 贴图尺寸(1024×4) |
bake_exp |
4 | 多视角烘焙的指数权重 |
num_inference_steps |
15(UniPC) | 扩散采样步数 |
guidance_scale |
3.0 | 条件引导强度 |
以上配置集中在 Hunyuan3DPaintConfig 中,按需在 demo.py 里修改即可。
快速上手:三步跑通 PBR 纹理生成
第一步:获取仓库
git clone https://gitcode.com/hf_mirrors/andreca/hunyuan3d-2.1xet
第二步:准备一张背景干净的参考图,放到 assets/ 目录(demo 默认读取 assets/demo.png)。
第三步:运行演示脚本
python demo.py
运行后会得到两个文件:
demo.glb:白模(只有几何,没有材质)demo_textured.glb:带 albedo + metallic-roughness 贴图的成品模型,可直接丢进 Blender、Unity 或 Three.js 查看 PBR 渲染效果 🎉
新手常见问题 FAQ
Q1:albedo 图和最终渲染图为什么长得不一样? 正常现象。albedo 是不含光照的基础色;金属高光、阴影都是渲染时结合 mr 图实时计算的。
Q2:mr 图为什么看起来是灰蒙蒙的? 它是一张功能图而非颜色图:绿色通道编码粗糙度、蓝色通道编码金属度。非金属的粗糙表面(如磨砂塑料)会偏暗灰,镜面金属则明显偏亮。
Q3:导出的 GLB 里包含哪两张贴图? GLB 遵循 glTF 的 metallic-roughness 标准,内嵌 albedo 贴图与 metallicRoughness 贴图,主流引擎无需额外处理即可正确显示。
Q4:视角数量怎么权衡? 6 个视角速度快、效果稳;9 个视角背面细节更好,但显存和时间都会增加。建议先从 6 开始试。
小结:Hunyuan3D-2.1 的 PBR 材质体系非常克制——只用 albedo 与 metallic-roughness 两张贴图,就覆盖了颜色与光影质感两大维度。理解了 textureGenPipeline.py 中"多视角生成 → 超分 → 烘焙"的主干流程,再看 hunyuan3d-paintpbr-v2-1/ 里的扩散模型配置,整个 PBR 材质生成链路就彻底讲透了。