VK_KHR_separate_depth_stencil_layouts

Other Extension Metadata

Last Modified Date

2019-06-25

Contributors

• Daniel Koch, NVIDIA
• Jeff Bolz, NVIDIA
• Jesse Barker, Unity
• Tobias Hector, AMD

Description

This extension allows image memory barriers for depth/stencil images to have just one of the VK_IMAGE_ASPECT_DEPTH_BIT or VK_IMAGE_ASPECT_STENCIL_BIT aspect bits set, rather than require both. This allows their layouts to be set independently. To support depth/stencil images with different layouts for the depth and stencil aspects, the depth/stencil attachment interface has been updated to support a separate layout for stencil.

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.

New Structures

• Extending VkAttachmentDescription2:
  • VkAttachmentDescriptionStencilLayoutKHR
• Extending VkAttachmentReference2:
  • VkAttachmentReferenceStencilLayoutKHR
• Extending VkPhysicalDeviceFeatures2, VkDeviceCreateInfo:
  • VkPhysicalDeviceSeparateDepthStencilLayoutsFeaturesKHR

New Enum Constants

• VK_KHR_SEPARATE_DEPTH_STENCIL_LAYOUTS_EXTENSION_NAME
• VK_KHR_SEPARATE_DEPTH_STENCIL_LAYOUTS_SPEC_VERSION
• Extending VkImageLayout:
  • VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL_KHR
  • VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL_KHR
  • VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL_KHR
  • VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL_KHR
• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_STENCIL_LAYOUT_KHR
  • VK_STRUCTURE_TYPE_ATTACHMENT_REFERENCE_STENCIL_LAYOUT_KHR
  • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SEPARATE_DEPTH_STENCIL_LAYOUTS_FEATURES_KHR

Version History

• Revision 1, 2019-06-25 (Piers Daniell)
  • Internal revisions