VK_KHR_copy_commands2

Other Extension Metadata

Last Modified Date

2020-07-06

Contributors

• Jeff Leger, Qualcomm
• Tobias Hector, AMD
• Jan-Harald Fredriksen, ARM
• Tom Olson, ARM

Description

This extension provides extensible versions of the Vulkan buffer and image copy commands. The new commands are functionally identical to the core commands, except that their copy parameters are specified using extensible structures that can be used to pass extension-specific information.

The following extensible copy commands are introduced with this extension: vkCmdCopyBuffer2KHR, vkCmdCopyImage2KHR, vkCmdCopyBufferToImage2KHR, vkCmdCopyImageToBuffer2KHR, vkCmdBlitImage2KHR, and vkCmdResolveImage2KHR. Each command contains an *Info2KHR structure parameter that includes sType/pNext members. Lower level structures describing each region to be copied are also extended with sType/pNext members.

New Commands

• vkCmdBlitImage2KHR
• vkCmdCopyBuffer2KHR
• vkCmdCopyBufferToImage2KHR
• vkCmdCopyImage2KHR
• vkCmdCopyImageToBuffer2KHR
• vkCmdResolveImage2KHR

New Structures

• VkBlitImageInfo2KHR
• VkBufferCopy2KHR
• VkBufferImageCopy2KHR
• VkCopyBufferInfo2KHR
• VkCopyBufferToImageInfo2KHR
• VkCopyImageInfo2KHR
• VkCopyImageToBufferInfo2KHR
• VkImageBlit2KHR
• VkImageCopy2KHR
• VkImageResolve2KHR
• VkResolveImageInfo2KHR

New Enum Constants

• VK_KHR_COPY_COMMANDS_2_EXTENSION_NAME
• VK_KHR_COPY_COMMANDS_2_SPEC_VERSION
• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_BLIT_IMAGE_INFO_2_KHR
  • VK_STRUCTURE_TYPE_BUFFER_COPY_2_KHR
  • VK_STRUCTURE_TYPE_BUFFER_IMAGE_COPY_2_KHR
  • VK_STRUCTURE_TYPE_COPY_BUFFER_INFO_2_KHR
  • VK_STRUCTURE_TYPE_COPY_BUFFER_TO_IMAGE_INFO_2_KHR
  • VK_STRUCTURE_TYPE_COPY_IMAGE_INFO_2_KHR
  • VK_STRUCTURE_TYPE_COPY_IMAGE_TO_BUFFER_INFO_2_KHR
  • VK_STRUCTURE_TYPE_IMAGE_BLIT_2_KHR
  • VK_STRUCTURE_TYPE_IMAGE_COPY_2_KHR
  • VK_STRUCTURE_TYPE_IMAGE_RESOLVE_2_KHR
  • VK_STRUCTURE_TYPE_RESOLVE_IMAGE_INFO_2_KHR

Promotion to Vulkan 1.3

Vulkan APIs in this extension are included in core Vulkan 1.3, with the KHR suffix omitted. External interactions defined by this extension, such as SPIR-V token names, retain their original names. The original Vulkan API names are still available as aliases of the core functionality.

Version History

• Revision 1, 2020-07-06 (Jeff Leger)
  • Internal revisions