Files
XCEngine/docs/api/XCEngine/Components/MeshRendererComponent/SetMaterials.md

826 B

MeshRendererComponent::SetMaterials

批量设置整组材质槽。

void SetMaterials(const std::vector<Resources::ResourceHandle<Resources::Material>>& materials);

行为说明

当前实现会整体替换所有材质槽状态:

  1. 用传入数组直接替换 m_materials
  2. m_materialPathsm_materialRefs、pending 数组和 async 标记数组与新长度对齐
  3. 对每个槽位从句柄反推路径
  4. 再按路径尝试回填 AssetRef

这不是增量更新,而是整组重建。旧数组里超出新长度的槽位会被直接丢弃。

参数

  • materials - 新的材质句柄数组。

相关文档