XCEngine/docs/api/XCEngine/Rendering/Planning/CameraRenderRequest/ObjectIdRenderRequest/ObjectIdRenderRequest.md

ObjectIdRenderRequest

命名空间: XCEngine::Rendering

类型: struct

头文件: XCEngine/Rendering/Planning/CameraRenderRequest.h

描述: 描述一份 camera request 是否需要额外输出 object-id 纹理，以及这份输出目标是否完整可用。

概述

ObjectIdRenderRequest 是 CameraRenderRequest 里的辅助子请求，用来把“主场景颜色输出”和“object-id 辅助输出”拆开描述。

它当前只持有一个字段：

字段	说明
surface	object-id pass 要写入的目标表面，通常是单独的颜色附件 + 深度附件组合。

关键语义

• IsRequested 只回答“调用方有没有挂一个颜色附件过来”。
• IsValid 才回答“这份 object-id 输出目标是否足够完整，可以真正执行 pass”。
• CameraRenderer::Render() 会在主场景之后检查并消费这个子请求。

真实使用位置

• 编辑器 scene viewport 会准备一张单独的 object-id render target，并把它装进 request.objectId.surface。
• CameraRenderer::Render() 在 request.objectId.IsRequested() 为真时，调用当前的 ObjectIdPass 执行辅助输出。

相关文档

• CameraRenderRequest
• IsRequested
• IsValid
• CameraRenderer