1// Copyright 2016-2023 The Khronos Group Inc.
2//
3// SPDX-License-Identifier: CC-BY-4.0
4
5include::{generated}/meta/{refprefix}VK_KHR_copy_commands2.adoc[]
6
7=== Other Extension Metadata
8
9*Last Modified Date*::
10    2020-07-06
11*Interactions and External Dependencies*::
12  - Promoted to Vulkan 1.3 Core
13*Interactions and External Dependencies*::
14  - None
15*Contributors*::
16  - Jeff Leger, Qualcomm
17  - Tobias Hector, AMD
18  - Jan-Harald Fredriksen, ARM
19  - Tom Olson, ARM
20
21=== Description
22
23This extension provides extensible versions of the Vulkan buffer and image
24copy commands.
25The new commands are functionally identical to the core commands, except
26that their copy parameters are specified using extensible structures that
27can be used to pass extension-specific information.
28
29The following extensible copy commands are introduced with this extension:
30flink:vkCmdCopyBuffer2KHR, flink:vkCmdCopyImage2KHR,
31flink:vkCmdCopyBufferToImage2KHR, flink:vkCmdCopyImageToBuffer2KHR,
32flink:vkCmdBlitImage2KHR, and flink:vkCmdResolveImage2KHR.
33Each command contains an stext:*Info2KHR structure parameter that includes
34ptext:sType/ptext:pNext members.
35Lower level structures describing each region to be copied are also extended
36with ptext:sType/ptext:pNext members.
37
38include::{generated}/interfaces/VK_KHR_copy_commands2.adoc[]
39
40=== Promotion to Vulkan 1.3
41
42Functionality in this extension is included in core Vulkan 1.3, with the KHR
43suffix omitted.
44The original type, enum and command names are still available as aliases of
45the core functionality.
46
47=== Version History
48
49  * Revision 1, 2020-07-06 (Jeff Leger)
50  ** Internal revisions
51