如何通过代码在SceneKit中实现基于物理的渲染（PBR）

我看了你遇到的问题：手动在Xcode里配置PBR纹理一切正常，但通过代码从MDLMaterial转换为SCNMaterial后，金属度和粗糙度属性就消失了，虽然调试时MDLMaterial里确实有这些信息。这个问题大概率是MDLMaterial初始化时的一个操作破坏了属性映射，以及SCNMaterial转换时的细节处理不到位。

下面是具体的问题分析和修复方案：

问题根源 #

1. 不必要的removeAllProperties调用
   你在创建MDLMaterial后立刻调用了[mdlMaterial removeAllProperties];，这会移除MDLPhysicallyPlausibleScatteringFunction关联的所有默认属性，包括PBR渲染必需的基础属性映射。即使你之后手动添加了金属度和粗糙度属性，MDLMaterial内部的属性结构已经被破坏，导致转换为SCNMaterial时无法正确识别这些PBR属性。

2. SCNMaterial转换后的属性映射延迟
   虽然你设置了material.lightingModelName = SCNLightingModelPhysicallyBased;，但在转换后直接赋值给几何体材质时，可能存在属性同步的延迟，或者MDL到SCN的属性映射需要更明确的触发。

修复后的完整代码 #

1. 修正MDLMaterial的创建逻辑 #

去掉removeAllProperties，直接添加需要的PBR属性，保留散射函数的默认结构：

// 创建物理散射函数
MDLPhysicallyPlausibleScatteringFunction *scatFunction = [MDLPhysicallyPlausibleScatteringFunction new];
// 初始化材质，保留默认属性结构
MDLMaterial *mdlMaterial = [[MDLMaterial alloc] initWithName:@"material" scatteringFunction:scatFunction];

// 添加基础颜色纹理
MDLMaterialProperty *bcProperty = [[MDLMaterialProperty alloc] initWithName:@"BaseColor" 
                                                                     semantic:MDLMaterialSemanticBaseColor 
                                                                          URL:plyItem.textureFileURL];
// 添加金属度纹理：注意语义要正确对应
MDLMaterialProperty *metalnessProperty = [[MDLMaterialProperty alloc] initWithName:@"Metallic" 
                                                                          semantic:MDLMaterialSemanticMetallic 
                                                                               URL:[[NSBundle mainBundle] URLForResource:@"metalness" withExtension:@"jpg"]];
// 添加粗糙度纹理
MDLMaterialProperty *roughnessProperty = [[MDLMaterialProperty alloc] initWithName:@"Roughness" 
                                                                           semantic:MDLMaterialSemanticRoughness 
                                                                                URL:[[NSBundle mainBundle] URLForResource:@"roughness" withExtension:@"jpg"]];

// 将属性添加到材质
[mdlMaterial setProperty:bcProperty];
[mdlMaterial setProperty:metalnessProperty];
[mdlMaterial setProperty:roughnessProperty];

2. 修正材质转换与赋值逻辑 #

转换为SCNMaterial后，除了设置光照模型，还可以手动同步MDL里的纹理属性，确保万无一失：

// 将MDL网格转为SCN节点
SCNNode *node = [SCNNode nodeWithMDLObject:mesh];
// 转换材质
SCNMaterial *material = [SCNMaterial materialWithMDLMaterial:mdlMaterial];
// 明确设置PBR光照模型
material.lightingModelName = SCNLightingModelPhysicallyBased;

// 手动同步金属度和粗糙度纹理（作为 fallback，确保转换失败时也能生效）
MDLMaterialProperty *mdlMetalness = [mdlMaterial propertyNamed:@"Metallic"];
if (mdlMetalness) {
    material.metalness.contents = mdlMetalness.url;
}
MDLMaterialProperty *mdlRoughness = [mdlMaterial propertyNamed:@"Roughness"];
if (mdlRoughness) {
    material.roughness.contents = mdlRoughness.url;
}

// 赋值给几何体
node.geometry.firstMaterial = material;

额外注意事项 #

• 纹理命名与路径：确保metalness.jpg和roughness.jpg确实存在于主Bundle中，且大小写与代码中的一致（iOS文件系统是区分大小写的）。
• 纹理格式：PBR纹理建议使用线性空间的纹理，如果你用的是sRGB格式的jpg，可能需要在加载时设置MDLTextureLoader的选项，确保颜色空间正确：

  MDLTextureLoader *loader = [[MDLTextureLoader alloc] initWithURL:nil options:@{MDLTextureLoaderOptionSRGB:@NO}];
  MDLTexture *metalnessTex = [loader newTextureWithURL:[[NSBundle mainBundle] URLForResource:@"metalness" withExtension:@"jpg"] error:nil];
  MDLMaterialProperty *metalnessProperty = [[MDLMaterialProperty alloc] initWithName:@"Metallic" semantic:MDLMaterialSemanticMetallic texture:metalnessTex];
  

  这样可以保证金属度和粗糙度的灰度值被正确解析为线性空间的物理属性值。

内容的提问来源于stack exchange，提问作者Joker