Function Prototype
vkCmdBlitImage2
Copy regions of an image, potentially performing format conversion,
To copy regions of a source image into a destination image, potentially performing format conversion, arbitrary scaling, and filtering, call:
void vkCmdBlitImage2KHR(
VkCommandBuffer commandBuffer,
const VkBlitImageInfo2* pBlitImageInfo);
commandBuffer
is the command buffer into which the command will be recorded.pBlitImageInfo
is a pointer to a VkBlitImageInfo2 structure describing the blit parameters.
This command is functionally identical to vkCmdBlitImage, but includes
extensible sub-structures that include sType
and pNext
parameters, allowing them to be more easily extended.
Valid Usage (Implicit)
VUID-vkCmdBlitImage2-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle
VUID-vkCmdBlitImage2-pBlitImageInfo-parameter
pBlitImageInfo
must be a valid pointer to a valid VkBlitImageInfo2 structure
VUID-vkCmdBlitImage2-commandBuffer-recording
commandBuffer
must be in the recording state
VUID-vkCmdBlitImage2-commandBuffer-cmdpool
The VkCommandPool
that commandBuffer
was allocated from must support graphics operations
VUID-vkCmdBlitImage2-renderpass
This command must only be called outside of a render pass instance
VUID-vkCmdBlitImage2-videocoding
This command must only be called outside of a video coding scope
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized - Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized ::