структура D3D11_DEPTH_STENCIL_DESC (d3d11.h)

  • Статья

Описывает состояние трафарета глубины.

Синтаксис

typedef struct D3D11_DEPTH_STENCIL_DESC {
  BOOL                       DepthEnable;
  D3D11_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D11_COMPARISON_FUNC      DepthFunc;
  BOOL                       StencilEnable;
  UINT8                      StencilReadMask;
  UINT8                      StencilWriteMask;
  D3D11_DEPTH_STENCILOP_DESC FrontFace;
  D3D11_DEPTH_STENCILOP_DESC BackFace;
} D3D11_DEPTH_STENCIL_DESC;

Члены

DepthEnable

Тип: BOOL

Включите тестирование глубины.

DepthWriteMask

Тип: D3D11_DEPTH_WRITE_MASK

Определите часть буфера трафарета глубины, которую можно изменить с помощью данных глубины (см. D3D11_DEPTH_WRITE_MASK).

DepthFunc

Тип: D3D11_COMPARISON_FUNC

Функция, которая сравнивает данные глубины с существующими данными глубины. Параметры функции перечислены в D3D11_COMPARISON_FUNC.

StencilEnable

Тип: BOOL

Включите тестирование набора элементов.

StencilReadMask

Тип: UINT8

Определите часть буфера трафарета глубины для чтения данных трафарета.

StencilWriteMask

Тип: UINT8

Определите часть буфера трафарета глубины для записи данных трафарета.

FrontFace

Тип: D3D11_DEPTH_STENCILOP_DESC

Определите, как использовать результаты теста глубины и теста набора элементов для пикселей, поверхность которых обычно обращена к камере (см . D3D11_DEPTH_STENCILOP_DESC).

BackFace

Тип: D3D11_DEPTH_STENCILOP_DESC

Определите, как использовать результаты теста глубины и теста набора элементов для пикселей, поверхность которых обычно обращена от камеры (см . D3D11_DEPTH_STENCILOP_DESC).

Комментарии

Передайте указатель на D3D11_DEPTH_STENCIL_DESC на метод ID3D11Device::CreateDepthStencilState , чтобы создать объект состояния трафарета глубины.

Состояние трафарета глубины управляет тем, как тестирование трафарета глубины выполняется этапом объединения выходных данных.

В следующей таблице показаны значения по умолчанию для состояний трафарета глубины.

Состояние Значение по умолчанию
DepthEnable TRUE
DepthWriteMask D3D11_DEPTH_WRITE_MASK_ALL
DepthFunc D3D11_COMPARISON_LESS
Набор элементов Ложь.
Набор элементовReadMask D3D11_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D11_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc

и

BackFace.StencilFunc

 D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp

и

BackFace.StencilDepthFailOp

 D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp

и

BackFace.StencilPassOp

 D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp

и

BackFace.StencilFailOp

 D3D11_STENCIL_OP_KEEP
 

Форматы, поддерживающие набор элементов, DXGI_FORMAT_D24_UNORM_S8_UINT и DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Требования

Требование Значение
Заголовок d3d11.h

См. также раздел

Основные структуры