Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Name

VK_QCOM_fragment_density_map_offset - device extension

VK_QCOM_fragment_density_map_offset

Name String

VK_QCOM_fragment_density_map_offset

Extension Type

Device extension

Registered Extension Number

426

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2 to be enabled for any device-level functionality
• Requires VK_EXT_fragment_density_map to be enabled for any device-level functionality

Contact

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

Other Extension Metadata

Last Modified Date

2021-09-03

Contributors

• Matthew Netsch, Qualcomm Technologies, Inc.
• Jonathan Wicks, Qualcomm Technologies, Inc.
• Jonathan Tinkham, Qualcomm Technologies, Inc.
• Jeff Leger, Qualcomm Technologies, Inc.

Description

This extension allows an application to specify offsets to a fragment density map attachment, changing the framebuffer location where density values are applied to without having to regenerate the fragment density map.

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

• Extending SubpassEndInfo:

  • SubpassFragmentDensityMapOffsetEndInfoQCOM

New Enum Constants

• QCOM_FRAGMENT_DENSITY_MAP_OFFSET_EXTENSION_NAME

• QCOM_FRAGMENT_DENSITY_MAP_OFFSET_SPEC_VERSION

• Extending ImageCreateFlagBits:

  • IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_OFFSET_FEATURES_QCOM
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_OFFSET_PROPERTIES_QCOM
  • STRUCTURE_TYPE_SUBPASS_FRAGMENT_DENSITY_MAP_OFFSET_END_INFO_QCOM

Version History

• Revision 1, 2021-09-03 (Matthew Netsch)

  • Initial version

See Also

PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM, PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM, SubpassFragmentDensityMapOffsetEndInfoQCOM

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 PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

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

Members

This structure describes the following feature:

Description

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

Valid Usage (Implicit)

See Also

VK_QCOM_fragment_density_map_offset, Bool32, StructureType

Constructors

PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Fields

• fragmentDensityMapOffset :: Bool

Instances

Storable PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

sizeOf :: PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> Int

alignment :: PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> Int -> IO PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

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

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

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

peek :: Ptr PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> IO PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

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

Show PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

showsPrec :: Int -> PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> ShowS

show :: PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> String

showList :: [PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM] -> ShowS

Eq PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

(==) :: PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> Bool

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

FromCStruct PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> IO PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

ToCStruct PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

zero :: PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM

data PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

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

Description

If the PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM 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_QCOM_fragment_density_map_offset, Extent2D, StructureType

Constructors

PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Fields

• fragmentDensityOffsetGranularity :: Extent2D

  fragmentDensityOffsetGranularity is the granularity for fragment density offsets.

Instances

Storable PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

sizeOf :: PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> Int

alignment :: PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> Int -> IO PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

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

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

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

peek :: Ptr PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> IO PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

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

Show PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

showsPrec :: Int -> PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> ShowS

show :: PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> String

showList :: [PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM] -> ShowS

FromCStruct PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> IO PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

ToCStruct PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

zero :: PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM

data SubpassFragmentDensityMapOffsetEndInfoQCOM

VkSubpassFragmentDensityMapOffsetEndInfoQCOM - Structure specifying fragment density map offset subpass end information

Description

The array elements are given per layer as defined by Fetch Density Value, where index = layer. Each (x,y) offset is in framebuffer pixels and shifts the fetch of the fragment density map by that amount. Offsets can be positive or negative.

Offset values specified for any subpass that is not the last subpass in the render pass are ignored. If the SubpassEndInfo::pNext chain for the last subpass of a renderpass does not include SubpassFragmentDensityMapOffsetEndInfoQCOM, or if fragmentDensityOffsetCount is zero, then the offset (0,0) is used for Fetch Density Value.

Valid Usage

• If the fragmentDensityMapOffsets feature is not enabled or fragment density map is not enabled in the render pass, fragmentDensityOffsetCount must equal 0

• If SubpassDescription::fragmentDensityMapAttachment is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If SubpassDescription::pDepthStencilAttachment is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If any element of SubpassDescription::pInputAttachments is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If any element of SubpassDescription::pColorAttachments is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If any element of SubpassDescription::pResolveAttachments is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If any element of SubpassDescription::pPreserveAttachments is not is not ATTACHMENT_UNUSED and was not created with IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM, fragmentDensityOffsetCount must equal 0
• If fragmentDensityOffsetCount is not 0 and multiview is enabled for the render pass, fragmentDensityOffsetCount must equal the layerCount that was specified in creating the fragment density map attachment view
• If fragmentDensityOffsetCount is not 0 and multiview is not enabled for the render pass, fragmentDensityOffsetCount must equal 1
• The x component of each element of pFragmentDensityOffsets must be an integer multiple of fragmentDensityOffsetGranularity.width
• The y component of each element of pFragmentDensityOffsets must be an integer multiple of fragmentDensityOffsetGranularity.height

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SUBPASS_FRAGMENT_DENSITY_MAP_OFFSET_END_INFO_QCOM

• If fragmentDensityOffsetCount is not 0, pFragmentDensityOffsets must be a valid pointer to an array of fragmentDensityOffsetCount Offset2D structures

See Also

VK_QCOM_fragment_density_map_offset, Offset2D, StructureType

Constructors

SubpassFragmentDensityMapOffsetEndInfoQCOM

Fields

• fragmentDensityOffsets :: Vector Offset2D

  pFragmentDensityOffsets is a pointer to an array of Offset2D structs, each of which describes the offset per layer.

Instances

Show SubpassFragmentDensityMapOffsetEndInfoQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

showsPrec :: Int -> SubpassFragmentDensityMapOffsetEndInfoQCOM -> ShowS

show :: SubpassFragmentDensityMapOffsetEndInfoQCOM -> String

showList :: [SubpassFragmentDensityMapOffsetEndInfoQCOM] -> ShowS

FromCStruct SubpassFragmentDensityMapOffsetEndInfoQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

peekCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO SubpassFragmentDensityMapOffsetEndInfoQCOM

ToCStruct SubpassFragmentDensityMapOffsetEndInfoQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

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

pokeCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b -> IO b

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

pokeZeroCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero SubpassFragmentDensityMapOffsetEndInfoQCOM

Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Methods

zero :: SubpassFragmentDensityMapOffsetEndInfoQCOM

type QCOM_FRAGMENT_DENSITY_MAP_OFFSET_SPEC_VERSION = 1

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

type QCOM_FRAGMENT_DENSITY_MAP_OFFSET_EXTENSION_NAME = "VK_QCOM_fragment_density_map_offset"

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