materialRoughness

提供材质的最终粗糙度，该值已内置了将 `.roughness` 属性与 `.roughnessMap` 贴图（G通道）相乘的逻辑。

核心优势

其核心优势是自动组合：它将 PBR 工作流中“基础值与贴图相乘”的常见模式完全封装，并与标准材质属性无缝集成，极大地简化了粗糙度控制。

作为 PBR 光照模型的核心输入，用于控制高光和环境反射的模糊度。

作为混合因子，用于在不同质感（如干/湿）的材质间混合。

作为数据桥梁，用于根据表面粗糙度触发不同的音效。

直接输出其值以灰度形式调试模型的最终粗糙度分布。

通过在 JavaScript 中修改材质属性来配置。`material.roughness` (0-1) 设置基础粗糙度。如果提供了 `material.roughnessMap`，最终粗糙度为 `基础值 * 贴图G通道值`，从而实现局部粗糙度变化。

1// 在物理光照模型中，materialRoughness 是光照计算的核心输入之一
2const lighting = PBR( {
3    roughness: materialRoughness, // <-- 此处使用
4    // ... 其他 PBR 输入
5} );

提供材质的最终粗糙度，该值已内置了将 `.roughness` 属性与 `.roughnessMap` 贴图（G通道）相乘的逻辑。

其核心优势是自动组合：它将 PBR 工作流中“基础值与贴图相乘”的常见模式完全封装，并与标准材质属性无缝集成，极大地简化了粗糙度控制。

作为 PBR 光照模型的核心输入，用于控制高光和环境反射的模糊度。

作为混合因子，用于在不同质感（如干/湿）的材质间混合。

作为数据桥梁，用于根据表面粗糙度触发不同的音效。

直接输出其值以灰度形式调试模型的最终粗糙度分布。

1// 在物理光照模型中，materialRoughness 是光照计算的核心输入之一
2const lighting = PBR( {
3    roughness: materialRoughness, // <-- 此处使用
4    // ... 其他 PBR 输入
5} );