Structures

VkSamplerCustomBorderColorIndexCreateInfoEXT

Structure specifying the custom border color index for a sampler

The VkSamplerCustomBorderColorIndexCreateInfoEXT structure is defined as:

typedef struct VkSamplerCustomBorderColorIndexCreateInfoEXT {
    VkStructureType sType;
    const void* pNext;
    uint32_t index;
} VkSamplerCustomBorderColorIndexCreateInfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • index is the uint32_t index value to use with the sampler

If this structure is included in the pNext chain of VkSamplerCreateInfo, the value of index will be used for the custom border color registration. index does not need to be registered at the point that a sampler object is created or a sampler descriptor is written; as long as it is registered when any use of the sampler is recorded to a command, and remains registered while the sampler is in use. The color registered with the index and the color specified in the sampler must be identically defined.

If this structure is not provided when creating a sampler object with a custom border color, it is equivalent to registering a new custom border color by calling vkRegisterCustomBorderColorEXT with that custom border color value, and using that value as index in this structure. This implicit registration will be implicitly unregistered when the sampler is destroyed.

If this structure is not provided when creating a sampler object without a custom border color, it is equivalent to setting index to 0.

Valid Usage (Implicit)

VUID-VkSamplerCustomBorderColorIndexCreateInfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_SAMPLER_CUSTOM_BORDER_COLOR_INDEX_CREATE_INFO_EXT