VkCopyImageToImageInfoEXT(3)

C Specification

The VkCopyImageToImageInfoEXT structure is defined as:

// Provided by VK_EXT_host_image_copy
typedef struct VkCopyImageToImageInfoEXT {
    VkStructureType            sType;
    const void*                pNext;
    VkHostImageCopyFlagsEXT    flags;
    VkImage                    srcImage;
    VkImageLayout              srcImageLayout;
    VkImage                    dstImage;
    VkImageLayout              dstImageLayout;
    uint32_t                   regionCount;
    const VkImageCopy2*        pRegions;
} VkCopyImageToImageInfoEXT;

Members

sType is a VkStructureType value identifying this structure.
pNext is NULL or a pointer to a structure extending this structure.
flags is a bitmask of VkHostImageCopyFlagBitsEXT values describing additional copy parameters.
srcImage is the source image.
srcImageLayout is the layout of the source image subresources for the copy.
dstImage is the destination image.
dstImageLayout is the layout of the destination image subresources for the copy.
regionCount is the number of regions to copy.
pRegions is a pointer to an array of VkImageCopy2 structures specifying the regions to copy.

Description

vkCopyImageToImageEXT does not check whether the device memory associated with srcImage or dstImage is currently in use before performing the copy. The application must guarantee that any previously submitted command that writes to the copy regions has completed before the host performs the copy.

Valid Usage

VUID-VkCopyImageToImageInfoEXT-srcImage-09069
srcImage and dstImage must have been created with identical image creation parameters

VUID-VkCopyImageToImageInfoEXT-srcImage-09109
If srcImage is sparse then all memory ranges accessed by the copy command must be bound as described in Binding Resource Memory
VUID-VkCopyImageToImageInfoEXT-srcImage-09111
If the stencil aspect of srcImage is accessed, and srcImage was not created with separate stencil usage, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageCreateInfo::usage
VUID-VkCopyImageToImageInfoEXT-srcImage-09112
If the stencil aspect of srcImage is accessed, and srcImage was created with separate stencil usage, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageStencilUsageCreateInfo::stencilUsage
VUID-VkCopyImageToImageInfoEXT-srcImage-09113
If non-stencil aspects of srcImage are accessed, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageCreateInfo::usage
VUID-VkCopyImageToImageInfoEXT-srcOffset-09114
If flags contains VK_HOST_IMAGE_COPY_MEMCPY_EXT, the x, y, and z members of the srcOffset member of each element of pRegions must be 0
VUID-VkCopyImageToImageInfoEXT-srcImage-09115
If flags contains VK_HOST_IMAGE_COPY_MEMCPY_EXT, the extent member of each element of pRegions must equal the extents of srcImage identified by srcSubresource

VUID-VkCopyImageToImageInfoEXT-srcImage-07966
If srcImage is non-sparse then the image or the specified disjoint plane must be bound completely and contiguously to a single VkDeviceMemory object
VUID-VkCopyImageToImageInfoEXT-srcSubresource-07967
The srcSubresource.mipLevel member of each element of pRegions must be less than the mipLevels specified in VkImageCreateInfo when srcImage was created
VUID-VkCopyImageToImageInfoEXT-srcSubresource-07968
The srcSubresource.baseArrayLayer + srcSubresource.layerCount of each element of pRegions , if srcSubresource.layerCount is not VK_REMAINING_ARRAY_LAYERS and maintenance5 is not enabled, must be less than or equal to the arrayLayers specified in VkImageCreateInfo when srcImage was created
VUID-VkCopyImageToImageInfoEXT-srcImage-07969
srcImage must not have been created with flags containing VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT

VUID-VkCopyImageToImageInfoEXT-srcSubresource-07970
The image region specified by each element of pRegions must be contained within the specified srcSubresource of srcImage
VUID-VkCopyImageToImageInfoEXT-srcSubresource-07971
For each element of pRegions, srcOffset.x and (extent.width + srcOffset.x) must both be greater than or equal to 0 and less than or equal to the width of the specified srcSubresource of srcImage
VUID-VkCopyImageToImageInfoEXT-srcSubresource-07972
For each element of pRegions, srcOffset.y and (extent.height + srcOffset.y) must both be greater than or equal to 0 and less than or equal to the height of the specified srcSubresource of srcImage

VUID-VkCopyImageToImageInfoEXT-srcImage-07979
If srcImage is of type VK_IMAGE_TYPE_1D, then for each element of pRegions, srcOffset.y must be 0 and extent.height must be 1
VUID-VkCopyImageToImageInfoEXT-srcOffset-09104
For each element of pRegions, srcOffset.z and (extent.depth + srcOffset.z) must both be greater than or equal to 0 and less than or equal to the depth of the specified srcSubresource of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-07980
If srcImage is of type VK_IMAGE_TYPE_1D or VK_IMAGE_TYPE_2D, then for each element of pRegions, srcOffset.z must be 0 and extent.depth must be 1
VUID-VkCopyImageToImageInfoEXT-srcImage-07274
For each element of pRegions, srcOffset.x must be a multiple of the texel block extent width of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-07275
For each element of pRegions, srcOffset.y must be a multiple of the texel block extent height of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-07276
For each element of pRegions, srcOffset.z must be a multiple of the texel block extent depth of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-00207
For each element of pRegions, if the sum of srcOffset.x and extent.width does not equal the width of the subresource specified by srcSubresource, extent.width must be a multiple of the texel block extent width of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-00208
For each element of pRegions, if the sum of srcOffset.y and extent.height does not equal the height of the subresource specified by srcSubresource, extent.height must be a multiple of the texel block extent height of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-00209
For each element of pRegions, if the sum of srcOffset.z and extent.depth does not equal the depth of the subresource specified by srcSubresource, extent.depth must be a multiple of the texel block extent depth of the VkFormat of srcImage
VUID-VkCopyImageToImageInfoEXT-srcSubresource-09105
For each element of pRegions, srcSubresource.aspectMask must specify aspects present in srcImage
VUID-VkCopyImageToImageInfoEXT-srcImage-07981
If srcImage has a multi-planar image format, then for each element of pRegions, srcSubresource.aspectMask must be a single valid multi-planar aspect mask bit
VUID-VkCopyImageToImageInfoEXT-srcImage-07983
If srcImage is of type VK_IMAGE_TYPE_3D, for each element of pRegions, srcSubresource.baseArrayLayer must be 0 and srcSubresource.layerCount must be 1

VUID-VkCopyImageToImageInfoEXT-dstImage-09109
If dstImage is sparse then all memory ranges accessed by the copy command must be bound as described in Binding Resource Memory
VUID-VkCopyImageToImageInfoEXT-dstImage-09111
If the stencil aspect of dstImage is accessed, and dstImage was not created with separate stencil usage, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageCreateInfo::usage
VUID-VkCopyImageToImageInfoEXT-dstImage-09112
If the stencil aspect of dstImage is accessed, and dstImage was created with separate stencil usage, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageStencilUsageCreateInfo::stencilUsage
VUID-VkCopyImageToImageInfoEXT-dstImage-09113
If non-stencil aspects of dstImage are accessed, the image must have been created with VK_IMAGE_USAGE_HOST_TRANSFER_BIT_EXT set in VkImageCreateInfo::usage
VUID-VkCopyImageToImageInfoEXT-dstOffset-09114
If flags contains VK_HOST_IMAGE_COPY_MEMCPY_EXT, the x, y, and z members of the dstOffset member of each element of pRegions must be 0
VUID-VkCopyImageToImageInfoEXT-dstImage-09115
If flags contains VK_HOST_IMAGE_COPY_MEMCPY_EXT, the extent member of each element of pRegions must equal the extents of dstImage identified by dstSubresource

VUID-VkCopyImageToImageInfoEXT-dstImage-07966
If dstImage is non-sparse then the image or the specified disjoint plane must be bound completely and contiguously to a single VkDeviceMemory object
VUID-VkCopyImageToImageInfoEXT-dstSubresource-07967
The dstSubresource.mipLevel member of each element of pRegions must be less than the mipLevels specified in VkImageCreateInfo when dstImage was created
VUID-VkCopyImageToImageInfoEXT-dstSubresource-07968
The dstSubresource.baseArrayLayer + dstSubresource.layerCount of each element of pRegions , if dstSubresource.layerCount is not VK_REMAINING_ARRAY_LAYERS and maintenance5 is not enabled, must be less than or equal to the arrayLayers specified in VkImageCreateInfo when dstImage was created
VUID-VkCopyImageToImageInfoEXT-dstImage-07969
dstImage must not have been created with flags containing VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT

VUID-VkCopyImageToImageInfoEXT-dstSubresource-07970
The image region specified by each element of pRegions must be contained within the specified dstSubresource of dstImage
VUID-VkCopyImageToImageInfoEXT-dstSubresource-07971
For each element of pRegions, dstOffset.x and (extent.width + dstOffset.x) must both be greater than or equal to 0 and less than or equal to the width of the specified dstSubresource of dstImage
VUID-VkCopyImageToImageInfoEXT-dstSubresource-07972
For each element of pRegions, dstOffset.y and (extent.height + dstOffset.y) must both be greater than or equal to 0 and less than or equal to the height of the specified dstSubresource of dstImage

VUID-VkCopyImageToImageInfoEXT-dstImage-07979
If dstImage is of type VK_IMAGE_TYPE_1D, then for each element of pRegions, dstOffset.y must be 0 and extent.height must be 1
VUID-VkCopyImageToImageInfoEXT-dstOffset-09104
For each element of pRegions, dstOffset.z and (extent.depth + dstOffset.z) must both be greater than or equal to 0 and less than or equal to the depth of the specified dstSubresource of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-07980
If dstImage is of type VK_IMAGE_TYPE_1D or VK_IMAGE_TYPE_2D, then for each element of pRegions, dstOffset.z must be 0 and extent.depth must be 1
VUID-VkCopyImageToImageInfoEXT-dstImage-07274
For each element of pRegions, dstOffset.x must be a multiple of the texel block extent width of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-07275
For each element of pRegions, dstOffset.y must be a multiple of the texel block extent height of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-07276
For each element of pRegions, dstOffset.z must be a multiple of the texel block extent depth of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-00207
For each element of pRegions, if the sum of dstOffset.x and extent.width does not equal the width of the subresource specified by srcSubresource, extent.width must be a multiple of the texel block extent width of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-00208
For each element of pRegions, if the sum of dstOffset.y and extent.height does not equal the height of the subresource specified by srcSubresource, extent.height must be a multiple of the texel block extent height of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-00209
For each element of pRegions, if the sum of dstOffset.z and extent.depth does not equal the depth of the subresource specified by srcSubresource, extent.depth must be a multiple of the texel block extent depth of the VkFormat of dstImage
VUID-VkCopyImageToImageInfoEXT-dstSubresource-09105
For each element of pRegions, dstSubresource.aspectMask must specify aspects present in dstImage
VUID-VkCopyImageToImageInfoEXT-dstImage-07981
If dstImage has a multi-planar image format, then for each element of pRegions, dstSubresource.aspectMask must be a single valid multi-planar aspect mask bit
VUID-VkCopyImageToImageInfoEXT-dstImage-07983
If dstImage is of type VK_IMAGE_TYPE_3D, for each element of pRegions, dstSubresource.baseArrayLayer must be 0 and dstSubresource.layerCount must be 1
VUID-VkCopyImageToImageInfoEXT-srcImageLayout-09070
srcImageLayout must specify the current layout of the image subresources of srcImage specified in pRegions
VUID-VkCopyImageToImageInfoEXT-dstImageLayout-09071
dstImageLayout must specify the current layout of the image subresources of dstImage specified in pRegions
VUID-VkCopyImageToImageInfoEXT-srcImageLayout-09072
srcImageLayout must be one of the image layouts returned in VkPhysicalDeviceHostImageCopyPropertiesEXT::pCopySrcLayouts
VUID-VkCopyImageToImageInfoEXT-dstImageLayout-09073
dstImageLayout must be one of the image layouts returned in VkPhysicalDeviceHostImageCopyPropertiesEXT::pCopyDstLayouts

Valid Usage (Implicit)

VUID-VkCopyImageToImageInfoEXT-sType-sType
sType must be VK_STRUCTURE_TYPE_COPY_IMAGE_TO_IMAGE_INFO_EXT
VUID-VkCopyImageToImageInfoEXT-pNext-pNext
pNext must be NULL
VUID-VkCopyImageToImageInfoEXT-flags-parameter
flags must be a valid combination of VkHostImageCopyFlagBitsEXT values
VUID-VkCopyImageToImageInfoEXT-srcImage-parameter
srcImage must be a valid VkImage handle
VUID-VkCopyImageToImageInfoEXT-srcImageLayout-parameter
srcImageLayout must be a valid VkImageLayout value
VUID-VkCopyImageToImageInfoEXT-dstImage-parameter
dstImage must be a valid VkImage handle
VUID-VkCopyImageToImageInfoEXT-dstImageLayout-parameter
dstImageLayout must be a valid VkImageLayout value
VUID-VkCopyImageToImageInfoEXT-pRegions-parameter
pRegions must be a valid pointer to an array of regionCount valid VkImageCopy2 structures
VUID-VkCopyImageToImageInfoEXT-regionCount-arraylength
regionCount must be greater than 0
VUID-VkCopyImageToImageInfoEXT-commonparent
Both of dstImage, and srcImage must have been created, allocated, or retrieved from the same VkDevice

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

SPDX-License-Identifier: CC-BY-4.0

VkCopyImageToImageInfoEXT(3) Manual Page

Name

C Specification

Members

Description

See Also

Document Notes

Copyright