Structures

VkImageCopy2

Structure specifying an image copy operation

The VkImageCopy2 structure is defined as:

typedef struct VkImageCopy2 {
    VkStructureType sType;
    const void* pNext;
    VkImageSubresourceLayers srcSubresource;
    VkOffset3D srcOffset;
    VkImageSubresourceLayers dstSubresource;
    VkOffset3D dstOffset;
    VkExtent3D extent;
} VkImageCopy2;

or the equivalent

typedef VkImageCopy2 VkImageCopy2KHR;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • srcSubresource and dstSubresource are VkImageSubresourceLayers structures specifying the image subresources of the images used for the source and destination image data, respectively.
  • srcOffset and dstOffset select the initial x, y, and z offsets in texels of the sub-regions of the source and destination image data.
  • extent is the size in texels of the image to copy in width, height and depth.

Valid Usage

VUID-VkImageCopy2-apiVersion-07940

If the VK_KHR_sampler_ycbcr_conversion extension is not enabled, and the aspectMask member of srcSubresource and dstSubresourcemust match

VUID-VkImageCopy2-apiVersion-07941

If the VK_KHR_maintenance1 extension is not enabled, and the layerCount member of srcSubresource and dstSubresourcemust match

VUID-VkImageCopy2-extent-06668

extent.width must not be 0

VUID-VkImageCopy2-extent-06669

extent.height must not be 0

VUID-VkImageCopy2-extent-06670

extent.depth must not be 0

Valid Usage (Implicit)

VUID-VkImageCopy2-sType-sType

sType must be VK_STRUCTURE_TYPE_IMAGE_COPY_2