环境贴图

相关参考：

• Scene API / 动态创建内容
• Scene API / 渲染与材质

环境贴图主要用于提升模型材质的反射与整体质感，尤其适合 PBR glTF 模型。

从 HDR 创建环境贴图

const envMap = await api.createEnvMapByHDR('/assets/studio.hdr');

也支持传 ArrayBuffer。

应用到模型

const model = await api.getObject('rabbit');
const envMap = await api.createEnvMapByHDR('/assets/studio.hdr');

await api.useEnvMapForObj(model, envMap, 1);

第三个参数是强度，默认值为 1。

适用对象

当前实现会遍历目标对象及其子节点，并把环境贴图写入材质。它主要针对模型类对象使用最有效。

推荐搭配

环境贴图通常需要配合：

• 方向光/环境光
• 色调映射
• 各向异性

一起调试，效果才会稳定。

建议

1. HDR 资源尽量使用压缩良好、尺寸合适的文件。
2. 不要对所有对象都盲目套环境贴图，先从核心模型开始。
3. 如果你只是想让背景更沉浸，优先考虑全景图；如果你想让模型“更像真实材质”，再用环境贴图。