// Copyright 2018-2024 The Khronos Group Inc.
//
// SPDX-License-Identifier: CC-BY-4.0

include::{generated}/meta/{refprefix}VK_KHR_depth_stencil_resolve.adoc[]

=== Other Extension Metadata

*Last Modified Date*::
    2018-04-09
*Contributors*::
  - Jan-Harald Fredriksen, Arm
  - Andrew Garrard, Samsung Electronics
  - Soowan Park, Samsung Electronics
  - Jeff Bolz, NVIDIA
  - Daniel Rakos, AMD

=== Description

This extension adds support for automatically resolving multisampled
depth/stencil attachments in a subpass in a similar manner as for color
attachments.

Multisampled color attachments can be resolved at the end of a subpass by
specifying pname:pResolveAttachments entries corresponding to the
pname:pColorAttachments array entries.
This does not allow for a way to map the resolve attachments to the
depth/stencil attachment.
The flink:vkCmdResolveImage command does not allow for depth/stencil images.
While there are other ways to resolve the depth/stencil attachment, they can
give sub-optimal performance.
Extending the sname:VkSubpassDescription2 in this extension allows an
application to add a pname:pDepthStencilResolveAttachment, that is similar
to the color pname:pResolveAttachments, that the
pname:pDepthStencilAttachment can be resolved into.

Depth and stencil samples are resolved to a single value based on the
resolve mode.
The set of possible resolve modes is defined in the
elink:VkResolveModeFlagBits enum.
The ename:VK_RESOLVE_MODE_SAMPLE_ZERO_BIT mode is the only mode that is
required of all implementations (that support the extension or support
Vulkan 1.2 or higher).
Some implementations may also support averaging (the same as color sample
resolve) or taking the minimum or maximum sample, which may be more suitable
for depth/stencil resolve.

=== Promotion to Vulkan 1.2

All functionality in this extension is included in core Vulkan 1.2, with the
KHR suffix omitted.
The original type, enum and command names are still available as aliases of
the core functionality.

include::{generated}/interfaces/VK_KHR_depth_stencil_resolve.adoc[]

ifdef::isrefpage[]

=== Additional Resources

  * GDC 2019
  ** https://www.youtube.com/watch?v=GnnEmJFFC7Q&feature=youtu.be&t=1983[`video`]
  ** https://www.khronos.org/assets/uploads/developers/library/2019-gdc/Vulkan-Depth-Stencil-Resolve-GDC-Mar19.pdf[`slides`]

endif::isrefpage[]

=== Version History

  * Revision 1, 2018-04-09 (Jan-Harald Fredriksen)
  ** Initial revision

