XCEngine/docs/api/XCEngine/Rendering/Passes/BuiltinObjectIdOutlinePass/SetShaderPath.md

BuiltinObjectIdOutlinePass::SetShaderPath

命名空间: XCEngine::Rendering::Passes

类型: method

头文件: XCEngine/Rendering/Passes/BuiltinObjectIdOutlinePass.h

签名

void SetShaderPath(const Containers::String& shaderPath);

作用

更新这个 outline pass 后续初始化要加载的 shader 路径。

当前实现行为

当前实现按下面顺序处理：

1. 如果新旧路径完全相同，直接返回。
2. 调用 DestroyResources()，释放当前缓存的 pipeline、descriptor 和 shader handle。
3. 把 m_shaderPath 更新为传入值。

关键语义

• 改路径会立刻清空当前资源缓存，等待下一次 Render 按新路径重新初始化。
• 允许传入空路径；但之后第一次创建资源会因为缺少注入路径而失败。
• 这个方法只更新“将要加载的路径”，不立即创建任何 GPU 资源。

相关文档

• GetShaderPath
• Render
• Shutdown