Structures

VkImportMetalTextureInfoEXT

Structure that identifies Metal MTLTexture objects to use when creating a VkImage.

To import one or more existing Metal MTLTexture objects to underlie a VkImage object, include one or more VkImportMetalTextureInfoEXT structures in the pNext chain of the VkImageCreateInfo structure in a vkCreateImage command.

The VkImportMetalTextureInfoEXT structure is defined as:

typedef struct VkImportMetalTextureInfoEXT {
    VkStructureType sType;
    const void* pNext;
    VkImageAspectFlagBits plane;
    MTLTexture_id mtlTexture;
} VkImportMetalTextureInfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • plane indicates the plane of the VkImage that the id<MTLTexture> object should be attached to.
  • mtlTexture is a the Metal id<MTLTexture> object that is to underlie the VkImage plane.

The pNext chain must include one VkImportMetalTextureInfoEXT structure for each plane in the VkImage. The application must ensure that the configuration of the Metal id<MTLTexture> objects are compatible with the configuration of the VkImage. Failure to do so results in undefined: behavior.

Valid Usage (Implicit)

VUID-VkImportMetalTextureInfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_IMPORT_METAL_TEXTURE_INFO_EXT