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

RenderSurface::GetDepthStateBefore

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

RHI::ResourceStates GetDepthStateBefore() const;

返回值

• 返回内部保存的深度附件“开始状态”；默认值是 RHI::ResourceStates::DepthWrite。

当前语义

• 当消费方启用了基于 RenderSurface 的自动 depth barrier 时，这个值会被当作过渡到 DepthWrite 或其他目标状态的起点。
• 即使当前 surface 没有深度附件，这个字段也仍然可以被预先设置和保留。

当前实现边界

• 该返回值只反映 RenderSurface 当前记录的约定，不保证 GPU 资源真实状态与之完全一致。
• 并非所有 renderer / pass 都会读取这个字段。

相关文档

• RenderSurface
• SetDepthStateBefore
• GetDepthStateAfter
• IsAutoTransitionEnabled