VK_KHR_copy_commands2(3)

# VK_KHR_copy_commands2(3) Manual Page

## Name

VK_KHR_copy_commands2 - device extension

Loading… please wait.

## Registered Extension Number

338

## Revision

1

## Extension and Version Dependencies

- Requires Vulkan 1.0

### Other Extension Metadata

Last Modified Date

  2020-07-06

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: vkCmdCopyBuffer2KHR, vkCmdCopyImage2KHR, vkCmdCopyBufferToImage2KHR, vkCmdCopyImageToBuffer2KHR, vkCmdBlitImage2KHR, and vkCmdResolveImage2KHR. Each command contain`*Info2KHR` structure parameter that includes `sType`/`pNext` members. Lower level structures that describe 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`

### Version History

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

  - Internal revisions

## See Also

VkBlitImageInfo2KHR, VkBufferCopy2KHR, VkBufferImageCopy2KHR, VkCopyBufferInfo2KHR, VkCopyBufferToImageInfo2KHR, VkCopyImageInfo2KHR, VkCopyImageToBufferInfo2KHR, VkImageBlit2KHR, VkImageCopy2KHR, VkImageResolve2KHR, VkResolveImageInfo2KHR, vkCmdBlitImage2KHR, vkCmdCopyBuffer2KHR, vkCmdCopyBufferToImage2KHR, vkCmdCopyImage2KHR, vkCmdCopyImageToBuffer2KHR, vkCmdResolveImage2KHR

## 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.

## Copyright

Copyright 2014-2021 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0