XCEngine/docs/api/XCEngine/Rendering/RenderSurface/SetDepthStateBefore.md

RenderSurface::SetDepthStateBefore

设置深度附件在本次渲染开始前期望处于的状态。

void SetDepthStateBefore(RHI::ResourceStates state);

参数

• state - 调用方约定的深度附件起始资源状态。

当前语义

• 默认值是 RHI::ResourceStates::DepthWrite。
• RenderSurface 只保存该状态，不会验证深度附件是否真的已经处于这个状态。
• 支持 depth barrier 的 pass 或 renderer 可在 IsAutoTransitionEnabled 为 true 时把它作为自动切换的起点。

当前实现边界

• 这不是 depth attachment 的真实状态查询接口，只是调用方与消费方之间的约定。
• 是否真正消费这个字段，取决于具体 pass / renderer 的实现。

相关文档

• RenderSurface
• GetDepthStateBefore
• SetDepthStateAfter
• IsAutoTransitionEnabled