Vulkan.Extensions.VK_EXT_fragment_density_map

Name

VK_EXT_fragment_density_map - device extension

VK_EXT_fragment_density_map

Name String

VK_EXT_fragment_density_map

Extension Type

Device extension

Registered Extension Number

219

Revision

1

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2

Contact

• Matthew Netsch https://github.com/KhronosGroup/Vulkan-Docs/issues/new?title=VK_EXT_fragment_density_map:%20&body=@mnetsch%20

Other Extension Metadata

Last Modified Date

2018-09-25

Interactions and External Dependencies

• This extension requires SPV_EXT_fragment_invocation_density

Contributors

• Matthew Netsch, Qualcomm Technologies, Inc.
• Robert VanReenen, Qualcomm Technologies, Inc.
• Jonathan Wicks, Qualcomm Technologies, Inc.
• Tate Hornbeck, Qualcomm Technologies, Inc.
• Sam Holmes, Qualcomm Technologies, Inc.
• Jeff Leger, Qualcomm Technologies, Inc.
• Jan-Harald Fredriksen, ARM
• Jeff Bolz, NVIDIA
• Pat Brown, NVIDIA
• Daniel Rakos, AMD
• Piers Daniell, NVIDIA

Description

This extension allows an application to specify areas of the render target where the fragment shader may be invoked fewer times. These fragments are broadcasted out to multiple pixels to cover the render target.

The primary use of this extension is to reduce workloads in areas where lower quality may not be perceived such as the distorted edges of a lens or the periphery of a user’s gaze.

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceFragmentDensityMapFeaturesEXT

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceFragmentDensityMapPropertiesEXT

• Extending RenderPassCreateInfo, RenderPassCreateInfo2:

  • RenderPassFragmentDensityMapCreateInfoEXT

New Enum Constants

• EXT_FRAGMENT_DENSITY_MAP_EXTENSION_NAME

• EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION

• Extending AccessFlagBits:

  • ACCESS_FRAGMENT_DENSITY_MAP_READ_BIT_EXT

• Extending FormatFeatureFlagBits:

  • FORMAT_FEATURE_FRAGMENT_DENSITY_MAP_BIT_EXT

• Extending ImageCreateFlagBits:

  • IMAGE_CREATE_SUBSAMPLED_BIT_EXT

• Extending ImageLayout:

  • IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT

• Extending ImageUsageFlagBits:

  • IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT

• Extending ImageViewCreateFlagBits:

  • IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT

• Extending PipelineStageFlagBits:

  • PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT

• Extending SamplerCreateFlagBits:

  • SAMPLER_CREATE_SUBSAMPLED_BIT_EXT
  • SAMPLER_CREATE_SUBSAMPLED_COARSE_RECONSTRUCTION_BIT_EXT

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_FEATURES_EXT
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_PROPERTIES_EXT
  • STRUCTURE_TYPE_RENDER_PASS_FRAGMENT_DENSITY_MAP_CREATE_INFO_EXT

New or Modified Built-In Variables

• FragInvocationCountEXT

• FragSizeEXT

New SPIR-V Capabilities

• FragmentDensityEXT

Version History

• Revision 1, 2018-09-25 (Matthew Netsch)

  • Initial version

See Also

PhysicalDeviceFragmentDensityMapFeaturesEXT, PhysicalDeviceFragmentDensityMapPropertiesEXT, RenderPassFragmentDensityMapCreateInfoEXT

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

data PhysicalDeviceFragmentDensityMapFeaturesEXT

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. PhysicalDeviceFragmentDensityMapFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

Bool32, StructureType

Constructors

PhysicalDeviceFragmentDensityMapFeaturesEXT

Fields

• fragmentDensityMap :: Bool

  fragmentDensityMap specifies whether the implementation supports render passes with a fragment density map attachment. If this feature is not enabled and the pNext chain of RenderPassCreateInfo includes a RenderPassFragmentDensityMapCreateInfoEXT structure, fragmentDensityMapAttachment must be ATTACHMENT_UNUSED.

• fragmentDensityMapDynamic :: Bool

  fragmentDensityMapDynamic specifies whether the implementation supports dynamic fragment density map image views. If this feature is not enabled, IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT must not be included in ImageViewCreateInfo::flags.

• fragmentDensityMapNonSubsampledImages :: Bool

  fragmentDensityMapNonSubsampledImages specifies whether the implementation supports regular non-subsampled image attachments with fragment density map render passes. If this feature is not enabled, render passes with a fragment density map attachment must only have subsampled attachments bound.

Instances

Eq PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

(==) :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> Bool

(/=) :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> Bool

Show PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

showsPrec :: Int -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> ShowS

show :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> String

showList :: [PhysicalDeviceFragmentDensityMapFeaturesEXT] -> ShowS

Storable PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

sizeOf :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> Int

alignment :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> Int -> IO PhysicalDeviceFragmentDensityMapFeaturesEXT

pokeElemOff :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> Int -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceFragmentDensityMapFeaturesEXT

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO ()

peek :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO PhysicalDeviceFragmentDensityMapFeaturesEXT

poke :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO ()

FromCStruct PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO PhysicalDeviceFragmentDensityMapFeaturesEXT

ToCStruct PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

withCStruct :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> (Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentDensityMapFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

zero :: PhysicalDeviceFragmentDensityMapFeaturesEXT

data PhysicalDeviceFragmentDensityMapPropertiesEXT

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

Bool32, Extent2D, StructureType

Constructors

PhysicalDeviceFragmentDensityMapPropertiesEXT

Fields

• minFragmentDensityTexelSize :: Extent2D

  minFragmentDensityTexelSize is the minimum fragment density texel size.

• maxFragmentDensityTexelSize :: Extent2D

  maxFragmentDensityTexelSize is the maximum fragment density texel size.

• fragmentDensityInvocations :: Bool

  fragmentDensityInvocations specifies whether the implementation may invoke additional fragment shader invocations for each covered sample.

Instances

Show PhysicalDeviceFragmentDensityMapPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

showsPrec :: Int -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> ShowS

show :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> String

showList :: [PhysicalDeviceFragmentDensityMapPropertiesEXT] -> ShowS

Storable PhysicalDeviceFragmentDensityMapPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

sizeOf :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> Int

alignment :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> Int -> IO PhysicalDeviceFragmentDensityMapPropertiesEXT

pokeElemOff :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> Int -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceFragmentDensityMapPropertiesEXT

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO ()

peek :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO PhysicalDeviceFragmentDensityMapPropertiesEXT

poke :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO ()

FromCStruct PhysicalDeviceFragmentDensityMapPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO PhysicalDeviceFragmentDensityMapPropertiesEXT

ToCStruct PhysicalDeviceFragmentDensityMapPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

withCStruct :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> (Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentDensityMapPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

zero :: PhysicalDeviceFragmentDensityMapPropertiesEXT

data RenderPassFragmentDensityMapCreateInfoEXT

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 be less than RenderPassCreateInfo::attachmentCount

• 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

AttachmentReference, StructureType

Constructors

RenderPassFragmentDensityMapCreateInfoEXT

Fields

• fragmentDensityMapAttachment :: AttachmentReference

  fragmentDensityMapAttachment is the fragment density map to use for the render pass.

Instances

Show RenderPassFragmentDensityMapCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

showsPrec :: Int -> RenderPassFragmentDensityMapCreateInfoEXT -> ShowS

show :: RenderPassFragmentDensityMapCreateInfoEXT -> String

showList :: [RenderPassFragmentDensityMapCreateInfoEXT] -> ShowS

Storable RenderPassFragmentDensityMapCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

sizeOf :: RenderPassFragmentDensityMapCreateInfoEXT -> Int

alignment :: RenderPassFragmentDensityMapCreateInfoEXT -> Int

peekElemOff :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> Int -> IO RenderPassFragmentDensityMapCreateInfoEXT

pokeElemOff :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> Int -> RenderPassFragmentDensityMapCreateInfoEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO RenderPassFragmentDensityMapCreateInfoEXT

pokeByteOff :: Ptr b -> Int -> RenderPassFragmentDensityMapCreateInfoEXT -> IO ()

peek :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO RenderPassFragmentDensityMapCreateInfoEXT

poke :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> RenderPassFragmentDensityMapCreateInfoEXT -> IO ()

FromCStruct RenderPassFragmentDensityMapCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

peekCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO RenderPassFragmentDensityMapCreateInfoEXT

ToCStruct RenderPassFragmentDensityMapCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

withCStruct :: RenderPassFragmentDensityMapCreateInfoEXT -> (Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b) -> IO b

pokeCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> RenderPassFragmentDensityMapCreateInfoEXT -> IO b -> IO b

withZeroCStruct :: (Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero RenderPassFragmentDensityMapCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_fragment_density_map

Methods

zero :: RenderPassFragmentDensityMapCreateInfoEXT

type EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION = 1

pattern EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION :: forall a. Integral a => a

type EXT_FRAGMENT_DENSITY_MAP_EXTENSION_NAME = "VK_EXT_fragment_density_map"

pattern EXT_FRAGMENT_DENSITY_MAP_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a