vkCmdCopyImage2
To copy data between image objects, call:
void vkCmdCopyImage2KHR(
VkCommandBuffer commandBuffer,
const VkCopyImageInfo2* pCopyImageInfo);
commandBufferis the command buffer into which the command will be recorded.pCopyImageInfois a pointer to a VkCopyImageInfo2 structure describing the copy parameters.
This command is functionally identical to vkCmdCopyImage, but includes
extensible sub-structures that include sType and pNext
parameters, allowing them to be more easily extended.
Valid Usage
VUID-vkCmdCopyImage2-commandBuffer-10217
If the queue family used to create the VkCommandPool which
commandBuffer was allocated from does not support
VK_QUEUE_GRAPHICS_BIT, for each element of pCopyImageInfo→pRegions, where
the aspectMask member of srcSubresource is
VK_IMAGE_ASPECT_COLOR_BIT, the aspectMask of
dstSubresource must not be VK_IMAGE_ASPECT_DEPTH_BIT or
VK_IMAGE_ASPECT_STENCIL_BIT
VUID-vkCmdCopyImage2-commandBuffer-10218
If the queue family used to create the VkCommandPool which
commandBuffer was allocated from does not support
VK_QUEUE_GRAPHICS_BIT, for each element of pCopyImageInfo→pRegions, where
the aspectMask member of dstSubresource is
VK_IMAGE_ASPECT_COLOR_BIT then the aspectMask of
srcSubresource must not be VK_IMAGE_ASPECT_DEPTH_BIT or
VK_IMAGE_ASPECT_STENCIL_BIT
Valid Usage (Implicit)
VUID-vkCmdCopyImage2-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdCopyImage2-pCopyImageInfo-parameter
pCopyImageInfo must be a valid pointer to a valid VkCopyImageInfo2 structure
VUID-vkCmdCopyImage2-commandBuffer-recording
commandBuffer must be in the recording state
VUID-vkCmdCopyImage2-commandBuffer-cmdpool
The VkCommandPool that commandBuffer was allocated from must support transfer, graphics, or compute operations
VUID-vkCmdCopyImage2-renderpass
This command must only be called outside of a render pass instance
VUID-vkCmdCopyImage2-videocoding
This command must only be called outside of a video coding scope
Host Synchronization
- Host access to
commandBuffermust be externally synchronized - Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized ::