Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
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
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
PhysicalDeviceProperties2
:Extending
RenderPassCreateInfo
,RenderPassCreateInfo2
:
New Enum Constants
EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION
Extending
AccessFlagBits
:Extending
FormatFeatureFlagBits
:Extending
ImageCreateFlagBits
:Extending
ImageLayout
:Extending
ImageUsageFlagBits
:Extending
ImageViewCreateFlagBits
:Extending
PipelineStageFlagBits
:Extending
SamplerCreateFlagBits
:Extending
StructureType
:
If VK_KHR_format_feature_flags2 is supported:
New or Modified Built-In Variables
New SPIR-V Capabilities
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
tovk.xml
- Add interaction with
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.
Synopsis
- data PhysicalDeviceFragmentDensityMapFeaturesEXT = PhysicalDeviceFragmentDensityMapFeaturesEXT {}
- data PhysicalDeviceFragmentDensityMapPropertiesEXT = PhysicalDeviceFragmentDensityMapPropertiesEXT {}
- data RenderPassFragmentDensityMapCreateInfoEXT = RenderPassFragmentDensityMapCreateInfoEXT {}
- 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)
See Also
PhysicalDeviceFragmentDensityMapFeaturesEXT | |
|
Instances
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)
See Also
VK_EXT_fragment_density_map,
Bool32
,
Extent2D
,
StructureType
PhysicalDeviceFragmentDensityMapPropertiesEXT | |
|
Instances
data RenderPassFragmentDensityMapCreateInfoEXT Source #
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 duringPIPELINE_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 duringendCommandBuffer
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 notATTACHMENT_UNUSED
,fragmentDensityMapAttachment
must not be an element ofSubpassDescription
::pInputAttachments
,SubpassDescription
::pColorAttachments
,SubpassDescription
::pResolveAttachments
,SubpassDescription
::pDepthStencilAttachment
, orSubpassDescription
::pPreserveAttachments
for any subpass
-
If
fragmentDensityMapAttachment
is notATTACHMENT_UNUSED
,layout
must be equal toIMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT
, orIMAGE_LAYOUT_GENERAL
-
If
fragmentDensityMapAttachment
is notATTACHMENT_UNUSED
,fragmentDensityMapAttachment
must reference an attachment with aloadOp
equal toATTACHMENT_LOAD_OP_LOAD
orATTACHMENT_LOAD_OP_DONT_CARE
-
If
fragmentDensityMapAttachment
is notATTACHMENT_UNUSED
,fragmentDensityMapAttachment
must reference an attachment with astoreOp
equal toATTACHMENT_STORE_OP_DONT_CARE
Valid Usage (Implicit)
-
fragmentDensityMapAttachment
must be a validAttachmentReference
structure
See Also
VK_EXT_fragment_density_map,
AttachmentReference
,
StructureType
RenderPassFragmentDensityMapCreateInfoEXT | |
|
Instances
type EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION = 2 Source #
pattern EXT_FRAGMENT_DENSITY_MAP_SPEC_VERSION :: forall a. Integral a => a Source #
type EXT_FRAGMENT_DENSITY_MAP_EXTENSION_NAME = "VK_EXT_fragment_density_map" Source #
pattern EXT_FRAGMENT_DENSITY_MAP_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #