【D3D12学习手记】4.3.8 Create the Depth/Stencil Buffer and View

我们现在需要创建深度/模板缓冲区。 如§4.1.5所述，深度缓冲区只是一个2D纹理，用于存储最近的可见对象的深度信息（如果使用模板(stencil)，则也会存储模板信息）。 纹理是一种GPU资源，因此我们通过填写描述纹理资源的D3D12_RESOURCE_DESC结构，然后调用ID3D12Device :: CreateCommittedResource方法来创建一个。 D3D12_RESOURCE_DESC结构定义如下：

typedef struct D3D12_RESOURCE_DESC {
  D3D12_RESOURCE_DIMENSION Dimension;
  UINT64 Alignment;
  UINT64 Width;
  UINT Height;
  UINT16 DepthOrArraySize;
  UINT16 MipLevels;
  DXGI_FORMAT Format;
  DXGI_SAMPLE_DESC SampleDesc;
  D3D12_TEXTURE_LAYOUT Layout;
  D3D12_RESOURCE_MISC_FLAG MiscFlags;
} D3D12_RESOURCE_DESC;

1.Dimension：资源的维度，它是以下枚举类型之一：

enum D3D12_RESOURCE_DIMENSION
  {
    D3D12_RESOURCE_DIMENSION_UNKNOWN = 0，
    D3D12_RESOURCE_DIMENSION_BUFFER = 1，
    D3D12_RESOURCE_DIMENSION_TEXTURE1D = 2，
    D3D12_RESOURCE_DIMENSION_TEXTURE2D = 3，
    D3D12_RESOURCE_DIMENSION_TEXTURE3D = 4
  } D3D12_RESOURCE_DIMENSION;

2.Width：纹理的宽度，以纹素为单位。对于缓冲区资源，这是缓冲区中的字节数。

3.Height：纹理的高度，以纹素为单位。

4.DepthOrArraySize：纹理的纹理深度，或纹理数组大小（对于1D和2D纹理）。请注意，您不能拥有3D纹理的纹理数组。

5.MipLevels：mipmap级别的数量。有关纹理的第9章介绍了Mipmap。为了创建深度/模板缓冲区，我们的纹理只需要一个mipmap级别。
格式：DXGI_FORMAT枚举类型的成员，指定纹素的格式。对于深度/模板缓冲区，这需要是§4.1.5中所示的格式之一。

6.SampleDesc：多重采样和质量等级的数量;见§4.1.7和§4.1.8。回想一下，4X MSAA使用比屏幕分辨率大4倍的后缓冲和深度缓冲，以便存储每个子像素的颜色和深度/模板信息。因此，用于深度/模板缓冲区的多重采样设置必须与用于渲染目标的设置相匹配。

7.Layout：D3D12_TEXTURE_LAYOUT枚举类型的成员，指定纹理布局。目前，我们不必担心布局，可以指定D3D12_TEXTURE_LAYOUT_UNKNOWN

8.MiscFlags：杂项资源标志。对于深度/模板缓冲区资源，请指定D3D12_RESOURCE_MISC_DEPTH_STENCIL。

GPU资源存在于堆中，这些资源本质上是具有某些属性的GPU内存块。 ID3D12Device :: CreateCommittedResource方法将我们指定了属性的资源创建并提交给内存块：

HRESULT ID3D12Device::CreateCommittedResource(
  const D3D12_HEAP_PROPERTIES *pHeapProperties,
  D3D12_HEAP_MISC_FLAG HeapMiscFlags,
  const D3D12_RESOURCE_DESC *pResourceDesc,
  D3D12_RESOURCE_USAGE InitialResourceState,
  const D3D12_CLEAR_VALUE *pOptimizedClearValue,
  REFIID riidResource,
  void **ppvResource);

typedef struct D3D12_HEAP_PROPERTIES {
 D3D12_HEAP_TYPE     Type;
 D3D12_CPU_PAGE_PROPERTIES CPUPageProperties;
 D3D12_MEMORY_POOL    MemoryPoolPreference;
 UINT CreationNodeMask;
 UINT VisibleNodeMask;
} D3D12_HEAP_PROPERTIES;

1.pHeapProperties：我们要将资源提交到的堆的属性。其中一些属性用于高级用法。目前，我们需要考虑的主要属性是D3D12_HEAP_TYPE，它可以是D3D12_HEAP_PROPERTIES枚举类型的以下成员之一：
　　D3D12_HEAP_TYPE_DEFAULT：默认堆。这是我们提交的资源将只由GPU单独访问的地方。以深度/模板缓冲区为例：GPU读取和写入深度/模板缓冲区。 CPU永远不需要访问它，因此深度/模板缓冲区将被放置在默认堆中；
　　D3D12_HEAP_TYPE_UPLOAD：上传堆。如果我们需要将数据从CPU上传到GPU，我们需要将资源提交到这里；
　　D3D12_HEAP_TYPE_READBACK：回读堆(Read-back heap)。如果我们提交的资源需要被CPU读取，我们就将资源提交到这里；
　　D3D12_HEAP_TYPE_CUSTOM：高级场景使用，请参阅MSDN文档以获取更多信息。

旁注：应将资源放在默认堆中以获得最佳性能。 仅在需要相应功能时才使用上传或回读堆。
2.HeapMiscFlags：有关我们要将资源提交到的堆的其他标志。这通常是D3D12_HEAP_MISC_NONE。
3.pResourceDesc：指向描述我们要创建的资源的D3D12_RESOURCE_DESC实例的指针。
4.InitialResourceState：回顾§4.2.3资源具有当前使用状态。使用此参数可在创建资源时设置资源的初始状态。对于深度/模板缓冲区，初始状态将为D3D12_RESOURCE_USAGE_INITIAL，然后我们将要将其转换为D3D12_RESOURCE_USAGE_DEPTH，以便它可以作为深度/模板缓冲区绑定到管道。
5.pOptimizedClearValue：指向D3D12_CLEAR_VALUE对象的指针，该对象描述清除资源的优化值。与优化的清除值匹配的清除呼叫可能比与优化的清除值不匹配的清除呼叫更快。也可以为此值指定Null，以不指定优化的清除值。

struct D3D12_CLEAR_VALUE
{
    DXGI_FORMAT Format;
    union {
      FLOAT Color[  ];
      D3D12_DEPTH_STENCIL_VALUE DepthStencil;
    };
}D3D12_CLEAR_VALUE;

6.riidResource：我们想要获取指针的ID3D12Resource接口的COM ID。
7.ppvResource：返回指向ID3D12Resource的指针，该ID3D12Resource表示新创建的资源。

此外，在使用深度/模板缓冲区之前，我们必须创建一个关联的深度/模板视图以绑定到管道。 这与创建渲染目标视图类似。 下面的代码示例显示了我们如何创建深度/模板纹理及其相应的深度/模板视图：

// Create the depth/stencil buffer and view.
D3D12_RESOURCE_DESC depthStencilDesc;
depthStencilDesc.Dimension = D3D12_RESOURCE_DIMENSION_TEXTURE2D;
depthStencilDesc.Alignment = ;
depthStencilDesc.Width = mClientWidth;
depthStencilDesc.Height = mClientHeight;
depthStencilDesc.DepthOrArraySize = ;
depthStencilDesc.MipLevels = ;
depthStencilDesc.Format = mDepthStencilFormat;
depthStencilDesc.SampleDesc.Count = m4xMsaaState ?  : ;
depthStencilDesc.SampleDesc.Quality = m4xMsaaState ? (m4xMsaaQuality - ) : ;
depthStencilDesc.Layout = D3D12_TEXTURE_LAYOUT_UNKNOWN;
depthStencilDesc.Flags = D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL;

D3D12_CLEAR_VALUE optClear;
optClear.Format = mDepthStencilFormat;
optClear.DepthStencil.Depth = 1.0f;
optClear.DepthStencil.Stencil = ;
ThrowIfFailed(md3dDevice->CreateCommittedResource(
  &CD3DX12_HEAP_PROPERTIES(D3D12_HEAP_TYPE_DEFAULT),
  D3D12_HEAP_FLAG_NONE,
  &depthStencilDesc,
  D3D12_RESOURCE_STATE_COMMON,
  &optClear,
  IID_PPV_ARGS(mDepthStencilBuffer.GetAddressOf())));
// Create descriptor to mip level 0 of entire resource using the
// format of the resource.
md3dDevice->CreateDepthStencilView(
  mDepthStencilBuffer.Get(),
  nullptr,
  DepthStencilView());

// Transition the resource from its initial state to be used as a depth buffer.
mCommandList->ResourceBarrier(
  ,
  &CD3DX12_RESOURCE_BARRIER::Transition(
    mDepthStencilBuffer.Get(),
    D3D12_RESOURCE_STATE_COMMON,
    D3D12_RESOURCE_STATE_DEPTH_WRITE));
Note that we use the CD3DX12_HEAP_PROPERTIES helper constructor to create the heap properties structure, which is implemented like so:
explicit CD3DX12_HEAP_PROPERTIES(
    D3D12_HEAP_TYPE type,
    UINT creationNodeMask = ,
    UINT nodeMask =  )
{
  Type = type;
  CPUPageProperty = D3D12_CPU_PAGE_PROPERTY_UNKNOWN;
  MemoryPoolPreference = D3D12_MEMORY_POOL_UNKNOWN;
  CreationNodeMask = creationNodeMask;
  VisibleNodeMask = nodeMask;
}

CreateDepthStencilView的第二个参数是指向D3D12_DEPTH_STENCIL_VIEW_DESC的指针。 除此之外，该结构描述了资源中元素的数据类型（格式）。 如果资源是使用类型化格式（即非无类型）创建的，则此参数可以为null，这表示创建此资源的第一个mipmap级别的视图（深度/模板缓冲区仅使用一个mipmap级别创建 ）使用创建资源的格式。 （Mipmap在第9章中讨论。）因为我们指定了深度/模板缓冲区的类型，所以我们为此参数指定null。