Vulkan.Extensions.VK_KHR_fragment_shading_rate

Name

VK_KHR_fragment_shading_rate - device extension

VK_KHR_fragment_shading_rate

Name String

VK_KHR_fragment_shading_rate

Extension Type

Device extension

Registered Extension Number

227

Revision

2

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_create_renderpass2
• Requires VK_KHR_get_physical_device_properties2

Contact

• Tobias Hector @tobski%0A<<Here describe the issue or question you have about the VK_KHR_fragment_shading_rate extension> >

Other Extension Metadata

Last Modified Date

2021-09-30

Interactions and External Dependencies

• This extension requires SPV_KHR_fragment_shading_rate.

Contributors

• Tobias Hector, AMD
• Guennadi Riguer, AMD
• Matthaeus Chajdas, AMD
• Pat Brown, Nvidia
• Matthew Netsch, Qualcomm
• Slawomir Grajewski, Intel
• Jan-Harald Fredriksen, Arm
• Jeff Bolz, Nvidia
• Contributors to the VK_NV_shading_rate_image specification
• Contributors to the VK_EXT_fragment_density_map specification

Description

This extension adds the ability to change the rate at which fragments are shaded. Rather than the usual single fragment invocation for each pixel covered by a primitive, multiple pixels can be shaded by a single fragment shader invocation.

Up to three methods are available to the application to change the fragment shading rate:

• https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#primsrast-fragment-shading-rate-pipeline, which allows the specification of a rate per-draw.
• https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#primsrast-fragment-shading-rate-primitive, which allows the specification of a rate per primitive, specified during shading.
• https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#primsrast-fragment-shading-rate-attachment, which allows the specification of a rate per-region of the framebuffer, specified in a specialized image attachment.

Additionally, these rates can all be specified and combined in order to adjust the overall detail in the image at each point.

This functionality can be used to focus shading efforts where higher levels of detail are needed in some parts of a scene compared to others. This can be particularly useful in high resolution rendering, or for XR contexts.

This extension also adds support for the SPV_KHR_fragment_shading_rate extension which enables setting the primitive fragment shading rate, and allows querying the final shading rate from a fragment shader.

New Commands

• cmdSetFragmentShadingRateKHR

• getPhysicalDeviceFragmentShadingRatesKHR

New Structures

• PhysicalDeviceFragmentShadingRateKHR

• Extending GraphicsPipelineCreateInfo:

  • PipelineFragmentShadingRateStateCreateInfoKHR

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceFragmentShadingRateFeaturesKHR

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceFragmentShadingRatePropertiesKHR

• Extending SubpassDescription2:

  • FragmentShadingRateAttachmentInfoKHR

New Enums

• FragmentShadingRateCombinerOpKHR

New Enum Constants

• KHR_FRAGMENT_SHADING_RATE_EXTENSION_NAME

• KHR_FRAGMENT_SHADING_RATE_SPEC_VERSION

• Extending AccessFlagBits:

  • ACCESS_FRAGMENT_SHADING_RATE_ATTACHMENT_READ_BIT_KHR

• Extending DynamicState:

  • DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR

• Extending FormatFeatureFlagBits:

  • FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

• Extending ImageLayout:

  • IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR

• Extending ImageUsageFlagBits:

  • IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

• Extending PipelineStageFlagBits:

  • PIPELINE_STAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

• Extending StructureType:

  • STRUCTURE_TYPE_FRAGMENT_SHADING_RATE_ATTACHMENT_INFO_KHR
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_FEATURES_KHR
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_KHR
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_PROPERTIES_KHR
  • STRUCTURE_TYPE_PIPELINE_FRAGMENT_SHADING_RATE_STATE_CREATE_INFO_KHR

If VK_KHR_format_feature_flags2 is supported:

• Extending FormatFeatureFlagBits2KHR:

  • FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

Version History

• Revision 1, 2020-05-06 (Tobias Hector)

  • Initial revision

• Revision 2, 2021-09-30 (Jon Leech)

  • Add interaction with VK_KHR_format_feature_flags2 to vk.xml

See Also

FragmentShadingRateAttachmentInfoKHR, FragmentShadingRateCombinerOpKHR, PhysicalDeviceFragmentShadingRateFeaturesKHR, PhysicalDeviceFragmentShadingRateKHR, PhysicalDeviceFragmentShadingRatePropertiesKHR, PipelineFragmentShadingRateStateCreateInfoKHR, cmdSetFragmentShadingRateKHR, getPhysicalDeviceFragmentShadingRatesKHR

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

cmdSetFragmentShadingRateKHR

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command will be recorded.

-> ("fragmentSize" ::: Extent2D)

pFragmentSize specifies the pipeline fragment shading rate for subsequent drawing commands.

-> ("combinerOps" ::: (FragmentShadingRateCombinerOpKHR, FragmentShadingRateCombinerOpKHR))

combinerOps specifies a FragmentShadingRateCombinerOpKHR determining how the pipeline, primitive, and attachment shading rates are combined for fragments generated by subsequent drawing commands.

-> io ()

vkCmdSetFragmentShadingRateKHR - Set pipeline fragment shading rate and combiner operation dynamically for a command buffer

Description

This command sets the pipeline fragment shading rate and combiner operation for subsequent drawing commands when the graphics pipeline is created with DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineFragmentShadingRateStateCreateInfoKHR values used to create the currently active pipeline.

Valid Usage

• If pipelineFragmentShadingRate is not enabled, pFragmentSize->width must be 1

• If pipelineFragmentShadingRate is not enabled, pFragmentSize->height must be 1
• One of pipelineFragmentShadingRate, primitiveFragmentShadingRate, or attachmentFragmentShadingRate must be enabled
• If the primitiveFragmentShadingRate feature is not enabled, combinerOps[0] must be FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR
• If the attachmentFragmentShadingRate feature is not enabled, combinerOps[1] must be FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR
• If the fragmentSizeNonTrivialCombinerOps limit is not supported, elements of combinerOps must be either FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR or FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR
• pFragmentSize->width must be greater than or equal to 1
• pFragmentSize->height must be greater than or equal to 1
• pFragmentSize->width must be a power-of-two value
• pFragmentSize->height must be a power-of-two value
• pFragmentSize->width must be less than or equal to 4
• pFragmentSize->height must be less than or equal to 4

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pFragmentSize must be a valid pointer to a valid Extent2D structure
• Any given element of combinerOps must be a valid FragmentShadingRateCombinerOpKHR value
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Supported Queue Types
Primary Secondary	Both	Graphics

See Also

VK_KHR_fragment_shading_rate, CommandBuffer, Extent2D, FragmentShadingRateCombinerOpKHR

getPhysicalDeviceFragmentShadingRatesKHR

Arguments

:: forall io. MonadIO io

=> PhysicalDevice

physicalDevice is the handle to the physical device whose properties will be queried.

-> io (Result, "fragmentShadingRates" ::: Vector PhysicalDeviceFragmentShadingRateKHR)

vkGetPhysicalDeviceFragmentShadingRatesKHR - Get available shading rates for a physical device

Description

If pFragmentShadingRates is NULL, then the number of fragment shading rates available is returned in pFragmentShadingRateCount. Otherwise, pFragmentShadingRateCount must point to a variable set by the user to the number of elements in the pFragmentShadingRates array, and on return the variable is overwritten with the number of structures actually written to pFragmentShadingRates. If pFragmentShadingRateCount is less than the number of fragment shading rates available, at most pFragmentShadingRateCount structures will be written, and INCOMPLETE will be returned instead of SUCCESS, to indicate that not all the available fragment shading rates were returned.

The returned array of fragment shading rates must be ordered from largest fragmentSize.width value to smallest, and each set of fragment shading rates with the same fragmentSize.width value must be ordered from largest fragmentSize.height to smallest. Any two entries in the array must not have the same fragmentSize values.

For any entry in the array, the following rules also apply:

• The value of fragmentSize.width must be less than or equal to maxFragmentSize.width.
• The value of fragmentSize.width must be greater than or equal to 1.
• The value of fragmentSize.width must be a power-of-two.
• The value of fragmentSize.height must be less than or equal to maxFragmentSize.height.
• The value of fragmentSize.height must be greater than or equal to 1.
• The value of fragmentSize.height must be a power-of-two.
• The highest sample count in sampleCounts must be less than or equal to maxFragmentShadingRateRasterizationSamples.
• The product of fragmentSize.width, fragmentSize.height, and the highest sample count in sampleCounts must be less than or equal to maxFragmentShadingRateCoverageSamples.

Implementations must support at least the following shading rates:

sampleCounts	fragmentSize
SAMPLE_COUNT_1_BIT | SAMPLE_COUNT_4_BIT	{2,2}
SAMPLE_COUNT_1_BIT | SAMPLE_COUNT_4_BIT	{2,1}
~0	{1,1}

If framebufferColorSampleCounts, includes SAMPLE_COUNT_2_BIT, the required rates must also include SAMPLE_COUNT_2_BIT.

Note

Including the {1,1} fragment size is done for completeness; it has no actual effect on the support of rendering without setting the fragment size. All sample counts and render pass transforms are supported for this rate.

The returned set of fragment shading rates must be returned in the native (rotated) coordinate system. For rasterization using render pass transform not equal to SURFACE_TRANSFORM_IDENTITY_BIT_KHR, the application must transform the returned fragment shading rates into the current (unrotated) coordinate system to get the supported rates for that transform.

Note

For example, consider an implementation returning support for 4x2, but not 2x4 in the set of supported fragment shading rates. This means that for transforms SURFACE_TRANSFORM_ROTATE_90_BIT_KHR and SURFACE_TRANSFORM_ROTATE_270_BIT_KHR, 2x4 is a supported rate, but 4x2 is an unsupported rate.

Valid Usage (Implicit)

• physicalDevice must be a valid PhysicalDevice handle

• pFragmentShadingRateCount must be a valid pointer to a uint32_t value
• If the value referenced by pFragmentShadingRateCount is not 0, and pFragmentShadingRates is not NULL, pFragmentShadingRates must be a valid pointer to an array of pFragmentShadingRateCount PhysicalDeviceFragmentShadingRateKHR structures

Return Codes

Success

• SUCCESS
• INCOMPLETE

Failure

• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_KHR_fragment_shading_rate, PhysicalDevice, PhysicalDeviceFragmentShadingRateKHR

data FragmentShadingRateAttachmentInfoKHR

VkFragmentShadingRateAttachmentInfoKHR - Structure specifying a fragment shading rate attachment for a subpass

Description

If no shading rate attachment is specified, or if this structure is not specified, the implementation behaves as if a valid shading rate attachment was specified with all texels specifying a single pixel per fragment.

Valid Usage

• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, its layout member must be equal to IMAGE_LAYOUT_GENERAL or IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR

• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.width must be a power of two value
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.width must be less than or equal to maxFragmentShadingRateAttachmentTexelSize.width
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.width must be greater than or equal to minFragmentShadingRateAttachmentTexelSize.width
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.height must be a power of two value
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.height must be less than or equal to maxFragmentShadingRateAttachmentTexelSize.height
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, shadingRateAttachmentTexelSize.height must be greater than or equal to minFragmentShadingRateAttachmentTexelSize.height
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, the quotient of shadingRateAttachmentTexelSize.width and shadingRateAttachmentTexelSize.height must be less than or equal to maxFragmentShadingRateAttachmentTexelSizeAspectRatio
• If pFragmentShadingRateAttachment is not NULL and its attachment member is not ATTACHMENT_UNUSED, the quotient of shadingRateAttachmentTexelSize.height and shadingRateAttachmentTexelSize.width must be less than or equal to maxFragmentShadingRateAttachmentTexelSizeAspectRatio

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_FRAGMENT_SHADING_RATE_ATTACHMENT_INFO_KHR

• If pFragmentShadingRateAttachment is not NULL, pFragmentShadingRateAttachment must be a valid pointer to a valid AttachmentReference2 structure

See Also

VK_KHR_fragment_shading_rate, AttachmentReference2, Extent2D, StructureType

Constructors

FragmentShadingRateAttachmentInfoKHR

Fields

• fragmentShadingRateAttachment :: Maybe (SomeStruct AttachmentReference2)

  pFragmentShadingRateAttachment is NULL or a pointer to a AttachmentReference2 structure defining the fragment shading rate attachment for this subpass.

• shadingRateAttachmentTexelSize :: Extent2D

  shadingRateAttachmentTexelSize specifies the size of the portion of the framebuffer corresponding to each texel in pFragmentShadingRateAttachment.

Instances

Show FragmentShadingRateAttachmentInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> FragmentShadingRateAttachmentInfoKHR -> ShowS

show :: FragmentShadingRateAttachmentInfoKHR -> String

showList :: [FragmentShadingRateAttachmentInfoKHR] -> ShowS

FromCStruct FragmentShadingRateAttachmentInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

peekCStruct :: Ptr FragmentShadingRateAttachmentInfoKHR -> IO FragmentShadingRateAttachmentInfoKHR

ToCStruct FragmentShadingRateAttachmentInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

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

pokeCStruct :: Ptr FragmentShadingRateAttachmentInfoKHR -> FragmentShadingRateAttachmentInfoKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr FragmentShadingRateAttachmentInfoKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero FragmentShadingRateAttachmentInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: FragmentShadingRateAttachmentInfoKHR

data PipelineFragmentShadingRateStateCreateInfoKHR

VkPipelineFragmentShadingRateStateCreateInfoKHR - Structure specifying parameters controlling the fragment shading rate

Description

If the pNext chain of GraphicsPipelineCreateInfo includes a PipelineFragmentShadingRateStateCreateInfoKHR structure, then that structure includes parameters controlling the pipeline fragment shading rate.

If this structure is not present, fragmentSize is considered to be equal to (1,1), and both elements of combinerOps are considered to be equal to FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR.

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PIPELINE_FRAGMENT_SHADING_RATE_STATE_CREATE_INFO_KHR

• Any given element of combinerOps must be a valid FragmentShadingRateCombinerOpKHR value

See Also

VK_KHR_fragment_shading_rate, Extent2D, FragmentShadingRateCombinerOpKHR, StructureType

Constructors

PipelineFragmentShadingRateStateCreateInfoKHR

Fields

• fragmentSize :: Extent2D

  fragmentSize specifies a Extent2D structure containing the fragment size used to define the pipeline fragment shading rate for drawing commands using this pipeline.

• combinerOps :: (FragmentShadingRateCombinerOpKHR, FragmentShadingRateCombinerOpKHR)

  combinerOps specifies a FragmentShadingRateCombinerOpKHR value determining how the pipeline, primitive, and attachment shading rates are combined for fragments generated by drawing commands using the created pipeline.

Instances

Show PipelineFragmentShadingRateStateCreateInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> PipelineFragmentShadingRateStateCreateInfoKHR -> ShowS

show :: PipelineFragmentShadingRateStateCreateInfoKHR -> String

showList :: [PipelineFragmentShadingRateStateCreateInfoKHR] -> ShowS

Storable PipelineFragmentShadingRateStateCreateInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

sizeOf :: PipelineFragmentShadingRateStateCreateInfoKHR -> Int

alignment :: PipelineFragmentShadingRateStateCreateInfoKHR -> Int

peekElemOff :: Ptr PipelineFragmentShadingRateStateCreateInfoKHR -> Int -> IO PipelineFragmentShadingRateStateCreateInfoKHR

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

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

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

peek :: Ptr PipelineFragmentShadingRateStateCreateInfoKHR -> IO PipelineFragmentShadingRateStateCreateInfoKHR

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

FromCStruct PipelineFragmentShadingRateStateCreateInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

peekCStruct :: Ptr PipelineFragmentShadingRateStateCreateInfoKHR -> IO PipelineFragmentShadingRateStateCreateInfoKHR

ToCStruct PipelineFragmentShadingRateStateCreateInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

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

pokeCStruct :: Ptr PipelineFragmentShadingRateStateCreateInfoKHR -> PipelineFragmentShadingRateStateCreateInfoKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PipelineFragmentShadingRateStateCreateInfoKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PipelineFragmentShadingRateStateCreateInfoKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: PipelineFragmentShadingRateStateCreateInfoKHR

data PhysicalDeviceFragmentShadingRateFeaturesKHR

VkPhysicalDeviceFragmentShadingRateFeaturesKHR - Structure indicating support for variable rate fragment shading

Members

This structure describes the following features:

Description

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

Valid Usage (Implicit)

See Also

VK_KHR_fragment_shading_rate, Bool32, StructureType

Constructors

PhysicalDeviceFragmentShadingRateFeaturesKHR

Fields

• pipelineFragmentShadingRate :: Bool

  pipelineFragmentShadingRate indicates that the implementation supports the pipeline fragment shading rate.

• primitiveFragmentShadingRate :: Bool

  primitiveFragmentShadingRate indicates that the implementation supports the primitive fragment shading rate.

• attachmentFragmentShadingRate :: Bool

  attachmentFragmentShadingRate indicates that the implementation supports the attachment fragment shading rate.

Instances

Eq PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

(==) :: PhysicalDeviceFragmentShadingRateFeaturesKHR -> PhysicalDeviceFragmentShadingRateFeaturesKHR -> Bool

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

Show PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShadingRateFeaturesKHR -> ShowS

show :: PhysicalDeviceFragmentShadingRateFeaturesKHR -> String

showList :: [PhysicalDeviceFragmentShadingRateFeaturesKHR] -> ShowS

Storable PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

sizeOf :: PhysicalDeviceFragmentShadingRateFeaturesKHR -> Int

alignment :: PhysicalDeviceFragmentShadingRateFeaturesKHR -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShadingRateFeaturesKHR -> Int -> IO PhysicalDeviceFragmentShadingRateFeaturesKHR

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

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

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

peek :: Ptr PhysicalDeviceFragmentShadingRateFeaturesKHR -> IO PhysicalDeviceFragmentShadingRateFeaturesKHR

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

FromCStruct PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShadingRateFeaturesKHR -> IO PhysicalDeviceFragmentShadingRateFeaturesKHR

ToCStruct PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShadingRateFeaturesKHR -> PhysicalDeviceFragmentShadingRateFeaturesKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShadingRateFeaturesKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShadingRateFeaturesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: PhysicalDeviceFragmentShadingRateFeaturesKHR

data PhysicalDeviceFragmentShadingRatePropertiesKHR

VkPhysicalDeviceFragmentShadingRatePropertiesKHR - Structure describing variable fragment shading rate limits that can be supported by an implementation

Description

Note

Multiplication of the combiner rates using the fragment width/height in linear space is equivalent to an addition of those values in log2 space. Some implementations inadvertently implemented an addition in linear space due to unclear requirements originating outside of this specification. This resulted in fragmentShadingRateStrictMultiplyCombiner being added. Fortunately, this only affects situations where a rate of 1 in either dimension is combined with another rate of 1. All other combinations result in the exact same result as if multiplication was performed in linear space due to the clamping logic, and the fact that both the sum and product of 2 and 2 are equal. In many cases, this limit will not affect the correct operation of applications.

If the PhysicalDeviceFragmentShadingRatePropertiesKHR structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

These properties are related to fragment shading rates.

Valid Usage (Implicit)

See Also

VK_KHR_fragment_shading_rate, Bool32, Extent2D, SampleCountFlagBits, StructureType

Constructors

PhysicalDeviceFragmentShadingRatePropertiesKHR

Fields

• minFragmentShadingRateAttachmentTexelSize :: Extent2D

  minFragmentShadingRateAttachmentTexelSize indicates minimum supported width and height of the portion of the framebuffer corresponding to each texel in a fragment shading rate attachment. Each value must be less than or equal to the values in maxFragmentShadingRateAttachmentTexelSize. Each value must be a power-of-two. It must be (0,0) if the attachmentFragmentShadingRate feature is not supported.

• maxFragmentShadingRateAttachmentTexelSize :: Extent2D

  maxFragmentShadingRateAttachmentTexelSize indicates maximum supported width and height of the portion of the framebuffer corresponding to each texel in a fragment shading rate attachment. Each value must be greater than or equal to the values in minFragmentShadingRateAttachmentTexelSize. Each value must be a power-of-two. It must be (0,0) if the attachmentFragmentShadingRate feature is not supported.

• maxFragmentShadingRateAttachmentTexelSizeAspectRatio :: Word32

  maxFragmentShadingRateAttachmentTexelSizeAspectRatio indicates the maximum ratio between the width and height of the portion of the framebuffer corresponding to each texel in a fragment shading rate attachment. maxFragmentShadingRateAttachmentTexelSizeAspectRatio must be a power-of-two value, and must be less than or equal to max(maxFragmentShadingRateAttachmentTexelSize.width / minFragmentShadingRateAttachmentTexelSize.height, maxFragmentShadingRateAttachmentTexelSize.height / minFragmentShadingRateAttachmentTexelSize.width). It must be 0 if the attachmentFragmentShadingRate feature is not supported.

• primitiveFragmentShadingRateWithMultipleViewports :: Bool

  primitiveFragmentShadingRateWithMultipleViewports specifies whether the primitive fragment shading rate can be used when multiple viewports are used. If this value is FALSE, only a single viewport must be used, and applications must not write to the ViewportMaskNV or ViewportIndex built-in when setting PrimitiveShadingRateKHR. It must be FALSE if the shaderOutputViewportIndex feature, the VK_EXT_shader_viewport_index_layer extension, or the geometryShader feature is not supported, or if the primitiveFragmentShadingRate feature is not supported.

• layeredShadingRateAttachments :: Bool

  layeredShadingRateAttachments specifies whether a shading rate attachment image view can be created with multiple layers. If this value is FALSE, when creating an image view with a usage that includes IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, layerCount must be 1. It must be FALSE if the multiview feature, the shaderOutputViewportIndex feature, the VK_EXT_shader_viewport_index_layer extension, or the geometryShader feature is not supported, or if the attachmentFragmentShadingRate feature is not supported.

• fragmentShadingRateNonTrivialCombinerOps :: Bool

  fragmentShadingRateNonTrivialCombinerOps specifies whether FragmentShadingRateCombinerOpKHR enums other than FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR or FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR can be used. It must be FALSE unless either the primitiveFragmentShadingRate or attachmentFragmentShadingRate feature is supported.

• maxFragmentSize :: Extent2D

  maxFragmentSize indicates the maximum supported width and height of a fragment. Its width and height members must both be power-of-two values. This limit is purely informational, and is not validated.

• maxFragmentSizeAspectRatio :: Word32

  maxFragmentSizeAspectRatio indicates the maximum ratio between the width and height of a fragment. maxFragmentSizeAspectRatio must be a power-of-two value, and must be less than or equal to the maximum of the width and height members of maxFragmentSize. This limit is purely informational, and is not validated.

• maxFragmentShadingRateCoverageSamples :: Word32

  maxFragmentShadingRateCoverageSamples specifies the maximum number of coverage samples supported in a single fragment. maxFragmentShadingRateCoverageSamples must be less than or equal to the product of the width and height members of maxFragmentSize, and the sample count reported by maxFragmentShadingRateRasterizationSamples. maxFragmentShadingRateCoverageSamples must be less than or equal to maxSampleMaskWords × 32 if fragmentShadingRateWithShaderSampleMask is supported. This limit is purely informational, and is not validated.

• maxFragmentShadingRateRasterizationSamples :: SampleCountFlagBits

  maxFragmentShadingRateRasterizationSamples is a SampleCountFlagBits value specifying the maximum sample rate supported when a fragment covers multiple pixels. This limit is purely informational, and is not validated.

• fragmentShadingRateWithShaderDepthStencilWrites :: Bool

  fragmentShadingRateWithShaderDepthStencilWrites specifies whether the implementation supports writing FragDepth or FragStencilRefEXT from a fragment shader for multi-pixel fragments. If this value is FALSE, writing to those built-ins will clamp the fragment shading rate to (1,1).

• fragmentShadingRateWithSampleMask :: Bool

  fragmentShadingRateWithSampleMask specifies whether the the implementation supports setting valid bits of PipelineMultisampleStateCreateInfo::pSampleMask to 0 for multi-pixel fragments. If this value is FALSE, zeroing valid bits in the sample mask will clamp the fragment shading rate to (1,1).

• fragmentShadingRateWithShaderSampleMask :: Bool

  fragmentShadingRateWithShaderSampleMask specifies whether the implementation supports reading or writing SampleMask for multi-pixel fragments. If this value is FALSE, using that built-in will clamp the fragment shading rate to (1,1).

• fragmentShadingRateWithConservativeRasterization :: Bool

  fragmentShadingRateWithConservativeRasterization specifies whether conservative rasterization is supported for multi-pixel fragments. It must be FALSE if VK_EXT_conservative_rasterization is not supported. If this value is FALSE, using conservative rasterization will clamp the fragment shading rate to (1,1).

• fragmentShadingRateWithFragmentShaderInterlock :: Bool

  fragmentShadingRateWithFragmentShaderInterlock specifies whether fragment shader interlock is supported for multi-pixel fragments. It must be FALSE if VK_EXT_fragment_shader_interlock is not supported. If this value is FALSE, using fragment shader interlock will clamp the fragment shading rate to (1,1).

• fragmentShadingRateWithCustomSampleLocations :: Bool

  fragmentShadingRateWithCustomSampleLocations specifies whether custom sample locations are supported for multi-pixel fragments. It must be FALSE if VK_EXT_sample_locations is not supported. If this value is FALSE, using custom sample locations will clamp the fragment shading rate to (1,1).

• fragmentShadingRateStrictMultiplyCombiner :: Bool

  fragmentShadingRateStrictMultiplyCombiner specifies whether FRAGMENT_SHADING_RATE_COMBINER_OP_MUL_KHR accurately performs a multiplication or not. Implementations where this value is FALSE will instead combine rates with an addition. If fragmentShadingRateNonTrivialCombinerOps is FALSE, implementations must report this as FALSE. If fragmentShadingRateNonTrivialCombinerOps is TRUE, implementations should report this as TRUE.

Instances

Show PhysicalDeviceFragmentShadingRatePropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShadingRatePropertiesKHR -> ShowS

show :: PhysicalDeviceFragmentShadingRatePropertiesKHR -> String

showList :: [PhysicalDeviceFragmentShadingRatePropertiesKHR] -> ShowS

Storable PhysicalDeviceFragmentShadingRatePropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

sizeOf :: PhysicalDeviceFragmentShadingRatePropertiesKHR -> Int

alignment :: PhysicalDeviceFragmentShadingRatePropertiesKHR -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShadingRatePropertiesKHR -> Int -> IO PhysicalDeviceFragmentShadingRatePropertiesKHR

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

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

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

peek :: Ptr PhysicalDeviceFragmentShadingRatePropertiesKHR -> IO PhysicalDeviceFragmentShadingRatePropertiesKHR

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

FromCStruct PhysicalDeviceFragmentShadingRatePropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShadingRatePropertiesKHR -> IO PhysicalDeviceFragmentShadingRatePropertiesKHR

ToCStruct PhysicalDeviceFragmentShadingRatePropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShadingRatePropertiesKHR -> PhysicalDeviceFragmentShadingRatePropertiesKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShadingRatePropertiesKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShadingRatePropertiesKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: PhysicalDeviceFragmentShadingRatePropertiesKHR

data PhysicalDeviceFragmentShadingRateKHR

VkPhysicalDeviceFragmentShadingRateKHR - Structure returning information about sample count specific additional multisampling capabilities

Valid Usage (Implicit)

See Also

VK_KHR_fragment_shading_rate, Extent2D, SampleCountFlags, StructureType, getPhysicalDeviceFragmentShadingRatesKHR

Constructors

PhysicalDeviceFragmentShadingRateKHR

Fields

• sampleCounts :: SampleCountFlags

  sampleCounts is a bitmask of sample counts for which the shading rate described by fragmentSize is supported.

• fragmentSize :: Extent2D

  fragmentSize is a Extent2D describing the width and height of a supported shading rate.

Instances

Show PhysicalDeviceFragmentShadingRateKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShadingRateKHR -> ShowS

show :: PhysicalDeviceFragmentShadingRateKHR -> String

showList :: [PhysicalDeviceFragmentShadingRateKHR] -> ShowS

Storable PhysicalDeviceFragmentShadingRateKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

sizeOf :: PhysicalDeviceFragmentShadingRateKHR -> Int

alignment :: PhysicalDeviceFragmentShadingRateKHR -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShadingRateKHR -> Int -> IO PhysicalDeviceFragmentShadingRateKHR

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

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

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

peek :: Ptr PhysicalDeviceFragmentShadingRateKHR -> IO PhysicalDeviceFragmentShadingRateKHR

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

FromCStruct PhysicalDeviceFragmentShadingRateKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShadingRateKHR -> IO PhysicalDeviceFragmentShadingRateKHR

ToCStruct PhysicalDeviceFragmentShadingRateKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShadingRateKHR -> PhysicalDeviceFragmentShadingRateKHR -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShadingRateKHR -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShadingRateKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: PhysicalDeviceFragmentShadingRateKHR

newtype FragmentShadingRateCombinerOpKHR

VkFragmentShadingRateCombinerOpKHR - Control how fragment shading rates are combined

Description

where combine(Axy,Bxy) is the combine operation, and Axy and Bxy are the inputs to the operation.

If fragmentShadingRateStrictMultiplyCombiner is FALSE, using FRAGMENT_SHADING_RATE_COMBINER_OP_MUL_KHR with values of 1 for both A and B in the same dimension results in the value 2 being produced for that dimension. See the definition of fragmentShadingRateStrictMultiplyCombiner for more information.

These operations are performed in a component-wise fashion.

See Also

VK_KHR_fragment_shading_rate, PipelineFragmentShadingRateEnumStateCreateInfoNV, PipelineFragmentShadingRateStateCreateInfoKHR, cmdSetFragmentShadingRateEnumNV, cmdSetFragmentShadingRateKHR

Constructors

FragmentShadingRateCombinerOpKHR Int32

Bundled Patterns

pattern FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR :: FragmentShadingRateCombinerOpKHR

FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR specifies a combiner operation of combine(Axy,Bxy) = Axy.

pattern FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR :: FragmentShadingRateCombinerOpKHR

FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR specifies a combiner operation of combine(Axy,Bxy) = Bxy.

pattern FRAGMENT_SHADING_RATE_COMBINER_OP_MIN_KHR :: FragmentShadingRateCombinerOpKHR

FRAGMENT_SHADING_RATE_COMBINER_OP_MIN_KHR specifies a combiner operation of combine(Axy,Bxy) = min(Axy,Bxy).

pattern FRAGMENT_SHADING_RATE_COMBINER_OP_MAX_KHR :: FragmentShadingRateCombinerOpKHR

FRAGMENT_SHADING_RATE_COMBINER_OP_MAX_KHR specifies a combiner operation of combine(Axy,Bxy) = max(Axy,Bxy).

pattern FRAGMENT_SHADING_RATE_COMBINER_OP_MUL_KHR :: FragmentShadingRateCombinerOpKHR

FRAGMENT_SHADING_RATE_COMBINER_OP_MUL_KHR specifies a combiner operation of combine(Axy,Bxy) = Axy*Bxy.

Instances

Eq FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

(==) :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Bool

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

Ord FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

compare :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Ordering

(<) :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Bool

(<=) :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Bool

(>) :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Bool

(>=) :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> Bool

max :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR

min :: FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR -> FragmentShadingRateCombinerOpKHR

Read FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

readsPrec :: Int -> ReadS FragmentShadingRateCombinerOpKHR

readList :: ReadS [FragmentShadingRateCombinerOpKHR]

readPrec :: ReadPrec FragmentShadingRateCombinerOpKHR

readListPrec :: ReadPrec [FragmentShadingRateCombinerOpKHR]

Show FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

showsPrec :: Int -> FragmentShadingRateCombinerOpKHR -> ShowS

show :: FragmentShadingRateCombinerOpKHR -> String

showList :: [FragmentShadingRateCombinerOpKHR] -> ShowS

Storable FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

sizeOf :: FragmentShadingRateCombinerOpKHR -> Int

alignment :: FragmentShadingRateCombinerOpKHR -> Int

peekElemOff :: Ptr FragmentShadingRateCombinerOpKHR -> Int -> IO FragmentShadingRateCombinerOpKHR

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

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

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

peek :: Ptr FragmentShadingRateCombinerOpKHR -> IO FragmentShadingRateCombinerOpKHR

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

Zero FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: FragmentShadingRateCombinerOpKHR

type KHR_FRAGMENT_SHADING_RATE_SPEC_VERSION = 2

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

type KHR_FRAGMENT_SHADING_RATE_EXTENSION_NAME = "VK_KHR_fragment_shading_rate"

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

newtype FormatFeatureFlagBits2KHR

VkFormatFeatureFlagBits2KHR - Bitmask specifying features supported by a buffer

Description

The following bits may be set in linearTilingFeatures and optimalTilingFeatures, specifying that the features are supported by images or image views or sampler Y′CBCR conversion objects created with the queried getPhysicalDeviceFormatProperties2::format:

• FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR specifies that an image view can be sampled from.
• FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR specifies that an image view can be used as a storage image.
• FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR specifies that an image view can be used as storage image that supports atomic operations.
• FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer color attachment and as an input attachment.
• FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR specifies that an image view can be used as a framebuffer color attachment that supports blending and as an input attachment.
• FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer depth/stencil attachment and as an input attachment.
• FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR specifies that an image can be used as srcImage for the cmdBlitImage2KHR and cmdBlitImage commands.
• FORMAT_FEATURE_2_BLIT_DST_BIT_KHR specifies that an image can be used as dstImage for the cmdBlitImage2KHR and cmdBlitImage commands.

• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR specifies that if FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR is also set, an image view can be used with a sampler that has either of magFilter or minFilter set to FILTER_LINEAR, or mipmapMode set to SAMPLER_MIPMAP_MODE_LINEAR. If FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR is also set, an image can be used as the srcImage to cmdBlitImage2KHR and cmdBlitImage with a filter of FILTER_LINEAR. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR or FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR.

  If the format being queried is a depth/stencil format, this bit only specifies that the depth aspect (not the stencil aspect) of an image of this format supports linear filtering. Where depth comparison is supported it may be linear filtered whether this bit is present or not, but where this bit is not present the filtered value may be computed in an implementation-dependent manner which differs from the normal rules of linear filtering. The resulting value must be in the range [0,1] and should be proportional to, or a weighted average of, the number of comparison passes or failures.

• FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR specifies that an image can be used as a source image for copy commands.
• FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR specifies that an image can be used as a destination image for copy commands and clear commands.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR specifies Image can be used as a sampled image with a min or max SamplerReductionMode. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT specifies that Image can be used with a sampler that has either of magFilter or minFilter set to FILTER_CUBIC_EXT, or be the source image for a blit with filter set to FILTER_CUBIC_EXT. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR. If the format being queried is a depth/stencil format, this only specifies that the depth aspect is cubic filterable.
• FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_MIDPOINT. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_COSITED_EVEN. If a format does not incorporate chroma downsampling (it is not a “422” or “420” format) but the implementation supports sampler Y′CBCR conversion for this format, the implementation must set FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR.
• FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_COSITED_EVEN. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_MIDPOINT. If neither FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR nor FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR is set, the application must not define a sampler Y′CBCR conversion using this format as a source.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source with chromaFilter set to FILTER_LINEAR.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR specifies that the format can have different chroma, min, and mag filters.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR specifies that reconstruction is explicit, as described in https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#textures-chroma-reconstruction. If this bit is not present, reconstruction is implicit by default.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR specifies that reconstruction can be forcibly made explicit by setting SamplerYcbcrConversionCreateInfo::forceExplicitReconstruction to TRUE. If the format being queried supports FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR it must also support FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR.
• FORMAT_FEATURE_2_DISJOINT_BIT_KHR specifies that a multi-planar image can have the IMAGE_CREATE_DISJOINT_BIT set during image creation. An implementation must not set FORMAT_FEATURE_2_DISJOINT_BIT_KHR for single-plane formats.
• FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT specifies that an image view can be used as a fragment density map attachment.
• FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR specifies that an image view can be used as a fragment shading rate attachment. An implementation must not set this feature for formats with numeric type other than *UINT, or set it as a buffer feature.
• FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for read operations without specifying a format.
• FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for write operations without specifying a format.
• FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR specifies that image views created with this format can be used for depth comparison performed by OpImage*Dref instructions.

The following bits may be set in bufferFeatures, specifying that the features are supported by buffers or buffer views created with the queried getPhysicalDeviceFormatProperties2::format:

• FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER descriptor.
• FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER descriptor.
• FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR specifies that atomic operations are supported on DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER with this format.
• FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as a vertex attribute format (VertexInputAttributeDescription::format).
• FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as the vertex format when creating an acceleration structure (AccelerationStructureGeometryTrianglesDataKHR::vertexFormat). This format can also be used as the vertex format in host memory when doing host acceleration structure builds.

See Also

VK_KHR_format_feature_flags2

Constructors

FormatFeatureFlagBits2KHR Flags64

Bundled Patterns

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR specifies that an image view can be sampled from.

pattern FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_IMAGE_BIT_KHR specifies that an image view can be used as a storage image.

pattern FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_IMAGE_ATOMIC_BIT_KHR specifies that an image view can be used as storage image that supports atomic operations.

pattern FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_UNIFORM_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER descriptor.

pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_BIT_KHR specifies that the format can be used to create a buffer view that can be bound to a DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER descriptor.

pattern FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_TEXEL_BUFFER_ATOMIC_BIT_KHR specifies that atomic operations are supported on DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER with this format.

pattern FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as a vertex attribute format (VertexInputAttributeDescription::format).

pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COLOR_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer color attachment and as an input attachment.

pattern FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COLOR_ATTACHMENT_BLEND_BIT_KHR specifies that an image view can be used as a framebuffer color attachment that supports blending and as an input attachment.

pattern FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_DEPTH_STENCIL_ATTACHMENT_BIT_KHR specifies that an image view can be used as a framebuffer depth/stencil attachment and as an input attachment.

pattern FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR specifies that an image can be used as srcImage for the cmdBlitImage2KHR and cmdBlitImage commands.

pattern FORMAT_FEATURE_2_BLIT_DST_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_BLIT_DST_BIT_KHR specifies that an image can be used as dstImage for the cmdBlitImage2KHR and cmdBlitImage commands.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_LINEAR_BIT_KHR specifies that if FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR is also set, an image view can be used with a sampler that has either of magFilter or minFilter set to FILTER_LINEAR, or mipmapMode set to SAMPLER_MIPMAP_MODE_LINEAR. If FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR is also set, an image can be used as the srcImage to cmdBlitImage2KHR and cmdBlitImage with a filter of FILTER_LINEAR. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR or FORMAT_FEATURE_2_BLIT_SRC_BIT_KHR.

If the format being queried is a depth/stencil format, this bit only specifies that the depth aspect (not the stencil aspect) of an image of this format supports linear filtering. Where depth comparison is supported it may be linear filtered whether this bit is present or not, but where this bit is not present the filtered value may be computed in an implementation-dependent manner which differs from the normal rules of linear filtering. The resulting value must be in the range [0,1] and should be proportional to, or a weighted average of, the number of comparison passes or failures.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT specifies that Image can be used with a sampler that has either of magFilter or minFilter set to FILTER_CUBIC_EXT, or be the source image for a blit with filter set to FILTER_CUBIC_EXT. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR. If the format being queried is a depth/stencil format, this only specifies that the depth aspect is cubic filterable.

pattern FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_TRANSFER_SRC_BIT_KHR specifies that an image can be used as a source image for copy commands.

pattern FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_TRANSFER_DST_BIT_KHR specifies that an image can be used as a destination image for copy commands and clear commands.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_FILTER_MINMAX_BIT_KHR specifies Image can be used as a sampled image with a min or max SamplerReductionMode. This bit must only be exposed for formats that also support the FORMAT_FEATURE_2_SAMPLED_IMAGE_BIT_KHR.

pattern FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_MIDPOINT. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_COSITED_EVEN. If a format does not incorporate chroma downsampling (it is not a “422” or “420” format) but the implementation supports sampler Y′CBCR conversion for this format, the implementation must set FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source with chromaFilter set to FILTER_LINEAR.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR specifies that the format can have different chroma, min, and mag filters.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR specifies that reconstruction is explicit, as described in https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#textures-chroma-reconstruction. If this bit is not present, reconstruction is implicit by default.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR specifies that reconstruction can be forcibly made explicit by setting SamplerYcbcrConversionCreateInfo::forceExplicitReconstruction to TRUE. If the format being queried supports FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR it must also support FORMAT_FEATURE_2_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR.

pattern FORMAT_FEATURE_2_DISJOINT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_DISJOINT_BIT_KHR specifies that a multi-planar image can have the IMAGE_CREATE_DISJOINT_BIT set during image creation. An implementation must not set FORMAT_FEATURE_2_DISJOINT_BIT_KHR for single-plane formats.

pattern FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR specifies that an application can define a sampler Y′CBCR conversion using this format as a source, and that an image of this format can be used with a SamplerYcbcrConversionCreateInfo xChromaOffset and/or yChromaOffset of CHROMA_LOCATION_COSITED_EVEN. Otherwise both xChromaOffset and yChromaOffset must be CHROMA_LOCATION_MIDPOINT. If neither FORMAT_FEATURE_2_COSITED_CHROMA_SAMPLES_BIT_KHR nor FORMAT_FEATURE_2_MIDPOINT_CHROMA_SAMPLES_BIT_KHR is set, the application must not define a sampler Y′CBCR conversion using this format as a source.

pattern FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for read operations without specifying a format.

pattern FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT_KHR specifies that image views created with this format can be used as storage images for write operations without specifying a format.

pattern FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT_KHR specifies that image views created with this format can be used for depth comparison performed by OpImage*Dref instructions.

pattern FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR specifies that an image view can be used as a fragment shading rate attachment. An implementation must not set this feature for formats with numeric type other than *UINT, or set it as a buffer feature.

pattern FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_FRAGMENT_DENSITY_MAP_BIT_EXT specifies that an image view can be used as a fragment density map attachment.

pattern FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR :: FormatFeatureFlagBits2KHR

FORMAT_FEATURE_2_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR specifies that the format can be used as the vertex format when creating an acceleration structure (AccelerationStructureGeometryTrianglesDataKHR::vertexFormat). This format can also be used as the vertex format in host memory when doing host acceleration structure builds.

Instances

Eq FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

(==) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

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

Ord FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

compare :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Ordering

(<) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(<=) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(>) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

(>=) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> Bool

max :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

min :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

Read FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

readsPrec :: Int -> ReadS FormatFeatureFlagBits2KHR

readList :: ReadS [FormatFeatureFlagBits2KHR]

readPrec :: ReadPrec FormatFeatureFlagBits2KHR

readListPrec :: ReadPrec [FormatFeatureFlagBits2KHR]

Show FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

showsPrec :: Int -> FormatFeatureFlagBits2KHR -> ShowS

show :: FormatFeatureFlagBits2KHR -> String

showList :: [FormatFeatureFlagBits2KHR] -> ShowS

Storable FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

sizeOf :: FormatFeatureFlagBits2KHR -> Int

alignment :: FormatFeatureFlagBits2KHR -> Int

peekElemOff :: Ptr FormatFeatureFlagBits2KHR -> Int -> IO FormatFeatureFlagBits2KHR

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

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

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

peek :: Ptr FormatFeatureFlagBits2KHR -> IO FormatFeatureFlagBits2KHR

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

Bits FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

(.&.) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

(.|.) :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

xor :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

complement :: FormatFeatureFlagBits2KHR -> FormatFeatureFlagBits2KHR

shift :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotate :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

zeroBits :: FormatFeatureFlagBits2KHR

bit :: Int -> FormatFeatureFlagBits2KHR

setBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

clearBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

complementBit :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

testBit :: FormatFeatureFlagBits2KHR -> Int -> Bool

bitSizeMaybe :: FormatFeatureFlagBits2KHR -> Maybe Int

bitSize :: FormatFeatureFlagBits2KHR -> Int

isSigned :: FormatFeatureFlagBits2KHR -> Bool

shiftL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

unsafeShiftL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

shiftR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

unsafeShiftR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotateL :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

rotateR :: FormatFeatureFlagBits2KHR -> Int -> FormatFeatureFlagBits2KHR

popCount :: FormatFeatureFlagBits2KHR -> Int

FiniteBits FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

finiteBitSize :: FormatFeatureFlagBits2KHR -> Int

countLeadingZeros :: FormatFeatureFlagBits2KHR -> Int

countTrailingZeros :: FormatFeatureFlagBits2KHR -> Int

Zero FormatFeatureFlagBits2KHR

Defined in Vulkan.Extensions.VK_KHR_acceleration_structure

Methods

zero :: FormatFeatureFlagBits2KHR

type FormatFeatureFlags2KHR = FormatFeatureFlagBits2KHR

type Flags64 = Word64

VkFlags64 - Vulkan 64-bit bitmasks

Description

When the 31 bits available in Flags are insufficient, the Flags64 type can be passed to commands and structures to represent up to 64 options. Flags64 is not used directly in the API. Instead, a Vk*Flags2 type which is an alias of Flags64, and whose name matches the corresponding Vk*FlagBits2 that are valid for that type, is used.

Any Vk*Flags2 member or parameter used in the API as an input must be a valid combination of bit flags. A valid combination is either zero or the bitwise OR of valid bit flags. A bit flag is valid if:

• The bit flag is defined as part of the Vk*FlagBits2 type, where the bits type is obtained by taking the flag type and replacing the trailing Flags2 with FlagBits2. For example, a flag value of type AccessFlags2KHR must contain only bit flags defined by AccessFlagBits2KHR.
• The flag is allowed in the context in which it is being used. For example, in some cases, certain bit flags or combinations of bit flags are mutually exclusive.

Any Vk*Flags2 member or parameter returned from a query command or otherwise output from Vulkan to the application may contain bit flags undefined in its corresponding Vk*FlagBits2 type. An application cannot rely on the state of these unspecified bits.

Note

Both the Vk*FlagBits2 type, and the individual bits defined for that type, are defined as uint64_t integers in the C API. This is in contrast to the 32-bit types, where the Vk*FlagBits type is defined as a C enum and the individual bits as enumerants belonging to that enum. As a result, there is less compile-time type checking possible for the 64-bit types. This is unavoidable since there is no sufficiently portable way to define a 64-bit enum type in C99.

See Also

VK_KHR_synchronization2, Flags