VkImageConstraintsInfoFUCHSIA(3)

Name

VkImageConstraintsInfoFUCHSIA - Structure of image-based buffer collection constraints

C Specification

The VkImageConstraintsInfoFUCHSIA structure is defined as:

// Provided by VK_FUCHSIA_buffer_collection
typedef struct VkImageConstraintsInfoFUCHSIA {
    VkStructureType                               sType;
    const void*                                   pNext;
    uint32_t                                      formatConstraintsCount;
    const VkImageFormatConstraintsInfoFUCHSIA*    pFormatConstraints;
    VkBufferCollectionConstraintsInfoFUCHSIA      bufferCollectionConstraints;
    VkImageConstraintsInfoFlagsFUCHSIA            flags;
} VkImageConstraintsInfoFUCHSIA;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • formatConstraintsCount is the number of elements in pFormatConstraints.

  • pFormatConstraints is a pointer to an array of VkImageFormatConstraintsInfoFUCHSIA structures of size formatConstraintsCount that is used to further constrain buffer collection format selection for image-based buffer collections.

  • bufferCollectionConstraints is a VkBufferCollectionConstraintsInfoFUCHSIA structure used to supply parameters for the negotiation and allocation for buffer-based buffer collections.

  • flags is a VkImageConstraintsInfoFlagBitsFUCHSIA value specifying hints about the type of memory Sysmem should allocate for the buffer collection.

Description

Valid Usage

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06395
    All elements of pFormatConstraints must have at least one bit set in its VkImageFormatConstraintsInfoFUCHSIA::requiredFormatFeatures

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06396
    If pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_SAMPLED_BIT, then pFormatConstraints->requiredFormatFeatures must contain VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06397
    If pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_STORAGE_BIT, then pFormatConstraints->requiredFormatFeatures must contain VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06398
    If pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, then pFormatConstraints->requiredFormatFeatures must contain VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06399
    If pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, then pFormatConstraints->requiredFormatFeatures must contain VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06400
    If pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT, then pFormatConstraints->requiredFormatFeatures must contain at least one of VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT or VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT

  • VUID-VkImageConstraintsInfoFUCHSIA-attachmentFragmentShadingRate-06401
    If the attachmentFragmentShadingRate feature is enabled, and pFormatConstraints->imageCreateInfo→usage contains VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, then pFormatConstraints->requiredFormatFeatures must contain VK_FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

Valid Usage (Implicit)

  • VUID-VkImageConstraintsInfoFUCHSIA-sType-sType
    sType must be VK_STRUCTURE_TYPE_IMAGE_CONSTRAINTS_INFO_FUCHSIA

  • VUID-VkImageConstraintsInfoFUCHSIA-pNext-pNext
    pNext must be NULL

  • VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-parameter
    pFormatConstraints must be a valid pointer to an array of formatConstraintsCount valid VkImageFormatConstraintsInfoFUCHSIA structures

  • VUID-VkImageConstraintsInfoFUCHSIA-bufferCollectionConstraints-parameter
    bufferCollectionConstraints must be a valid VkBufferCollectionConstraintsInfoFUCHSIA structure

  • VUID-VkImageConstraintsInfoFUCHSIA-flags-parameter
    flags must be a valid combination of VkImageConstraintsInfoFlagBitsFUCHSIA values

  • VUID-VkImageConstraintsInfoFUCHSIA-formatConstraintsCount-arraylength
    formatConstraintsCount must be greater than 0

See Also

VK_FUCHSIA_buffer_collection, VkBufferCollectionConstraintsInfoFUCHSIA, VkImageConstraintsInfoFlagsFUCHSIA, VkImageFormatConstraintsInfoFUCHSIA, VkStructureType, vkSetBufferCollectionImageConstraintsFUCHSIA

Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.