структура D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)
Описывает состояние трафарета глубины.
Синтаксис
typedef struct D3D12_DEPTH_STENCIL_DESC1 {
BOOL DepthEnable;
D3D12_DEPTH_WRITE_MASK DepthWriteMask;
D3D12_COMPARISON_FUNC DepthFunc;
BOOL StencilEnable;
UINT8 StencilReadMask;
UINT8 StencilWriteMask;
D3D12_DEPTH_STENCILOP_DESC FrontFace;
D3D12_DEPTH_STENCILOP_DESC BackFace;
BOOL DepthBoundsTestEnable;
} D3D12_DEPTH_STENCIL_DESC1;
Члены
DepthEnable
Указывает, следует ли включить тестирование глубины. Задайте для этого элемента значение TRUE , чтобы включить тестирование глубины.
DepthWriteMask
D3D12_DEPTH_WRITE_MASK типизированное значение, идентифицирующее часть буфера трафарета глубины, которую можно изменить с помощью данных глубины.
DepthFunc
D3D12_COMPARISON_FUNC типизированное значение, идентифицирующее функцию, которая сравнивает данные глубины с существующими данными глубины.
StencilEnable
Указывает, следует ли включить тестирование набора элементов. Присвойте этому элементу значение TRUE , чтобы включить тестирование трафарета.
StencilReadMask
Определите часть буфера трафарета глубины для чтения данных трафарета.
StencilWriteMask
Определите часть буфера трафарета глубины для записи данных трафарета.
FrontFace
Структура D3D12_DEPTH_STENCILOP_DESC, которая описывает, как использовать результаты теста глубины и теста трафарета для пикселей, нормальная поверхность которых обращена к камере.
BackFace
Структура D3D12_DEPTH_STENCILOP_DESC , описывающая, как использовать результаты теста глубины и теста трафарета для пикселей, поверхность которых обычно обращена от камеры.
DepthBoundsTestEnable
Значение TRUE, чтобы включить тестирование с ограничениями глубины; в противном случае — FALSE. Значение по умолчанию — FALSE.
Комментарии
Объект D3D12_GRAPHICS_PIPELINE_STATE_DESC содержит структуру состояния трафарета глубины, которая управляет тем, как тестирование трафарета глубины выполняется на этапе слияния вывода.
В этой таблице показаны значения по умолчанию для состояний трафарета глубины.
| Состояние | Значение по умолчанию |
|---|---|
| DepthEnable | TRUE |
| DepthWriteMask | D3D12_DEPTH_WRITE_MASK_ALL |
| DepthFunc | D3D12_COMPARISON_LESS |
| StencilEnable | Ложь. |
| StencilReadMask | D3D12_DEFAULT_STENCIL_READ_MASK |
| StencilWriteMask | D3D12_DEFAULT_STENCIL_WRITE_MASK |
|
FrontFace.StencilFunc и BackFace.StencilFunc |
D3D12_COMPARISON_ALWAYS |
|
FrontFace.StencilDepthFailOp и BackFace.StencilDepthFailOp |
D3D12_STENCIL_OP_KEEP |
|
FrontFace.StencilPassOp и BackFace.StencilPassOp |
D3D12_STENCIL_OP_KEEP |
|
FrontFace.StencilFailOp и BackFace.StencilFailOp |
D3D12_STENCIL_OP_KEEP |
| DepthBoundsTestEnable | Ложь. |
Форматы, поддерживающие набор элементов, DXGI_FORMAT_D24_UNORM_S8_UINT и DXGI_FORMAT_D32_FLOAT_S8X24_UINT.
Требования
| Требование | Значение |
|---|---|
| Заголовок | d3d12.h |