struktur D3D11_DEPTH_STENCIL_DESC (d3d11.h)

Menjelaskan status stensil kedalaman.

Sintaks

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;

Anggota

DepthEnable

Jenis: BOOL

Aktifkan pengujian kedalaman.

DepthWriteMask

Jenis: D3D11_DEPTH_WRITE_MASK

Identifikasi sebagian buffer stensil kedalaman yang dapat dimodifikasi oleh data kedalaman (lihat D3D11_DEPTH_WRITE_MASK).

DepthFunc

Jenis: D3D11_COMPARISON_FUNC

Fungsi yang membandingkan data kedalaman dengan data kedalaman yang ada. Opsi fungsi tercantum dalam D3D11_COMPARISON_FUNC.

StencilEnable

Jenis: BOOL

Aktifkan pengujian stensil.

StencilReadMask

Jenis: UINT8

Identifikasi sebagian buffer stensil kedalaman untuk membaca data stensil.

StencilWriteMask

Jenis: UINT8

Identifikasi sebagian buffer stensil kedalaman untuk menulis data stensil.

FrontFace

Jenis: D3D11_DEPTH_STENCILOP_DESC

Identifikasi cara menggunakan hasil uji kedalaman dan uji stensil untuk piksel yang permukaannya normal menghadap ke arah kamera (lihat D3D11_DEPTH_STENCILOP_DESC).

BackFace

Jenis: D3D11_DEPTH_STENCILOP_DESC

Identifikasi cara menggunakan hasil uji kedalaman dan uji stensil untuk piksel yang permukaannya normal menghadap jauh dari kamera (lihat D3D11_DEPTH_STENCILOP_DESC).

Keterangan

Teruskan penunjuk ke D3D11_DEPTH_STENCIL_DESC ke metode ID3D11Device::CreateDepthStencilState untuk membuat objek status depth-stencil.

Status stensil kedalaman mengontrol bagaimana pengujian stensil kedalaman dilakukan oleh tahap output-merger.

Tabel berikut ini memperlihatkan nilai default status stensil kedalaman.

Provinsi	Nilai Default
DepthEnable	TRUE
DepthWriteMask	D3D11_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D11_COMPARISON_LESS
StencilEnable	FALSE
StencilReadMask	D3D11_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D11_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc dan BackFace.StencilFunc	D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp dan BackFace.StencilDepthFailOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp dan BackFace.StencilPassOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp dan BackFace.StencilFailOp	D3D11_STENCIL_OP_KEEP

 

Format yang mendukung stensil DXGI_FORMAT_D24_UNORM_S8_UINT dan DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Persyaratan

Persyaratan	Nilai
Header	d3d11.h

Lihat juga

Struktur Inti