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 |