struktur D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)

2024-02-28

Menjelaskan status stensil kedalaman.

Sintaks

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;

Anggota

DepthEnable

Menentukan apakah akan mengaktifkan pengujian kedalaman. Atur anggota ini ke TRUE untuk mengaktifkan pengujian kedalaman.

DepthWriteMask

Nilai yang diketik D3D12_DEPTH_WRITE_MASK yang mengidentifikasi sebagian buffer stensil kedalaman yang dapat dimodifikasi oleh data kedalaman.

DepthFunc

Nilai jenis D3D12_COMPARISON_FUNC yang mengidentifikasi fungsi yang membandingkan data kedalaman dengan data kedalaman yang ada.

StencilEnable

Menentukan apakah akan mengaktifkan pengujian stensil. Atur anggota ini ke TRUE untuk mengaktifkan pengujian stensil.

StencilReadMask

Identifikasi sebagian buffer stensil kedalaman untuk membaca data stensil.

StencilWriteMask

Identifikasi sebagian buffer stensil kedalaman untuk menulis data stensil.

FrontFace

Struktur D3D12_DEPTH_STENCILOP_DESC yang menjelaskan cara menggunakan hasil uji kedalaman dan uji stensil untuk piksel yang permukaannya normal menghadap ke arah kamera.

BackFace

Struktur D3D12_DEPTH_STENCILOP_DESC yang menjelaskan cara menggunakan hasil uji kedalaman dan uji stensil untuk piksel yang permukaannya normal menghadap jauh dari kamera.

DepthBoundsTestEnable

TRUE untuk mengaktifkan pengujian batas kedalaman; jika tidak, FALSE. Nilai defaultnya adalah FALSE.

Keterangan

Objek D3D12_GRAPHICS_PIPELINE_STATE_DESC berisi struktur status stensil kedalaman yang mengontrol bagaimana pengujian stensil kedalaman dilakukan oleh tahap output-merger.

Tabel ini memperlihatkan nilai default status stensil kedalaman.

Provinsi	Nilai Default
DepthEnable	TRUE
DepthWriteMask	D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D12_COMPARISON_LESS
StencilEnable	FALSE
StencilReadMask	D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc dan BackFace.StencilFunc	D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp dan BackFace.StencilDepthFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp dan BackFace.StencilPassOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp dan BackFace.StencilFailOp	D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable	FALSE

Format yang mendukung stensil DXGI_FORMAT_D24_UNORM_S8_UINT dan DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Persyaratan

Persyaratan	Nilai
Header	d3d12.h

Lihat juga

Struktur Inti

Bagikan melalui