XCEngine/docs/api/XCEngine/Rendering/RenderMaterialUtility/FindShaderPropertyBySemantic.md

FindShaderPropertyBySemantic

命名空间: XCEngine::Rendering

类型: function

头文件: XCEngine/Rendering/RenderMaterialUtility.h

签名

const Resources::ShaderPropertyDesc* FindShaderPropertyBySemantic(
    const Resources::Material* material,
    const Containers::String& semantic);

作用

在材质当前绑定的 shader property 列表中，按 semantic 查找匹配项。

当前实现行为

1. 如果 material == nullptr 或 material->GetShader() == nullptr，返回 nullptr。
2. 对输入 semantic 做 Trim().ToLower() 归一化。
3. 顺序遍历 material->GetShader()->GetProperties()。
4. 只要某个 property 的 semantic 归一化后相同，就返回该 property 指针。
5. 找不到则返回 nullptr。

当前使用位置

• ResolveBuiltinBaseColorFactor 用它优先查找 BaseColor 语义。
• ResolveBuiltinBaseColorTexture 用它优先查找 BaseColorTexture 语义。

相关文档

• ResolveBuiltinBaseColorFactor
• ResolveBuiltinBaseColorTexture
• NormalizeBuiltinPassMetadataValue