Safe Haskell	Safe-Inferred
Language	Haskell2010

Vulkan.Extensions.VK_QCOM_fragment_density_map_offset

Description

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

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 and VK_EXT_fragment_density_map

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

Version History

Revision 1, 2021-09-03 (Matthew Netsch)
- Initial version

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 PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM = PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM {
- fragmentDensityMapOffset :: Bool
}
data PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM = PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM {
- fragmentDensityOffsetGranularity :: Extent2D
}
data SubpassFragmentDensityMapOffsetEndInfoQCOM = SubpassFragmentDensityMapOffsetEndInfoQCOM {
- fragmentDensityOffsets :: Vector Offset2D
}
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

Documentation

data PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM Source #

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)

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

data PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM Source #

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)

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

data SubpassFragmentDensityMapOffsetEndInfoQCOM Source #

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 render pass 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

Show SubpassFragmentDensityMapOffsetEndInfoQCOM Source #
Instance details Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset Methods showsPrec :: Int -> SubpassFragmentDensityMapOffsetEndInfoQCOM -> ShowS # show :: SubpassFragmentDensityMapOffsetEndInfoQCOM -> String # showList :: [SubpassFragmentDensityMapOffsetEndInfoQCOM] -> ShowS #
FromCStruct SubpassFragmentDensityMapOffsetEndInfoQCOM Source #
Instance details Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset Methods peekCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO SubpassFragmentDensityMapOffsetEndInfoQCOM Source #
ToCStruct SubpassFragmentDensityMapOffsetEndInfoQCOM Source #
Instance details Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset Methods withCStruct :: SubpassFragmentDensityMapOffsetEndInfoQCOM -> (Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b) -> IO b Source # pokeCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b -> IO b Source # withZeroCStruct :: (Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr SubpassFragmentDensityMapOffsetEndInfoQCOM -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero SubpassFragmentDensityMapOffsetEndInfoQCOM Source #
Instance details Defined in Vulkan.Extensions.VK_QCOM_fragment_density_map_offset Methods zero :: SubpassFragmentDensityMapOffsetEndInfoQCOM Source #

Name

VK_QCOM_fragment_density_map_offset

Other Extension Metadata

Description

New Structures

New Enum Constants

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

PhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM
Fields fragmentDensityMapOffset :: Bool

PhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM
Fields fragmentDensityOffsetGranularity :: Extent2D `fragmentDensityOffsetGranularity` is the granularity for fragment density offsets.

SubpassFragmentDensityMapOffsetEndInfoQCOM
Fields fragmentDensityOffsets :: Vector Offset2D `pFragmentDensityOffsets` is a pointer to an array of `Offset2D` structs, each of which describes the offset per layer.