VkPhysicalDeviceFragmentDensityMapFeaturesEXT - Structure describing fragment density map features that can be supported by an implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceFragmentDensityMapFeaturesEXT structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDeviceFragmentDensityMapFeaturesEXT, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Valid Usage (Implicit)

See Also

VK_EXT_fragment_density_map, Bool32, StructureType

VkPhysicalDeviceFragmentDensityMapPropertiesEXT - Structure describing fragment density map properties that can be supported by an implementation

Description

If the PhysicalDeviceFragmentDensityMapPropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_EXT_fragment_density_map, Bool32, Extent2D, StructureType

VkRenderPassFragmentDensityMapCreateInfoEXT - Structure containing fragment density map attachment for render pass

Description

The fragment density map is read at an implementation-dependent time with the following constraints determined by the attachment’s image view flags:

• IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT specifies that the fragment density map will be read by the device during PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT
• IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT specifies that the fragment density map will be read by the host during endCommandBuffer of the primary command buffer that the render pass is recorded into
• Otherwise the fragment density map will be read by the host during cmdBeginRenderPass

The fragment density map may additionally be read by the device during PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT for any mode.

If this structure is not present, it is as if fragmentDensityMapAttachment was given as ATTACHMENT_UNUSED.

Valid Usage

• If fragmentDensityMapAttachment is not ATTACHMENT_UNUSED, fragmentDensityMapAttachment must not be an element of SubpassDescription::pInputAttachments, SubpassDescription::pColorAttachments, SubpassDescription::pResolveAttachments, SubpassDescription::pDepthStencilAttachment, or SubpassDescription::pPreserveAttachments for any subpass

• If fragmentDensityMapAttachment is not ATTACHMENT_UNUSED, layout must be equal to IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT, or IMAGE_LAYOUT_GENERAL
• If fragmentDensityMapAttachment is not ATTACHMENT_UNUSED, fragmentDensityMapAttachment must reference an attachment with a loadOp equal to ATTACHMENT_LOAD_OP_LOAD or ATTACHMENT_LOAD_OP_DONT_CARE
• If fragmentDensityMapAttachment is not ATTACHMENT_UNUSED, fragmentDensityMapAttachment must reference an attachment with a storeOp equal to ATTACHMENT_STORE_OP_DONT_CARE

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDER_PASS_FRAGMENT_DENSITY_MAP_CREATE_INFO_EXT

• fragmentDensityMapAttachment must be a valid AttachmentReference structure

See Also

VK_EXT_fragment_density_map, AttachmentReference, StructureType

VkRenderingFragmentDensityMapAttachmentInfoEXT - Structure specifying fragment shading rate attachment information

Description

This structure can be included in the pNext chain of RenderingInfo to define a fragment density map. If this structure is not included in the pNext chain, imageView is treated as NULL_HANDLE.

Valid Usage

• If imageView is not NULL_HANDLE, imageLayout must be IMAGE_LAYOUT_GENERAL or IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT

• If imageView is not NULL_HANDLE, it must have been created with the IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT usage flag set_EXT
• If imageView is not NULL_HANDLE, it must not have been created with IMAGE_CREATE_SUBSAMPLED_BIT_EXT
• If the multiview feature is not enabled, PhysicalDeviceProperties::apiVersion is less than Vulkan 1.1, and imageView is not NULL_HANDLE, it must have a layerCount equal to 1

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_INFO_EXT

• imageView must be a valid ImageView handle
• imageLayout must be a valid ImageLayout value

See Also

VK_EXT_fragment_density_map, VK_KHR_dynamic_rendering, VK_VERSION_1_3, ImageLayout, ImageView, StructureType