Vulkan.Extensions.VK_KHR_copy_commands2

Name

VK_KHR_copy_commands2 - device extension

VK_KHR_copy_commands2

Name String

VK_KHR_copy_commands2

Extension Type

Device extension

Registered Extension Number

338

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.0

Deprecation state

• Promoted to Vulkan 1.3

Contact

• Jeff Leger @jackohound%0A*Here describe the issue or question you have about the VK_KHR_copy_commands2 extension*

Other Extension Metadata

Last Modified Date

2020-07-06

Interactions and External Dependencies

• Promoted to Vulkan 1.3 Core

Interactions and External Dependencies

• None

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: cmdCopyBuffer2KHR, cmdCopyImage2KHR, cmdCopyBufferToImage2KHR, cmdCopyImageToBuffer2KHR, cmdBlitImage2KHR, and cmdResolveImage2KHR. 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

• cmdBlitImage2KHR

• cmdCopyBuffer2KHR
• cmdCopyBufferToImage2KHR
• cmdCopyImage2KHR
• cmdCopyImageToBuffer2KHR
• cmdResolveImage2KHR

New Structures

• BlitImageInfo2KHR

• BufferCopy2KHR
• BufferImageCopy2KHR
• CopyBufferInfo2KHR
• CopyBufferToImageInfo2KHR
• CopyImageInfo2KHR
• CopyImageToBufferInfo2KHR
• ImageBlit2KHR
• ImageCopy2KHR
• ImageResolve2KHR
• ResolveImageInfo2KHR

New Enum Constants

• KHR_COPY_COMMANDS_2_EXTENSION_NAME

• KHR_COPY_COMMANDS_2_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_BLIT_IMAGE_INFO_2_KHR
  • STRUCTURE_TYPE_BUFFER_COPY_2_KHR
  • STRUCTURE_TYPE_BUFFER_IMAGE_COPY_2_KHR
  • STRUCTURE_TYPE_COPY_BUFFER_INFO_2_KHR
  • STRUCTURE_TYPE_COPY_BUFFER_TO_IMAGE_INFO_2_KHR
  • STRUCTURE_TYPE_COPY_IMAGE_INFO_2_KHR
  • STRUCTURE_TYPE_COPY_IMAGE_TO_BUFFER_INFO_2_KHR
  • STRUCTURE_TYPE_IMAGE_BLIT_2_KHR
  • STRUCTURE_TYPE_IMAGE_COPY_2_KHR
  • STRUCTURE_TYPE_IMAGE_RESOLVE_2_KHR
  • STRUCTURE_TYPE_RESOLVE_IMAGE_INFO_2_KHR

Promotion to Vulkan 1.3

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

Version History

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

  • Internal revisions

See Also

BlitImageInfo2KHR, BufferCopy2KHR, BufferImageCopy2KHR, CopyBufferInfo2KHR, CopyBufferToImageInfo2KHR, CopyImageInfo2KHR, CopyImageToBufferInfo2KHR, ImageBlit2KHR, ImageCopy2KHR, ImageResolve2KHR, ResolveImageInfo2KHR, cmdBlitImage2KHR, cmdCopyBuffer2KHR, cmdCopyBufferToImage2KHR, cmdCopyImage2KHR, cmdCopyImageToBuffer2KHR, cmdResolveImage2KHR

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

pattern STRUCTURE_TYPE_COPY_BUFFER_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_COPY_IMAGE_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_COPY_BUFFER_TO_IMAGE_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_COPY_IMAGE_TO_BUFFER_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_BLIT_IMAGE_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_RESOLVE_IMAGE_INFO_2_KHR :: StructureType

pattern STRUCTURE_TYPE_BUFFER_COPY_2_KHR :: StructureType

pattern STRUCTURE_TYPE_IMAGE_COPY_2_KHR :: StructureType

pattern STRUCTURE_TYPE_IMAGE_BLIT_2_KHR :: StructureType

pattern STRUCTURE_TYPE_BUFFER_IMAGE_COPY_2_KHR :: StructureType

pattern STRUCTURE_TYPE_IMAGE_RESOLVE_2_KHR :: StructureType

cmdCopyBuffer2KHR :: MonadIO io => CommandBuffer -> CopyBufferInfo2 -> io ()

cmdCopyImage2KHR :: MonadIO io => CommandBuffer -> CopyImageInfo2 -> io ()

cmdBlitImage2KHR :: MonadIO io => CommandBuffer -> BlitImageInfo2 -> io ()

cmdCopyBufferToImage2KHR :: MonadIO io => CommandBuffer -> CopyBufferToImageInfo2 -> io ()

cmdCopyImageToBuffer2KHR :: MonadIO io => CommandBuffer -> CopyImageToBufferInfo2 -> io ()

cmdResolveImage2KHR :: MonadIO io => CommandBuffer -> ResolveImageInfo2 -> io ()

type BufferCopy2KHR = BufferCopy2

type ImageCopy2KHR = ImageCopy2

type ImageBlit2KHR = ImageBlit2

type BufferImageCopy2KHR = BufferImageCopy2

type ImageResolve2KHR = ImageResolve2

type CopyBufferInfo2KHR = CopyBufferInfo2

type CopyImageInfo2KHR = CopyImageInfo2

type BlitImageInfo2KHR = BlitImageInfo2

type CopyBufferToImageInfo2KHR = CopyBufferToImageInfo2

type CopyImageToBufferInfo2KHR = CopyImageToBufferInfo2

type ResolveImageInfo2KHR = ResolveImageInfo2

type KHR_COPY_COMMANDS_2_SPEC_VERSION = 1

pattern KHR_COPY_COMMANDS_2_SPEC_VERSION :: forall a. Integral a => a

type KHR_COPY_COMMANDS_2_EXTENSION_NAME = "VK_KHR_copy_commands2"

pattern KHR_COPY_COMMANDS_2_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a