XCEngine/docs/api/XCEngine/Rendering/Passes/BuiltinSelectionMaskPass/BuiltinSelectionMaskPass.md

BuiltinSelectionMaskPass

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

类型: class

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

描述: 选择遮罩 pass，在深度风格重绘框架上只重绘被选中对象，并把结果写入 selection mask 目标。

概览

BuiltinSelectionMaskPass 继承自 BuiltinDepthStylePassBase。 它不重新实现整套场景重绘框架，而是只增加“按选中对象过滤”的那层语义：

• 外部传入 selectedObjectIds
• pass 内部记录到 m_selectedObjectIds
• ShouldRenderVisibleItem(...) 只让被选中的对象通过

当前流程

1. Render 记录选中对象 id 列表
2. 若列表为空，直接返回 false
3. 复制 sceneData，把 clear flags 改为纯颜色清屏且清为黑色
4. 组装 RenderPassContext
5. 调用基类 Execute(...)

公开方法

方法	说明
BuildInputLayout	复用深度风格 pass 的通用顶点布局
GetName	返回 BuiltinSelectionMaskPass
Render	只重绘选中对象到 selection mask

相关文档

• Passes
• BuiltinDepthStylePassBase
• BuiltinSelectionOutlinePass