XCEngine/docs/api/XCEngine/Rendering/CameraRenderer/SetObjectIdPass.md

CameraRenderer::SetObjectIdPass

命名空间: XCEngine::Rendering

类型: method

头文件: XCEngine/Rendering/Execution/CameraRenderer.h

签名

void SetObjectIdPass(std::unique_ptr<ObjectIdPass> objectIdPass);

作用

替换主场景之后使用的 object-id 输出 pass。

当前实现行为

1. 如果旧 m_objectIdPass 非空，先调用它的 Shutdown()。
2. 接管新的 objectIdPass。
3. 如果新指针为空，则自动回退到 Passes::BuiltinObjectIdPass。

关键语义

• 这是 object-id 渲染链路的主要注入点，测试里可以通过它替换 mock pass。
• CameraRenderer::Render() 只在 request.objectId.IsRequested() 时才会真正调用这里持有的 pass。

相关文档

• GetObjectIdPass
• Render
• Passes