Skip to main content
깊이 스텐실 상태를 설명합니다.

구문

멤버

DepthEnable
형식: BOOL
깊이 테스트를 사용할지 여부를 지정합니다. 깊이 테스트를 사용하려면 이 멤버를 TRUE로 설정합니다. DepthWriteMask
형식: D3D12_DEPTH_WRITE_MASK
깊이 데이터에 의해 수정될 수 있는 깊이 스텐실 버퍼의 일부를 식별하는 D3D12_DEPTH_WRITE_MASK 형식의 값입니다. DepthFunc
형식: D3D12_COMPARISON_FUNC
깊이 데이터를 기존 깊이 데이터와 비교하는 함수를 식별하는 D3D12_COMPARISON_FUNC 형식의 값입니다. StencilEnable
형식: BOOL
스텐실 테스트를 사용할지 여부를 지정합니다. 스텐실 테스트를 사용하려면 이 멤버를 TRUE로 설정합니다. StencilReadMask
형식: UINT8
스텐실 데이터 읽기용 깊이 스텐실 버퍼의 일부를 식별합니다. StencilWriteMask
형식: UINT8
스텐실 데이터 쓰기용 깊이 스텐실 버퍼의 일부를 식별합니다. FrontFace
형식: D3D12_DEPTH_STENCILOP_DESC
표면 법선이 카메라를 향하는 픽셀에 대해 깊이 테스트와 스텐실 테스트의 결과를 사용하는 방법을 설명하는 D3D12_DEPTH_STENCILOP_DESC 구조체입니다. BackFace
형식: D3D12_DEPTH_STENCILOP_DESC
표면 법선이 카메라 반대쪽을 향하는 픽셀에 대해 깊이 테스트와 스텐실 테스트의 결과를 사용하는 방법을 설명하는 D3D12_DEPTH_STENCILOP_DESC 구조체입니다. DepthBoundsTestEnable
형식: BOOL
깊이 경계 테스트를 사용하려면 TRUE, 그렇지 않으면 FALSE입니다. 기본값은 FALSE입니다.

설명

D3D12_GRAPHICS_PIPELINE_STATE_DESC 개체는 출력 병합기(output-merger) 단계에서 깊이 스텐실 테스트가 수행되는 방식을 제어하는 깊이 스텐실 상태 구조체를 포함합니다. 이 표는 깊이 스텐실 상태의 기본값을 보여 줍니다.
상태기본값
DepthEnableTRUE
DepthWriteMaskD3D12_DEPTH_WRITE_MASK_ALL
DepthFuncD3D12_COMPARISON_LESS
StencilEnableFALSE
StencilReadMaskD3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMaskD3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFuncBackFace.StencilFuncD3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOpBackFace.StencilDepthFailOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOpBackFace.StencilPassOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOpBackFace.StencilFailOpD3D12_STENCIL_OP_KEEP
DepthBoundsTestEnableFALSE
스텐실링을 지원하는 형식은 DXGI_FORMAT_D24_UNORM_S8_UINT 및 DXGI_FORMAT_D32_FLOAT_S8X24_UINT입니다.

요구 사항

헤더: d3d12_xs.h 또는 d3d12_x.h
라이브러리: d3d12_xs.lib 또는 d3d12_x.lib
지원 플랫폼: XBOX Series 콘솔 및 XBOX One 제품군

관련 항목

핵심 구조체
마지막 수정일 2026년 8월 24일