Safe Haskell	Safe-Inferred
Language	Haskell2010

Vulkan.Extensions.VK_EXT_fragment_density_map

Description

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

2

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2

Contact

Matthew Netsch @mnetsch%0A*Here describe the issue or question you have about the VK_EXT_fragment_density_map extension*

Other Extension Metadata

Last Modified Date: 2021-09-30

Interactions and External Dependencies

This extension requires SPV_EXT_fragment_invocation_density
This extension provides API support for GL_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:

If VK_KHR_format_feature_flags2 is supported:

Extending FormatFeatureFlagBits2:
- FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_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

Revision 2, 2021-09-30 (Jon Leech)
- Add interaction with VK_KHR_format_feature_flags2 to vk.xml

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.

Synopsis

data PhysicalDeviceFragmentDensityMapFeaturesEXT = PhysicalDeviceFragmentDensityMapFeaturesEXT {
}
data PhysicalDeviceFragmentDensityMapPropertiesEXT = PhysicalDeviceFragmentDensityMapPropertiesEXT {
}
data RenderPassFragmentDensityMapCreateInfoEXT = RenderPassFragmentDensityMapCreateInfoEXT {
- fragmentDensityMapAttachment :: AttachmentReference
}
type EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION = 2
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

Documentation

data PhysicalDeviceFragmentDensityMapFeaturesEXT Source #

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)

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

Instances details

Storable PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details 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 () #
Show PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods showsPrec :: Int -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> ShowS # show :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> String # showList :: [PhysicalDeviceFragmentDensityMapFeaturesEXT] -> ShowS #
Eq PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods (==) :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> Bool # (/=) :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> Bool #
FromCStruct PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
ToCStruct PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods withCStruct :: PhysicalDeviceFragmentDensityMapFeaturesEXT -> (Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapFeaturesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceFragmentDensityMapFeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods zero :: PhysicalDeviceFragmentDensityMapFeaturesEXT Source #

data PhysicalDeviceFragmentDensityMapPropertiesEXT Source #

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)

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

Storable PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
Instance details 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 () #
Show PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods showsPrec :: Int -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> ShowS # show :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> String # showList :: [PhysicalDeviceFragmentDensityMapPropertiesEXT] -> ShowS #
FromCStruct PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
ToCStruct PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods withCStruct :: PhysicalDeviceFragmentDensityMapPropertiesEXT -> (Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapPropertiesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceFragmentDensityMapPropertiesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods zero :: PhysicalDeviceFragmentDensityMapPropertiesEXT Source #

Storable RenderPassFragmentDensityMapCreateInfoEXT Source #
Instance details 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 () #
Show RenderPassFragmentDensityMapCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods showsPrec :: Int -> RenderPassFragmentDensityMapCreateInfoEXT -> ShowS # show :: RenderPassFragmentDensityMapCreateInfoEXT -> String # showList :: [RenderPassFragmentDensityMapCreateInfoEXT] -> ShowS #
FromCStruct RenderPassFragmentDensityMapCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods peekCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO RenderPassFragmentDensityMapCreateInfoEXT Source #
ToCStruct RenderPassFragmentDensityMapCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods withCStruct :: RenderPassFragmentDensityMapCreateInfoEXT -> (Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> RenderPassFragmentDensityMapCreateInfoEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr RenderPassFragmentDensityMapCreateInfoEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero RenderPassFragmentDensityMapCreateInfoEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_fragment_density_map Methods zero :: RenderPassFragmentDensityMapCreateInfoEXT Source #

Name

VK_EXT_fragment_density_map

Other Extension Metadata

Description

New Structures

New Enum Constants

New or Modified Built-In Variables

New SPIR-V Capabilities

Version History

See Also

Document Notes

Documentation

Members

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage (Implicit)

See Also

Instances

Description

Valid Usage

Valid Usage (Implicit)

See Also

Instances

RenderPassFragmentDensityMapCreateInfoEXT
Fields fragmentDensityMapAttachment :: AttachmentReference `fragmentDensityMapAttachment` is the fragment density map to use for the render pass.