vkCreateImage - Create a new image object

Valid Usage

• device must support at least one queue family with one of the VK_QUEUE_VIDEO_ENCODE_BIT_KHR, VK_QUEUE_VIDEO_DECODE_BIT_KHR, QUEUE_OPTICAL_FLOW_BIT_NV, QUEUE_SPARSE_BINDING_BIT, QUEUE_TRANSFER_BIT, QUEUE_COMPUTE_BIT, or QUEUE_GRAPHICS_BIT capabilities

• If the flags member of pCreateInfo includes IMAGE_CREATE_SPARSE_BINDING_BIT, and the extendedSparseAddressSpace feature is not enabled, creating this Image must not cause the total required sparse memory for all currently valid sparse resources on the device to exceed PhysicalDeviceLimits::sparseAddressSpaceSize
• If the flags member of pCreateInfo includes IMAGE_CREATE_SPARSE_BINDING_BIT, the extendedSparseAddressSpace feature is enabled, and the usage member of pCreateInfo contains bits not in PhysicalDeviceExtendedSparseAddressSpacePropertiesNV::extendedSparseImageUsageFlags, creating this Image must not cause the total required sparse memory for all currently valid sparse resources on the device, excluding Buffer created with usage member of pCreateInfo containing bits in PhysicalDeviceExtendedSparseAddressSpacePropertiesNV::extendedSparseBufferUsageFlags and Image created with usage member of pCreateInfo containing bits in PhysicalDeviceExtendedSparseAddressSpacePropertiesNV::extendedSparseImageUsageFlags, to exceed PhysicalDeviceLimits::sparseAddressSpaceSize
• If the flags member of pCreateInfo includes IMAGE_CREATE_SPARSE_BINDING_BIT and the extendedSparseAddressSpace feature is enabled, creating this Image must not cause the total required sparse memory for all currently valid sparse resources on the device to exceed PhysicalDeviceExtendedSparseAddressSpacePropertiesNV::extendedSparseAddressSpaceSize
• If a BufferCollectionImageCreateInfoFUCHSIA has been chained to pNext, pCreateInfo must match the Sysmem chosen excepting members ImageCreateInfo::extent and ImageCreateInfo::usage in the match criteria

Valid Usage (Implicit)

• device must be a valid Device handle

• pCreateInfo must be a valid pointer to a valid ImageCreateInfo structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pImage must be a valid pointer to a Image handle
• The device must have been created with at least 1 queue

Return Codes

Success

• SUCCESS

Failure

• ERROR_COMPRESSION_EXHAUSTED_EXT
• ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS_KHR
• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_VERSION_1_0, AllocationCallbacks, Device, Image, ImageCreateInfo

A convenience wrapper to make a compatible pair of calls to createImage and destroyImage

To ensure that destroyImage is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

vkDestroyImage - Destroy an image object

Valid Usage

• All submitted commands that refer to image, either directly or via a ImageView, must have completed execution

• If AllocationCallbacks were provided when image was created, a compatible set of callbacks must be provided here
• If no AllocationCallbacks were provided when image was created, pAllocator must be NULL
• image must not have been acquired from getSwapchainImagesKHR

Valid Usage (Implicit)

• device must be a valid Device handle

• If image is not NULL_HANDLE, image must be a valid Image handle
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• If image is a valid handle, it must have been created, allocated, or retrieved from device

Host Synchronization

• Host access to image must be externally synchronized

See Also

VK_VERSION_1_0, AllocationCallbacks, Device, Image

vkGetImageSubresourceLayout - Retrieve information about an image subresource

Description

If the image is linear, then the returned layout is valid for host access.

If the image’s tiling is IMAGE_TILING_LINEAR and its format is a multi-planar format, then getImageSubresourceLayout describes one format plane of the image. If the image’s tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then getImageSubresourceLayout describes one memory plane of the image. If the image’s tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT and the image is non-linear, then the returned layout has an implementation-dependent meaning; the vendor of the image’s DRM format modifier may provide documentation that explains how to interpret the returned layout.

getImageSubresourceLayout is invariant for the lifetime of a single image. However, the subresource layout of images in Android hardware buffer or QNX Screen buffer external memory is not known until the image has been bound to memory, so applications must not call getImageSubresourceLayout for such an image before it has been bound.

Valid Usage

• image must have been created with tiling equal to IMAGE_TILING_LINEAR or IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT

• The aspectMask member of pSubresource must only have a single bit set
• The mipLevel member of pSubresource must be less than the mipLevels specified in image
• The arrayLayer member of pSubresource must be less than the arrayLayers specified in image
• If format of the image is a color format that is not a multi-planar format, and tiling of the image is IMAGE_TILING_LINEAR or IMAGE_TILING_OPTIMAL, the aspectMask member of pSubresource must be IMAGE_ASPECT_COLOR_BIT
• If format of the image has a depth component, the aspectMask member of pSubresource must contain IMAGE_ASPECT_DEPTH_BIT
• If format of the image has a stencil component, the aspectMask member of pSubresource must contain IMAGE_ASPECT_STENCIL_BIT
• If format of the image does not contain a stencil or depth component, the aspectMask member of pSubresource must not contain IMAGE_ASPECT_DEPTH_BIT or IMAGE_ASPECT_STENCIL_BIT
• If the tiling of the image is IMAGE_TILING_LINEAR and has a multi-planar format, then the aspectMask member of pSubresource must be a single valid multi-planar aspect mask bit
• If image was created with the EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID external memory handle type, then image must be bound to memory
• If the tiling of the image is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the aspectMask member of pSubresource must be VK_IMAGE_ASPECT_MEMORY_PLANE_i_BIT_EXT and the index i must be less than the DrmFormatModifierPropertiesEXT::drmFormatModifierPlaneCount associated with the image’s format and ImageDrmFormatModifierPropertiesEXT::drmFormatModifier

Valid Usage (Implicit)

• device must be a valid Device handle

• image must be a valid Image handle
• pSubresource must be a valid pointer to a valid ImageSubresource structure
• pLayout must be a valid pointer to a SubresourceLayout structure
• image must have been created, allocated, or retrieved from device

See Also

VK_VERSION_1_0, Device, Image, ImageSubresource, SubresourceLayout

VkImageCreateInfo - Structure specifying the parameters of a newly created image object

Description

Images created with tiling equal to IMAGE_TILING_LINEAR have further restrictions on their limits and capabilities compared to images created with tiling equal to IMAGE_TILING_OPTIMAL. Creation of images with tiling IMAGE_TILING_LINEAR may not be supported unless other parameters meet all of the constraints:

• imageType is IMAGE_TYPE_2D
• format is not a depth/stencil format
• mipLevels is 1
• arrayLayers is 1
• samples is SAMPLE_COUNT_1_BIT
• usage only includes IMAGE_USAGE_TRANSFER_SRC_BIT and/or IMAGE_USAGE_TRANSFER_DST_BIT

Images created with one of the formats that require a sampler Y′CBCR conversion, have further restrictions on their limits and capabilities compared to images created with other formats. Creation of images with a format requiring Y′CBCR conversion may not be supported unless other parameters meet all of the constraints:

• imageType is IMAGE_TYPE_2D
• mipLevels is 1
• arrayLayers is 1, unless the ycbcrImageArrays feature is enabled, or otherwise indicated by ImageFormatProperties::maxArrayLayers, as returned by getPhysicalDeviceImageFormatProperties
• samples is SAMPLE_COUNT_1_BIT

Images created with the IMAGE_USAGE_TILE_MEMORY_BIT_QCOM usage flag set have further restrictions on their limits and capabilities compared to images created without this flag. Creation of images with usage including IMAGE_USAGE_TILE_MEMORY_BIT_QCOM may not be supported unless parameters meet all of the constraints:

• flags is 0 or only includes IMAGE_CREATE_ALIAS_BIT
• imageType is IMAGE_TYPE_2D
• mipLevels is 1
• arrayLayers is 1
• samples is SAMPLE_COUNT_1_BIT
• tiling is IMAGE_TILING_OPTIMAL
• usage includes IMAGE_USAGE_TILE_MEMORY_BIT_QCOM and any valid combination of the following IMAGE_USAGE_SAMPLED_BIT, IMAGE_USAGE_STORAGE_BIT, IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_INPUT_ATTACHMENT_BIT

Implementations may support additional limits and capabilities beyond those listed above.

To determine the set of valid usage bits for a given format, call getPhysicalDeviceFormatProperties.

If the size of the resultant image would exceed maxResourceSize, then createImage must fail and return ERROR_OUT_OF_DEVICE_MEMORY. This failure may occur even when all image creation parameters satisfy their valid usage requirements.

If the implementation reports TRUE in PromotedStreamingTransfers.PhysicalDeviceHostImageCopyProperties'::identicalMemoryTypeRequirements, usage of IMAGE_USAGE_HOST_TRANSFER_BIT must not affect the memory type requirements of the image as described in Sparse Resource Memory Requirements and Resource Memory Association.

For images created without the IMAGE_CREATE_EXTENDED_USAGE_BIT flag set, a usage bit is valid if it is supported for the format the image is created with.

For images created with IMAGE_CREATE_EXTENDED_USAGE_BIT a usage bit is valid if it is supported for at least one of the formats a ImageView created from the image can have (see Image Views for more detail).

Image Creation Limits

Valid values for some image creation parameters are limited by a numerical upper bound or by inclusion in a bitset. For example, ImageCreateInfo::arrayLayers is limited by imageCreateMaxArrayLayers, defined below; and ImageCreateInfo::samples is limited by imageCreateSampleCounts, also defined below.

Several limiting values are defined below, as well as assisting values from which the limiting values are derived. The limiting values are referenced by the relevant valid usage statements of ImageCreateInfo.

• Let uint64_t imageCreateDrmFormatModifiers[] be the set of Linux DRM format modifiers that the resultant image may have.

  • If tiling is not IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then imageCreateDrmFormatModifiers is empty.
  • If ImageCreateInfo::pNext contains ImageDrmFormatModifierExplicitCreateInfoEXT, then imageCreateDrmFormatModifiers contains exactly one modifier, ImageDrmFormatModifierExplicitCreateInfoEXT::drmFormatModifier.
  • If ImageCreateInfo::pNext contains ImageDrmFormatModifierListCreateInfoEXT, then imageCreateDrmFormatModifiers contains the entire array ImageDrmFormatModifierListCreateInfoEXT::pDrmFormatModifiers.

• Let VkBool32 imageCreateMaybeLinear indicate if the resultant image may be linear.

  • If tiling is IMAGE_TILING_LINEAR, then imageCreateMaybeLinear is TRUE.
  • If tiling is IMAGE_TILING_OPTIMAL, then imageCreateMaybeLinear is FALSE.
  • If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then imageCreateMaybeLinear is TRUE if and only if imageCreateDrmFormatModifiers contains DRM_FORMAT_MOD_LINEAR.

• Let VkFormatFeatureFlags imageCreateFormatFeatures be the set of valid format features available during image creation.

  • If tiling is IMAGE_TILING_LINEAR, then imageCreateFormatFeatures is the value of FormatProperties::linearTilingFeatures found by calling getPhysicalDeviceFormatProperties with parameter format equal to ImageCreateInfo::format.
  • If tiling is IMAGE_TILING_OPTIMAL, and if the pNext chain includes no ExternalFormatANDROID or ExternalFormatQNX structure with non-zero externalFormat, then imageCreateFormatFeatures is the value of FormatProperties::optimalTilingFeatures found by calling getPhysicalDeviceFormatProperties with parameter format equal to ImageCreateInfo::format.
  • If tiling is IMAGE_TILING_OPTIMAL, and if the pNext chain includes a ExternalFormatANDROID structure with non-zero externalFormat, then imageCreateFormatFeatures is the value of AndroidHardwareBufferFormatPropertiesANDROID::formatFeatures obtained by getAndroidHardwareBufferPropertiesANDROID with a matching externalFormat value.
  • If tiling is IMAGE_TILING_OPTIMAL, and if the pNext chain includes a ExternalFormatQNX structure with non-zero externalFormat, then imageCreateFormatFeatures is the value of ScreenBufferFormatPropertiesQNX::formatFeatures obtained by getScreenBufferPropertiesQNX with a matching externalFormat value.
  • If the pNext chain includes a BufferCollectionImageCreateInfoFUCHSIA structure, then imageCreateFormatFeatures is the value of BufferCollectionPropertiesFUCHSIA::formatFeatures found by calling getBufferCollectionPropertiesFUCHSIA with a parameter collection equal to BufferCollectionImageCreateInfoFUCHSIA::collection
  • If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the value of imageCreateFormatFeatures is found by calling getPhysicalDeviceFormatProperties2 with ImageFormatProperties::format equal to ImageCreateInfo::format and with DrmFormatModifierPropertiesListEXT chained into FormatProperties2; by collecting all members of the returned array DrmFormatModifierPropertiesListEXT::pDrmFormatModifierProperties whose drmFormatModifier belongs to imageCreateDrmFormatModifiers; and by taking the bitwise intersection, over the collected array members, of drmFormatModifierTilingFeatures. (The resultant imageCreateFormatFeatures may be empty).

• Let VkImageFormatProperties2 imageCreateImageFormatPropertiesList[] be defined as follows.

  • If ImageCreateInfo::pNext contains no ExternalFormatANDROID or ExternalFormatQNX structure with non-zero externalFormat, then imageCreateImageFormatPropertiesList is the list of structures obtained by calling getPhysicalDeviceImageFormatProperties2, possibly multiple times, as follows:

    • The parameters PhysicalDeviceImageFormatInfo2::format, imageType, tiling, usage, and flags must be equal to those in ImageCreateInfo.
    • If ImageCreateInfo::pNext contains a ExternalMemoryImageCreateInfo structure whose handleTypes is not 0, then PhysicalDeviceImageFormatInfo2::pNext must contain a PhysicalDeviceExternalImageFormatInfo structure whose handleType is not 0; and getPhysicalDeviceImageFormatProperties2 must be called for each handle type in ExternalMemoryImageCreateInfo::handleTypes, successively setting PhysicalDeviceExternalImageFormatInfo::handleType on each call.
    • If ImageCreateInfo::pNext contains no ExternalMemoryImageCreateInfo structure, or contains a structure whose handleTypes is 0, then PhysicalDeviceImageFormatInfo2::pNext must either contain no PhysicalDeviceExternalImageFormatInfo structure, or contain a structure whose handleType is 0.
    • If ImageCreateInfo::pNext contains a VkVideoProfileListInfoKHR structure then PhysicalDeviceImageFormatInfo2::pNext must also contain the same VkVideoProfileListInfoKHR structure on each call.

    • If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then:

      • PhysicalDeviceImageFormatInfo2::pNext must contain a PhysicalDeviceImageDrmFormatModifierInfoEXT structure where sharingMode is equal to ImageCreateInfo::sharingMode;
      • if sharingMode is SHARING_MODE_CONCURRENT, then queueFamilyIndexCount and pQueueFamilyIndices must be equal to those in ImageCreateInfo;
      • if flags contains IMAGE_CREATE_MUTABLE_FORMAT_BIT, then the ImageFormatListCreateInfo structure included in the pNext chain of PhysicalDeviceImageFormatInfo2 must be equivalent to the one included in the pNext chain of ImageCreateInfo;
      • if ImageCreateInfo::pNext contains a ImageCompressionControlEXT structure, then the PhysicalDeviceImageFormatInfo2::pNext chain must contain an equivalent structure;
      • getPhysicalDeviceImageFormatProperties2 must be called for each modifier in imageCreateDrmFormatModifiers, successively setting PhysicalDeviceImageDrmFormatModifierInfoEXT::drmFormatModifier on each call.
    • If tiling is not IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then PhysicalDeviceImageFormatInfo2::pNext must contain no PhysicalDeviceImageDrmFormatModifierInfoEXT structure.
    • If any call to getPhysicalDeviceImageFormatProperties2 returns an error, then imageCreateImageFormatPropertiesList is defined to be the empty list.

  • If ImageCreateInfo::pNext contains a ExternalFormatANDROID structure with non-zero externalFormat, then imageCreateImageFormatPropertiesList contains a single element where:

    • ImageFormatProperties::maxMipLevels is ⌊log2(max(extent.width, extent.height, extent.depth))⌋ + 1.
    • ImageFormatProperties::maxArrayLayers is PhysicalDeviceLimits::maxImageArrayLayers.
    • Each component of ImageFormatProperties::maxExtent is PhysicalDeviceLimits::maxImageDimension2D.
    • ImageFormatProperties::sampleCounts contains exactly SAMPLE_COUNT_1_BIT.
• Let uint32_t imageCreateMaxMipLevels be the minimum value of ImageFormatProperties::maxMipLevels in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
• Let uint32_t imageCreateMaxArrayLayers be the minimum value of ImageFormatProperties::maxArrayLayers in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
• Let VkExtent3D imageCreateMaxExtent be the component-wise minimum over all ImageFormatProperties::maxExtent values in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
• Let VkSampleCountFlags imageCreateSampleCounts be the intersection of each ImageFormatProperties::sampleCounts in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.

• Let VkVideoFormatPropertiesKHR videoFormatProperties[] be defined as follows.

  • If ImageCreateInfo::pNext contains a VkVideoProfileListInfoKHR structure, then videoFormatProperties is the list of structures obtained by calling vkGetPhysicalDeviceVideoFormatPropertiesKHR with VkPhysicalDeviceVideoFormatInfoKHR::imageUsage equal to the usage member of ImageCreateInfo and VkPhysicalDeviceVideoFormatInfoKHR::pNext containing the same VkVideoProfileListInfoKHR structure chained to ImageCreateInfo.
  • If ImageCreateInfo::pNext contains no VkVideoProfileListInfoKHR structure, then videoFormatProperties is an empty list.

• Let VkBool32 supportedVideoFormat indicate if the image parameters are supported by the specified video profiles.

  • supportedVideoFormat is TRUE if there exists an element in the videoFormatProperties list for which all of the following conditions are true:

    • ImageCreateInfo::format equals VkVideoFormatPropertiesKHR::format.
    • ImageCreateInfo::flags only contains VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR and/or bits also set in VkVideoFormatPropertiesKHR::imageCreateFlags.
    • ImageCreateInfo::imageType equals VkVideoFormatPropertiesKHR::imageType.
    • ImageCreateInfo::tiling equals VkVideoFormatPropertiesKHR::imageTiling.
    • ImageCreateInfo::usage only contains bits also set in VkVideoFormatPropertiesKHR::imageUsageFlags, or ImageCreateInfo::flags includes IMAGE_CREATE_EXTENDED_USAGE_BIT.
  • Otherwise supportedVideoFormat is FALSE.

Valid Usage

• Each of the following values (as described in Image Creation Limits) must not be undefined : imageCreateMaxMipLevels, imageCreateMaxArrayLayers, imageCreateMaxExtent, and imageCreateSampleCounts

• If sharingMode is SHARING_MODE_CONCURRENT, pQueueFamilyIndices must be a valid pointer to an array of queueFamilyIndexCount uint32_t values
• If sharingMode is SHARING_MODE_CONCURRENT, queueFamilyIndexCount must be greater than 1
• If sharingMode is SHARING_MODE_CONCURRENT, each element of pQueueFamilyIndices must be unique and must be less than pQueueFamilyPropertyCount returned by either getPhysicalDeviceQueueFamilyProperties or getPhysicalDeviceQueueFamilyProperties2 for the physicalDevice that was used to create device
• If the pNext chain includes a ExternalFormatANDROID structure, and its externalFormat member is non-zero the format must be FORMAT_UNDEFINED
• If the pNext chain does not include a ExternalFormatANDROID structure, or does and its externalFormat member is 0, the format must not be FORMAT_UNDEFINED
• extent.width must be greater than 0
• extent.height must be greater than 0
• extent.depth must be greater than 0
• mipLevels must be greater than 0
• arrayLayers must be greater than 0
• If flags contains IMAGE_CREATE_CUBE_COMPATIBLE_BIT, imageType must be IMAGE_TYPE_2D
• If flags contains IMAGE_CREATE_CUBE_COMPATIBLE_BIT, extent.width and extent.height must be equal
• If flags contains IMAGE_CREATE_CUBE_COMPATIBLE_BIT, arrayLayers must be greater than or equal to 6
• If the zeroInitializeDeviceMemory feature is not enabled, initialLayout must not be IMAGE_LAYOUT_ZERO_INITIALIZED_EXT
• If flags contains IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, imageType must be IMAGE_TYPE_2D
• If flags contains IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT, imageType must be IMAGE_TYPE_3D
• If flags contains IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT, flags must not include IMAGE_CREATE_SPARSE_ALIASED_BIT, IMAGE_CREATE_SPARSE_BINDING_BIT, or IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If flags contains IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT, imageType must be IMAGE_TYPE_3D
• If flags contains IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT and either the maintenance9 feature is not enabled on the device or image2DViewOf3DSparse is FALSE , flags must not include IMAGE_CREATE_SPARSE_ALIASED_BIT, IMAGE_CREATE_SPARSE_BINDING_BIT, or IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• extent.width must be less than or equal to imageCreateMaxExtent.width (as defined in Image Creation Limits)
• extent.height must be less than or equal to imageCreateMaxExtent.height (as defined in Image Creation Limits)
• extent.depth must be less than or equal to imageCreateMaxExtent.depth (as defined in Image Creation Limits)
• If imageType is IMAGE_TYPE_1D, both extent.height and extent.depth must be 1
• If imageType is IMAGE_TYPE_2D, extent.depth must be 1
• mipLevels must be less than or equal to the number of levels in the complete mipmap chain based on extent.width, extent.height, and extent.depth
• mipLevels must be less than or equal to imageCreateMaxMipLevels (as defined in Image Creation Limits)
• arrayLayers must be less than or equal to imageCreateMaxArrayLayers (as defined in Image Creation Limits)
• If imageType is IMAGE_TYPE_3D, arrayLayers must be 1
• If samples is not SAMPLE_COUNT_1_BIT, then imageType must be IMAGE_TYPE_2D, flags must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT, mipLevels must be equal to 1, and imageCreateMaybeLinear (as defined in Image Creation Limits) must be FALSE,
• If samples is not SAMPLE_COUNT_1_BIT, usage must not contain IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT
• If usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, then bits other than IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and IMAGE_USAGE_INPUT_ATTACHMENT_BIT must not be set
• If usage includes IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.width must be less than or equal to PhysicalDeviceLimits::maxFramebufferWidth
• If usage includes IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.height must be less than or equal to PhysicalDeviceLimits::maxFramebufferHeight
• If the fragmentDensityMapOffset feature is not enabled and usage includes IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, extent.width must be less than or equal to \(\left\lceil{\frac{maxFramebufferWidth}{minFragmentDensityTexelSize_{width}}}\right\rceil\)
• If the fragmentDensityMapOffset feature is not enabled and usage includes IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, extent.height must be less than or equal to \(\left\lceil{\frac{maxFramebufferHeight}{minFragmentDensityTexelSize_{height}}}\right\rceil\)
• If usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, usage must also contain at least one of IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
• samples must be a valid SampleCountFlagBits value that is set in imageCreateSampleCounts (as defined in Image Creation Limits)
• If the shaderStorageImageMultisample feature is not enabled, and usage contains IMAGE_USAGE_STORAGE_BIT, samples must be SAMPLE_COUNT_1_BIT
• If the sparseBinding feature is not enabled, flags must not contain IMAGE_CREATE_SPARSE_BINDING_BIT
• If the sparseResidencyAliased feature is not enabled, flags must not contain IMAGE_CREATE_SPARSE_ALIASED_BIT
• If tiling is IMAGE_TILING_LINEAR, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If imageType is IMAGE_TYPE_1D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidencyImage2D feature is not enabled, and imageType is IMAGE_TYPE_2D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidencyImage3D feature is not enabled, and imageType is IMAGE_TYPE_3D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidency2Samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_2_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidency4Samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_4_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidency8Samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_8_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If the sparseResidency16Samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_16_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
• If flags contains IMAGE_CREATE_SPARSE_RESIDENCY_BIT or IMAGE_CREATE_SPARSE_ALIASED_BIT, it must also contain IMAGE_CREATE_SPARSE_BINDING_BIT
• If any of the bits IMAGE_CREATE_SPARSE_BINDING_BIT, IMAGE_CREATE_SPARSE_RESIDENCY_BIT, or IMAGE_CREATE_SPARSE_ALIASED_BIT are set, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT must not also be set
• If the protectedMemory feature is not enabled, flags must not contain IMAGE_CREATE_PROTECTED_BIT
• If any of the bits IMAGE_CREATE_SPARSE_BINDING_BIT, IMAGE_CREATE_SPARSE_RESIDENCY_BIT, or IMAGE_CREATE_SPARSE_ALIASED_BIT are set, IMAGE_CREATE_PROTECTED_BIT must not also be set
• If the pNext chain includes a ExternalMemoryImageCreateInfoNV structure, it must not contain a ExternalMemoryImageCreateInfo structure
• If the pNext chain includes a ExternalMemoryImageCreateInfo structure, its handleTypes member must only contain bits that are also in ExternalImageFormatProperties::externalMemoryProperties.compatibleHandleTypes, as returned by getPhysicalDeviceImageFormatProperties2 with format, imageType, tiling, usage, and flags equal to those in this structure, and with a PhysicalDeviceExternalImageFormatInfo structure included in the pNext chain, with a handleType equal to any one of the handle types specified in ExternalMemoryImageCreateInfo::handleTypes
• If the pNext chain includes a ExternalMemoryImageCreateInfoNV structure, its handleTypes member must only contain bits that are also in ExternalImageFormatPropertiesNV::externalMemoryFeatures.compatibleHandleTypes, as returned by getPhysicalDeviceExternalImageFormatPropertiesNV with format, imageType, tiling, usage, and flags equal to those in this structure, and with externalHandleType equal to any one of the handle types specified in ExternalMemoryImageCreateInfoNV::handleTypes
• If the logical device was created with DeviceGroupDeviceCreateInfo::physicalDeviceCount equal to 1, flags must not contain IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT
• If flags contains IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT, then mipLevels must be one, arrayLayers must be one, imageType must be IMAGE_TYPE_2D, and imageCreateMaybeLinear (as defined in Image Creation Limits) must be FALSE
• If flags contains IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT, then format must be a compressed image format
• If flags contains IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT, then flags must also contain IMAGE_CREATE_MUTABLE_FORMAT_BIT
• initialLayout must be IMAGE_LAYOUT_UNDEFINED or IMAGE_LAYOUT_ZERO_INITIALIZED_EXT or IMAGE_LAYOUT_PREINITIALIZED
• If the pNext chain includes a ExternalMemoryImageCreateInfo or ExternalMemoryImageCreateInfoNV structure whose handleTypes member is not 0, initialLayout must be IMAGE_LAYOUT_UNDEFINED
• If the image format is one of the formats that require a sampler Y′CBCR conversion, mipLevels must be 1
• If the image format is one of the formats that require a sampler Y′CBCR conversion, samples must be SAMPLE_COUNT_1_BIT
• If the image format is one of the formats that require a sampler Y′CBCR conversion, imageType must be IMAGE_TYPE_2D
• If format is a multi-planar format, and if imageCreateFormatFeatures (as defined in Image Creation Limits) does not contain FORMAT_FEATURE_DISJOINT_BIT, then flags must not contain IMAGE_CREATE_DISJOINT_BIT
• If format is not a multi-planar format, and flags does not include IMAGE_CREATE_ALIAS_BIT, flags must not contain IMAGE_CREATE_DISJOINT_BIT
• If format has a _422 or _420 suffix, extent.width must be a multiple of 2
• If format has a _420 suffix, extent.height must be a multiple of 2
• If format is one of the VK_FORMAT_PVRTC1_*_IMG formats, extent.width must be a power of 2
• If format is one of the VK_FORMAT_PVRTC1_*_IMG formats, extent.height must be a power of 2
• If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the pNext chain must include exactly one of ImageDrmFormatModifierListCreateInfoEXT or ImageDrmFormatModifierExplicitCreateInfoEXT structures
• If the pNext chain includes a ImageDrmFormatModifierListCreateInfoEXT or ImageDrmFormatModifierExplicitCreateInfoEXT structure, then tiling must be IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT
• If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT and flags contains IMAGE_CREATE_MUTABLE_FORMAT_BIT, then the pNext chain must include a ImageFormatListCreateInfo structure with non-zero viewFormatCount
• If flags contains IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT format must be a depth or depth/stencil format
• If the pNext chain includes a ExternalMemoryImageCreateInfo structure whose handleTypes member includes EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID, imageType must be IMAGE_TYPE_2D
• If the pNext chain includes a ExternalMemoryImageCreateInfo structure whose handleTypes member includes EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID, mipLevels must either be 1 or equal to the number of levels in the complete mipmap chain based on extent.width, extent.height, and extent.depth
• If the pNext chain includes a ExternalFormatANDROID structure whose externalFormat member is not 0, flags must not include IMAGE_CREATE_MUTABLE_FORMAT_BIT
• If the pNext chain includes a ExternalFormatANDROID structure whose externalFormat member is not 0, usage must not include any usages except IMAGE_USAGE_INPUT_ATTACHMENT_BIT, IMAGE_USAGE_COLOR_ATTACHMENT_BIT, or IMAGE_USAGE_SAMPLED_BIT
• If the pNext chain includes a ExternalFormatANDROID structure whose externalFormat member is not 0, and externalFormatResolve feature is not enabled, usage must not include IMAGE_USAGE_INPUT_ATTACHMENT_BIT or IMAGE_USAGE_COLOR_ATTACHMENT_BIT
• If the pNext chain includes a ExternalFormatANDROID structure whose externalFormat member is not 0, tiling must be IMAGE_TILING_OPTIMAL
• If the pNext chain includes a ExternalMemoryImageCreateInfo structure whose handleTypes member includes EXTERNAL_MEMORY_HANDLE_TYPE_SCREEN_BUFFER_BIT_QNX, imageType must be IMAGE_TYPE_2D
• If the pNext chain includes a ExternalMemoryImageCreateInfo structure whose handleTypes member includes EXTERNAL_MEMORY_HANDLE_TYPE_SCREEN_BUFFER_BIT_QNX, mipLevels must either be 1 or equal to the number of levels in the complete mipmap chain based on extent.width, extent.height, and extent.depth
• If the pNext chain includes a ExternalFormatQNX structure whose externalFormat member is not 0, flags must not include IMAGE_CREATE_MUTABLE_FORMAT_BIT
• If the pNext chain includes a ExternalFormatQNX structure whose externalFormat member is not 0, usage must not include any usages except IMAGE_USAGE_SAMPLED_BIT
• If the pNext chain includes a ExternalFormatQNX structure whose externalFormat member is not 0, tiling must be IMAGE_TILING_OPTIMAL
• If format is a depth-stencil format, usage includes IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and the pNext chain includes a ImageStencilUsageCreateInfo structure, then its ImageStencilUsageCreateInfo::stencilUsage member must also include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
• If format is a depth-stencil format, usage does not include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and the pNext chain includes a ImageStencilUsageCreateInfo structure, then its ImageStencilUsageCreateInfo::stencilUsage member must also not include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
• If format is a depth-stencil format, usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, and the pNext chain includes a ImageStencilUsageCreateInfo structure, then its ImageStencilUsageCreateInfo::stencilUsage member must also include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT
• If format is a depth-stencil format, usage does not include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, and the pNext chain includes a ImageStencilUsageCreateInfo structure, then its ImageStencilUsageCreateInfo::stencilUsage member must also not include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT
• If Format is a depth-stencil format and the pNext chain includes a ImageStencilUsageCreateInfo structure with its stencilUsage member including IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.width must be less than or equal to PhysicalDeviceLimits::maxFramebufferWidth
• If format is a depth-stencil format and the pNext chain includes a ImageStencilUsageCreateInfo structure with its stencilUsage member including IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.height must be less than or equal to PhysicalDeviceLimits::maxFramebufferHeight
• If the shaderStorageImageMultisample feature is not enabled, format is a depth-stencil format and the pNext chain includes a ImageStencilUsageCreateInfo structure with its stencilUsage including IMAGE_USAGE_STORAGE_BIT, samples must be SAMPLE_COUNT_1_BIT
• If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV, imageType must be IMAGE_TYPE_2D or IMAGE_TYPE_3D
• If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV, it must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT and the format must not be a depth/stencil format
• If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV and imageType is IMAGE_TYPE_2D, extent.width and extent.height must be greater than 1
• If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV and imageType is IMAGE_TYPE_3D, extent.width, extent.height, and extent.depth must be greater than 1
• If usage includes IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, imageType must be IMAGE_TYPE_2D
• If usage includes IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, samples must be SAMPLE_COUNT_1_BIT
• If the shadingRateImage feature is enabled and usage includes IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV, tiling must be IMAGE_TILING_OPTIMAL
• If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, tiling must be IMAGE_TILING_OPTIMAL
• If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, imageType must be IMAGE_TYPE_2D
• If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, flags must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT
• If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, mipLevels must be 1
• If usage includes IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI, tiling must be IMAGE_TILING_LINEAR
• If the VK_KHR_portability_subset extension is enabled, and PhysicalDevicePortabilitySubsetFeaturesKHR::imageView2DOn3DImage is FALSE, flags must not contain IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT
• If the VK_KHR_portability_subset extension is enabled, and PhysicalDevicePortabilitySubsetFeaturesKHR::multisampleArrayImage is FALSE, and samples is not SAMPLE_COUNT_1_BIT, then arrayLayers must be 1
• If a ImageFormatListCreateInfo structure was included in the pNext chain and format is not a multi-planar format and ImageFormatListCreateInfo::viewFormatCount is not zero, then each format in ImageFormatListCreateInfo::pViewFormats must either be compatible with the format as described in the compatibility table or, if flags contains IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT, be an uncompressed format that is size-compatible with format
• If a ImageFormatListCreateInfo structure was included in the pNext chain and format is a multi-planar format and flags contains IMAGE_CREATE_MUTABLE_FORMAT_BIT and ImageFormatListCreateInfo::viewFormatCount is not zero, then each format in ImageFormatListCreateInfo::pViewFormats must be compatible with the Format for the plane of the image format
• If flags does not contain IMAGE_CREATE_MUTABLE_FORMAT_BIT and the pNext chain includes a ImageFormatListCreateInfo structure, then ImageFormatListCreateInfo::viewFormatCount must be 0 or 1
• If usage includes VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR, VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR, or VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR, and flags does not include VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR, then the pNext chain must include a VkVideoProfileListInfoKHR structure with profileCount greater than 0 and pProfiles including at least one VkVideoProfileInfoKHR structure with a videoCodecOperation member specifying a decode operation
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR, VK_IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR, or VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR, and flags does not include VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR, then the pNext chain must include a VkVideoProfileListInfoKHR structure with profileCount greater than 0 and pProfiles including at least one VkVideoProfileInfoKHR structure with a videoCodecOperation member specifying an encode operation
• If flags includes VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR, then videoMaintenance1 must be enabled
• If flags includes VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR and usage does not include VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR, then usage must not include VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR
• If flags includes VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR, then usage must not include VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR, VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, or VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR
• If the pNext chain includes a VkVideoProfileListInfoKHR structure with profileCount greater than 0, then supportedVideoFormat must be TRUE
• If the pNext chain includes a VkVideoProfileListInfoKHR structure and for any element of its pProfiles member videoCodecOperation is VK_VIDEO_CODEC_OPERATION_DECODE_VP9_BIT_KHR, then the videoDecodeVP9 feature must be enabled
• If the pNext chain includes a VkVideoProfileListInfoKHR structure and for any element of its pProfiles member videoCodecOperation is VK_VIDEO_CODEC_OPERATION_ENCODE_AV1_BIT_KHR, then the videoEncodeAV1 feature must be enabled
• If the pNext chain includes a VkVideoEncodeProfileRgbConversionInfoVALVE structure, then the videoEncodeRgbConversion feature must be enabled
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, then the videoEncodeQuantizationMap feature must be enabled
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, imageType must be IMAGE_TYPE_2D
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, samples must be SAMPLE_COUNT_1_BIT
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, then the pNext chain must include a VkVideoProfileListInfoKHR structure with profileCount equal to 1 and pProfiles pointing to a VkVideoProfileInfoKHR structure with a videoCodecOperation member specifying an encode operation
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR, then VkVideoEncodeCapabilitiesKHR::flags must include VK_VIDEO_ENCODE_CAPABILITY_QUANTIZATION_DELTA_MAP_BIT_KHR, as returned by vkGetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified in the pProfiles member of the VkVideoProfileListInfoKHR structure included in the pNext chain
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, then VkVideoEncodeCapabilitiesKHR::flags must include VK_VIDEO_ENCODE_CAPABILITY_EMPHASIS_MAP_BIT_KHR, as returned by vkGetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified in the pProfiles member of the VkVideoProfileListInfoKHR structure included in the pNext chain
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, extent.width must be less than or equal to VkVideoEncodeQuantizationMapCapabilitiesKHR::maxQuantizationMapExtent.width, as returned by vkGetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified in the pProfiles member of the VkVideoProfileListInfoKHR structure included in the pNext chain
• If usage includes VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR, extent.height must be less than or equal to VkVideoEncodeQuantizationMapCapabilitiesKHR::maxQuantizationMapExtent.height, as returned by vkGetPhysicalDeviceVideoCapabilitiesKHR for the video profile specified in the pProfiles member of the VkVideoProfileListInfoKHR structure included in the pNext chain
• If the Image is to be used to import memory from a BufferCollectionFUCHSIA, a BufferCollectionImageCreateInfoFUCHSIA structure must be chained to pNext
• If the multisampledRenderToSingleSampled feature is not enabled, flags must not contain IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT
• If flags contains IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT, samples must be SAMPLE_COUNT_1_BIT
• If the pNext chain includes a ImageCompressionControlEXT structure, format is a multi-planar format, and ImageCompressionControlEXT::flags includes IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT, then ImageCompressionControlEXT::compressionControlPlaneCount must be equal to the number of planes in format
• If the pNext chain includes a ImageCompressionControlEXT structure, format is not a multi-planar format, and ImageCompressionControlEXT::flags includes IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT, then ImageCompressionControlEXT::compressionControlPlaneCount must be 1
• If the pNext chain includes a ImageCompressionControlEXT structure, it must not contain a ImageDrmFormatModifierExplicitCreateInfoEXT structure
• If flags includes IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT, the descriptorBufferCaptureReplay or descriptorHeapCaptureReplay feature must be enabled
• If the pNext chain includes a OpaqueCaptureDescriptorDataCreateInfoEXT structure, flags must contain IMAGE_CREATE_DESCRIPTOR_BUFFER_CAPTURE_REPLAY_BIT_EXT
• If the pNext chain includes a ExportMetalObjectCreateInfoEXT structure, its exportObjectType member must be either EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT or EXPORT_METAL_OBJECT_TYPE_METAL_IOSURFACE_BIT_EXT
• If the pNext chain includes a ImportMetalTextureInfoEXT structure its plane member must be IMAGE_ASPECT_PLANE_0_BIT, IMAGE_ASPECT_PLANE_1_BIT, or IMAGE_ASPECT_PLANE_2_BIT
• If the pNext chain includes a ImportMetalTextureInfoEXT structure and the image does not have a multi-planar format, then ImportMetalTextureInfoEXT::plane must be IMAGE_ASPECT_PLANE_0_BIT
• If the pNext chain includes a ImportMetalTextureInfoEXT structure and the image has a multi-planar format with only two planes, then ImportMetalTextureInfoEXT::plane must not be IMAGE_ASPECT_PLANE_2_BIT
• If imageCreateFormatFeatures (as defined in Image Creation Limits) does not contain FORMAT_FEATURE_2_HOST_IMAGE_TRANSFER_BIT, then usage must not contain IMAGE_USAGE_HOST_TRANSFER_BIT
• If usage includes IMAGE_USAGE_HOST_TRANSFER_BIT, then the hostImageCopy feature must be enabled
• If the tileMemoryHeap feature is not enabled, usage must not include IMAGE_USAGE_TILE_MEMORY_BIT_QCOM
• If the pNext chain contains a ImageAlignmentControlCreateInfoMESA structure, tiling must be IMAGE_TILING_OPTIMAL
• If the pNext chain contains a ImageAlignmentControlCreateInfoMESA structure, it must not contain a ExternalMemoryImageCreateInfo structure
• If tiling is VK_IMAGE_TILING_LINEAR then IMAGE_USAGE_TENSOR_ALIASING_BIT_ARM must not be set in usage
• If Vulkan 1.3 is not supported and the ycbcr2plane444Formats feature is not enabled, format must not be FORMAT_G8_B8R8_2PLANE_444_UNORM, FORMAT_G10X6_B10X6R10X6_2PLANE_444_UNORM_3PACK16, FORMAT_G12X4_B12X4R12X4_2PLANE_444_UNORM_3PACK16, or FORMAT_G16_B16R16_2PLANE_444_UNORM
• If OpaqueCaptureDataCreateInfoEXT::pData is not NULL, flags must contain IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT
• If flags contains IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT, and OpaqueCaptureDataCreateInfoEXT::pData is not NULL, OpaqueCaptureDataCreateInfoEXT::pData->size must be equal to imageCaptureReplayOpaqueDataSize

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_IMAGE_CREATE_INFO

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of BufferCollectionImageCreateInfoFUCHSIA, DedicatedAllocationImageCreateInfoNV, ExportMetalObjectCreateInfoEXT, ExternalFormatANDROID, VkExternalFormatOHOS, ExternalFormatQNX, ExternalMemoryImageCreateInfo, ExternalMemoryImageCreateInfoNV, ImageAlignmentControlCreateInfoMESA, ImageCompressionControlEXT, ImageDrmFormatModifierExplicitCreateInfoEXT, ImageDrmFormatModifierListCreateInfoEXT, ImageFormatListCreateInfo, ImageStencilUsageCreateInfo, ImageSwapchainCreateInfoKHR, ImportMetalIOSurfaceInfoEXT, ImportMetalTextureInfoEXT, OpaqueCaptureDataCreateInfoEXT, OpaqueCaptureDescriptorDataCreateInfoEXT, OpticalFlowImageFormatInfoNV, or VkVideoProfileListInfoKHR
• The sType value of each structure in the pNext chain must be unique, with the exception of structures of type ExportMetalObjectCreateInfoEXT or ImportMetalTextureInfoEXT
• flags must be a valid combination of ImageCreateFlagBits values
• imageType must be a valid ImageType value
• format must be a valid Format value
• samples must be a valid SampleCountFlagBits value
• tiling must be a valid ImageTiling value
• usage must be a valid combination of ImageUsageFlagBits values
• usage must not be 0
• sharingMode must be a valid SharingMode value
• initialLayout must be a valid ImageLayout value

See Also

VK_VERSION_1_0, DeviceImageMemoryRequirements, DeviceImageSubresourceInfo, Extent3D, Format, ImageCreateFlags, ImageFormatConstraintsInfoFUCHSIA, ImageLayout, ImageTiling, ImageType, ImageUsageFlags, SampleCountFlagBits, SharingMode, StructureType, createImage

VkSubresourceLayout - Structure specifying subresource layout

Description

If the image is linear, then rowPitch, arrayPitch and depthPitch describe the layout of the image subresource in linear memory. For uncompressed formats, rowPitch is the number of bytes between texels with the same x coordinate in adjacent rows (y coordinates differ by one). arrayPitch is the number of bytes between texels with the same x and y coordinate in adjacent array layers of the image (array layer values differ by one). depthPitch is the number of bytes between texels with the same x and y coordinate in adjacent slices of a 3D image (z coordinates differ by one). Expressed as an addressing formula, the starting byte of a texel in the image subresource has address:

// (x,y,z,layer) are in texel coordinates
address(x,y,z,layer) = layer*arrayPitch + z*depthPitch + y*rowPitch + x*elementSize + offset

For compressed formats, the rowPitch is the number of bytes between compressed texel blocks in adjacent rows. arrayPitch is the number of bytes between compressed texel blocks in adjacent array layers. depthPitch is the number of bytes between compressed texel blocks in adjacent slices of a 3D image.

// (x,y,z,layer) are in compressed texel block coordinates
address(x,y,z,layer) = layer*arrayPitch + z*depthPitch + y*rowPitch + x*compressedTexelBlockByteSize + offset;

The value of arrayPitch is undefined for images that were not created as arrays. depthPitch is defined only for 3D images.

If the image has a single-plane color format and its tiling is IMAGE_TILING_LINEAR , then the aspectMask member of ImageSubresource must be IMAGE_ASPECT_COLOR_BIT.

If the image has a depth/stencil format and its tiling is IMAGE_TILING_LINEAR , then aspectMask must be either IMAGE_ASPECT_DEPTH_BIT or IMAGE_ASPECT_STENCIL_BIT. On implementations that store depth and stencil aspects separately, querying each of these image subresource layouts will return a different offset and size representing the region of memory used for that aspect. On implementations that store depth and stencil aspects interleaved, the same offset and size are returned and represent the interleaved memory allocation.

If the image has a multi-planar format and its tiling is IMAGE_TILING_LINEAR , then the aspectMask member of ImageSubresource must be IMAGE_ASPECT_PLANE_0_BIT, IMAGE_ASPECT_PLANE_1_BIT, or (for 3-plane formats only) IMAGE_ASPECT_PLANE_2_BIT. Querying each of these image subresource layouts will return a different offset and size representing the region of memory used for that plane. If the image is disjoint, then the offset is relative to the base address of the plane. If the image is non-disjoint, then the offset is relative to the base address of the image.

If the image’s tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the aspectMask member of ImageSubresource must be one of VK_IMAGE_ASPECT_MEMORY_PLANE_i_BIT_EXT, where the maximum allowed plane index i is defined by the DrmFormatModifierPropertiesEXT::drmFormatModifierPlaneCount associated with the image’s ImageCreateInfo::format and modifier. The memory range used by the subresource is described by offset and size. If the image is disjoint, then the offset is relative to the base address of the memory plane. If the image is non-disjoint, then the offset is relative to the base address of the image. If the image is non-linear, then rowPitch, arrayPitch, and depthPitch have an implementation-dependent meaning.

See Also

VK_VERSION_1_0, DeviceSize, ImageDrmFormatModifierExplicitCreateInfoEXT, SubresourceLayout2, getImageSubresourceLayout

VkImage - Opaque handle to an image object

See Also

VK_DEFINE_NON_DISPATCHABLE_HANDLE, VK_VERSION_1_0, BindImageMemoryInfo, BlitImageInfo2, CopyBufferToImageInfo2, CopyImageInfo2, CopyImageToBufferInfo2, PromotedStreamingTransfers.CopyImageToImageInfo', PromotedStreamingTransfers.CopyImageToMemoryInfo', CopyMemoryToImageIndirectInfoKHR, PromotedStreamingTransfers.CopyMemoryToImageInfo', DedicatedAllocationMemoryAllocateInfoNV, ExportMetalIOSurfaceInfoEXT, ExportMetalTextureInfoEXT, FrameBoundaryEXT, PromotedStreamingTransfers.HostImageLayoutTransitionInfo', ImageCaptureDescriptorDataInfoEXT, ImageMemoryBarrier, ImageMemoryBarrier2, ImageMemoryRequirementsInfo2, ImageSparseMemoryRequirementsInfo2, ImageViewCreateInfo, MemoryDedicatedAllocateInfo, ResolveImageInfo2, SparseImageMemoryBindInfo, SparseImageOpaqueMemoryBindInfo, bindImageMemory, cmdBlitImage, cmdClearColorImage, cmdClearDepthStencilImage, cmdCopyBufferToImage, cmdCopyImage, cmdCopyImageToBuffer, cmdCopyMemoryToImageIndirectNV, cmdResolveImage, createImage, destroyImage, getImageDrmFormatModifierPropertiesEXT, getImageMemoryRequirements, getImageOpaqueCaptureDataEXT, getImageSparseMemoryRequirements, getImageSubresourceLayout, getImageSubresourceLayout2, getImageSubresourceLayout2, getImageSubresourceLayout2, getSwapchainImagesKHR

VkImageLayout - Layout of image and image subresources

Description

The type(s) of device access supported by each layout are:

• IMAGE_LAYOUT_UNDEFINED specifies that the layout is unknown. Image memory cannot be transitioned into this layout. This layout can be used as the initialLayout member of ImageCreateInfo. This layout can be used in place of the current image layout in a layout transition, but doing so will cause the contents of the image’s memory to be undefined.
• IMAGE_LAYOUT_PREINITIALIZED specifies that an image’s memory is in a defined layout and can be populated by data, but that it has not yet been initialized by the driver. Image memory cannot be transitioned into this layout. This layout can be used as the initialLayout member of ImageCreateInfo. This layout is intended to be used as the initial layout for an image whose contents are written by the host, and hence the data can be written to memory immediately, without first executing a layout transition. Currently, IMAGE_LAYOUT_PREINITIALIZED is only useful with linear images because there is not a standard layout defined for IMAGE_TILING_OPTIMAL images.
• IMAGE_LAYOUT_GENERAL supports all types of device access, unless specified otherwise.
• IMAGE_LAYOUT_ZERO_INITIALIZED_EXT specifies that an image’s memory is in a defined layout and is zeroed, but that it has not yet been initialized by the driver. Image memory cannot be transitioned into this layout. This layout can be used as the initialLayout member of ImageCreateInfo. This layout is intended to be used as the initial layout for an image whose contents are already zeroed, either from being explicitly set to zero by an application or from being allocated with MEMORY_ALLOCATE_ZERO_INITIALIZE_BIT_EXT.
• IMAGE_LAYOUT_ATTACHMENT_OPTIMAL specifies a layout that must only be used with attachment accesses in the graphics pipeline.
• IMAGE_LAYOUT_READ_ONLY_OPTIMAL specifies a layout allowing read only access as an attachment, or in shaders as a sampled image, combined image/sampler, or input attachment.
• IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL must only be used as a color or resolve attachment in a Framebuffer. This layout is valid only for image subresources of images created with the IMAGE_USAGE_COLOR_ATTACHMENT_BIT usage flag set.
• IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL specifies a layout for both the depth and stencil aspects of a depth/stencil format image allowing read and write access as a depth/stencil attachment. It is equivalent to IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL and IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL.
• IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL specifies a layout for both the depth and stencil aspects of a depth/stencil format image allowing read only access as a depth/stencil attachment or in shaders as a sampled image, combined image/sampler, or input attachment. It is equivalent to IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL and IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL.
• IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL specifies a layout for depth/stencil format images allowing read and write access to the stencil aspect as a stencil attachment, and read only access to the depth aspect as a depth attachment or in shaders as a sampled image, combined image/sampler, or input attachment. It is equivalent to IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL and IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL.
• IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL specifies a layout for depth/stencil format images allowing read and write access to the depth aspect as a depth attachment, and read only access to the stencil aspect as a stencil attachment or in shaders as a sampled image, combined image/sampler, or input attachment. It is equivalent to IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL and IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL.
• IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL specifies a layout for the depth aspect of a depth/stencil format image allowing read and write access as a depth attachment.
• IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL specifies a layout for the depth aspect of a depth/stencil format image allowing read-only access as a depth attachment or in shaders as a sampled image, combined image/sampler, or input attachment.
• IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL specifies a layout for the stencil aspect of a depth/stencil format image allowing read and write access as a stencil attachment.
• IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL specifies a layout for the stencil aspect of a depth/stencil format image allowing read-only access as a stencil attachment or in shaders as a sampled image, combined image/sampler, or input attachment.
• IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL specifies a layout allowing read-only access in a shader as a sampled image, combined image/sampler, or input attachment. This layout is valid only for image subresources of images created with the IMAGE_USAGE_SAMPLED_BIT or IMAGE_USAGE_INPUT_ATTACHMENT_BIT usage bits enabled.
• IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL must only be used as a source image of a transfer command (see the definition of https://registry.khronos.org/vulkan/specs/latest/html/vkspec.html#synchronization-pipeline-stages-transfer). This layout is valid only for image subresources of images created with the IMAGE_USAGE_TRANSFER_SRC_BIT usage flag set.
• IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL must only be used as a destination image of a transfer command. This layout is valid only for image subresources of images created with the IMAGE_USAGE_TRANSFER_DST_BIT usage flag set.
• IMAGE_LAYOUT_PRESENT_SRC_KHR must only be used for presenting a presentable image for display.
• IMAGE_LAYOUT_SHARED_PRESENT_KHR is valid only for shared presentable images, and must be used for any usage the image supports.
• IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR must only be used as a fragment shading rate attachment or shading rate image. This layout is valid only for image subresources of images created with the IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR usage flag set.
• IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT must only be used as a fragment density map attachment in a RenderPass. This layout is valid only for image subresources of images created with the IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT usage flag set.
• VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR must only be used as a decode output picture in a video decode operation. This layout is valid only for image subresources of images created with the VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR usage flag set.
• VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR is reserved for future use.
• VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR must only be used as an output reconstructed picture or an input reference picture in a video decode operation. This layout is valid only for image subresources of images created with the VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR usage flag set.
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_DST_KHR is reserved for future use.
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_SRC_KHR must only be used as an encode input picture in a video encode operation. This layout is valid only for image subresources of images created with the VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR usage flag set.
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_DPB_KHR must only be used as an output reconstructed picture or an input reference picture in a video encode operation. This layout is valid only for image subresources of images created with the VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR usage flag set.
• IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT must only be used as either a color attachment or depth/stencil attachment and/or read-only access in a shader as a sampled image, combined image/sampler, or input attachment. This layout is valid only for image subresources of images created with the IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT usage flag set, and either the IMAGE_USAGE_COLOR_ATTACHMENT_BIT or IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT usage flags set, and either the IMAGE_USAGE_INPUT_ATTACHMENT_BIT or IMAGE_USAGE_SAMPLED_BIT usage flags set
• IMAGE_LAYOUT_RENDERING_LOCAL_READ must only be used as either a storage image, or a color or depth/stencil attachment and an input attachment. This layout is valid only for image subresources of images created with either the IMAGE_USAGE_STORAGE_BIT usage flag set, or both the IMAGE_USAGE_INPUT_ATTACHMENT_BIT and either of the IMAGE_USAGE_COLOR_ATTACHMENT_BIT or IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT usage flags set.
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_QUANTIZATION_MAP_KHR must only be used as a quantization map in a video encode operation. This layout is valid only for image subresources of images created with the VK_IMAGE_USAGE_VIDEO_ENCODE_QUANTIZATION_DELTA_MAP_BIT_KHR or VK_IMAGE_USAGE_VIDEO_ENCODE_EMPHASIS_MAP_BIT_KHR usage flags set.
• IMAGE_LAYOUT_TENSOR_ALIASING_ARM specifies the layout that an image created with IMAGE_TILING_OPTIMAL must be in, if the unifiedImageLayouts feature is disabled, or may be in if it is enabled, for it and a tensor bound to the same aliased range of memory to consistently interpret the data in memory. See https://registry.khronos.org/vulkan/specs/latest/html/vkspec.html#resources-memory-aliasing for a complete set of rules for tensor/image aliasing. This layout is valid only for image subresources of images created with the IMAGE_USAGE_TENSOR_ALIASING_BIT_ARM usage flag set.

The layout of each image subresource is not a state of the image subresource itself, but is rather a property of how the data in memory is organized, and thus for each mechanism of accessing an image in the API the application must specify a parameter or structure member that indicates which image layout the image subresource(s) are considered to be in when the image will be accessed. For transfer commands, this is a parameter to the command (see https://registry.khronos.org/vulkan/specs/latest/html/vkspec.html#clears and https://registry.khronos.org/vulkan/specs/latest/html/vkspec.html#copies). For use as a framebuffer attachment, this is a member in the substructures of the RenderPassCreateInfo (see Render Pass). For use in a descriptor set, this is a member in the DescriptorImageInfo structure (see https://registry.khronos.org/vulkan/specs/latest/html/vkspec.html#descriptorsets-updates).

If the unifiedImageLayouts feature is enabled, the IMAGE_LAYOUT_GENERAL image layout may be used in place of the other layouts where allowed with no loss of performance.

IMAGE_LAYOUT_GENERAL can be a useful catch-all image layout, but there are situations where a dedicated image layout must be used instead. Some examples include:

• IMAGE_LAYOUT_PRESENT_SRC_KHR
• IMAGE_LAYOUT_SHARED_PRESENT_KHR
• VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR, VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR, and VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR without the unifiedImageLayoutsVideo feature
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_SRC_KHR, VK_IMAGE_LAYOUT_VIDEO_ENCODE_DST_KHR, and VK_IMAGE_LAYOUT_VIDEO_ENCODE_DPB_KHR without the unifiedImageLayoutsVideo feature
• VK_IMAGE_LAYOUT_VIDEO_ENCODE_QUANTIZATION_MAP_KHR without the unifiedImageLayoutsVideo feature

While IMAGE_LAYOUT_GENERAL suggests that all types of device access is possible, it does not mean that all patterns of memory accesses are safe in all situations. Common Render Pass Data Races outlines some situations where data races are unavoidable. For example, when a subresource is used as both an attachment and a sampled image (i.e., not an input attachment), enabling feedback loop adds extra guarantees which IMAGE_LAYOUT_GENERAL alone does not.

See Also

VK_VERSION_1_0, AttachmentDescription, AttachmentDescription2, AttachmentDescriptionStencilLayout, AttachmentReference, AttachmentReference2, AttachmentReferenceStencilLayout, BlitImageInfo2, CopyBufferToImageInfo2, CopyImageInfo2, CopyImageToBufferInfo2, PromotedStreamingTransfers.CopyImageToImageInfo', PromotedStreamingTransfers.CopyImageToMemoryInfo', CopyMemoryToImageIndirectInfoKHR, PromotedStreamingTransfers.CopyMemoryToImageInfo', DescriptorImageInfo, PromotedStreamingTransfers.HostImageLayoutTransitionInfo', ImageCreateInfo, ImageDescriptorInfoEXT, ImageMemoryBarrier, ImageMemoryBarrier2, PromotedStreamingTransfers.PhysicalDeviceHostImageCopyProperties', PhysicalDeviceVulkan14Properties, RenderingAttachmentInfo, RenderingFragmentDensityMapAttachmentInfoEXT, RenderingFragmentShadingRateAttachmentInfoKHR, ResolveImageInfo2, bindOpticalFlowSessionImageNV, cmdBindInvocationMaskHUAWEI, cmdBindShadingRateImageNV, cmdBlitImage, cmdClearColorImage, cmdClearDepthStencilImage, cmdCopyBufferToImage, cmdCopyImage, cmdCopyImageToBuffer, cmdCopyMemoryToImageIndirectNV, cmdResolveImage