XCEngine/docs/api/XCEngine/Rendering/RenderMaterialUtility/BuildDepthStencilState.md

BuildDepthStencilState

命名空间: XCEngine::Rendering

类型: function

头文件: XCEngine/Rendering/RenderMaterialUtility.h

签名

RHI::DepthStencilStateDesc BuildDepthStencilState(const Resources::Material* material);

作用

从材质构建深度/模板状态描述。

当前实现行为

默认值为：

• depthTestEnable = true
• depthWriteEnable = true
• depthFunc = Less
• stencilEnable = false

如果 material != nullptr，会用材质的 depthTestEnable、depthWriteEnable 和 depthFunc 覆盖对应字段。当前没有从材质暴露模板状态细节。

设计含义

当前实现强调“默认可用的基础深度语义”，还不是完整的 render state authoring 系统。对一个仍在演进中的引擎来说，这样的默认值足以支撑基础前向渲染，但文档里必须明确它还没覆盖完整模板工作流。

相关文档

• BuildBlendState
• ApplyMaterialRenderState