Structures

VkImageBlit2

Structure specifying an image blit operation

The VkImageBlit2 structure is defined as:

typedef struct VkImageBlit2 {
    VkStructureType sType;
    const void* pNext;
    VkImageSubresourceLayers srcSubresource;
    VkOffset3D srcOffsets[2];
    VkImageSubresourceLayers dstSubresource;
    VkOffset3D dstOffsets[2];
} VkImageBlit2;

or the equivalent

typedef VkImageBlit2 VkImageBlit2KHR;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • srcSubresource is the subresource to blit from.
  • srcOffsets is a pointer to an array of two VkOffset3D structures specifying the bounds of the source region within srcSubresource.
  • dstSubresource is the subresource to blit into.
  • dstOffsets is a pointer to an array of two VkOffset3D structures specifying the bounds of the destination region within dstSubresource.

For each element of the pRegions array, a blit operation is performed for the specified source and destination regions.

Valid Usage

VUID-VkImageBlit2-aspectMask-00238

The aspectMask member of srcSubresource and dstSubresource must match

VUID-VkImageBlit2-layerCount-08800

If neither of the layerCount members of srcSubresource or dstSubresource are VK_REMAINING_ARRAY_LAYERS, the layerCount members of srcSubresource or dstSubresourcemust match

VUID-VkImageBlit2-layerCount-08801

If one of the layerCount members of srcSubresource or dstSubresource is VK_REMAINING_ARRAY_LAYERS, the other member must be either VK_REMAINING_ARRAY_LAYERS or equal to the arrayLayers member of the VkImageCreateInfo used to create the image minus baseArrayLayer

Valid Usage (Implicit)

VUID-VkImageBlit2-sType-sType

sType must be VK_STRUCTURE_TYPE_IMAGE_BLIT_2

VUID-VkImageBlit2-pNext-pNext

pNext must be NULL or a pointer to a valid instance of VkCopyCommandTransformInfoQCOM

VUID-VkImageBlit2-sType-unique

The sType value of each struct in the pNext chain must be unique