Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Name

VK_NV_fragment_shading_rate_enums - device extension

VK_NV_fragment_shading_rate_enums

Name String

VK_NV_fragment_shading_rate_enums

Extension Type

Device extension

Registered Extension Number

327

Revision

1

Extension and Version Dependencies

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

Contact

• Pat Brown @nvpbrown%0A*Here describe the issue or question you have about the VK_NV_fragment_shading_rate_enums extension*

Other Extension Metadata

Last Modified Date

2020-09-02

Contributors

• Pat Brown, NVIDIA
• Jeff Bolz, NVIDIA

Description

This extension builds on the fragment shading rate functionality provided by the VK_KHR_fragment_shading_rate extension, adding support for “supersample” fragment shading rates that trigger multiple fragment shader invocations per pixel as well as a “no invocations” shading rate that discards any portions of a primitive that would use that shading rate.

New Commands

• cmdSetFragmentShadingRateEnumNV

New Structures

• Extending GraphicsPipelineCreateInfo:

  • PipelineFragmentShadingRateEnumStateCreateInfoNV

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

New Enums

• FragmentShadingRateNV

• FragmentShadingRateTypeNV

New Enum Constants

• NV_FRAGMENT_SHADING_RATE_ENUMS_EXTENSION_NAME

• NV_FRAGMENT_SHADING_RATE_ENUMS_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_ENUMS_FEATURES_NV
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_ENUMS_PROPERTIES_NV
  • STRUCTURE_TYPE_PIPELINE_FRAGMENT_SHADING_RATE_ENUM_STATE_CREATE_INFO_NV

Issues

1. Why was this extension created? How should it be named?

   RESOLVED: The primary goal of this extension was to expose support for supersample and “no invocations” shading rates, which are supported by the VK_NV_shading_rate_image extension but not by VK_KHR_fragment_shading_rate. Because VK_KHR_fragment_shading_rate specifies the primitive shading rate using a fragment size in pixels, it lacks a good way to specify supersample rates. To deal with this, we defined enums covering shading rates supported by the KHR extension as well as the new shading rates and added structures and APIs accepting shading rate enums instead of fragment sizes.

   Since this extension adds two different types of shading rates, both expressed using enums, we chose the extension name VK_NV_fragment_shading_rate_enums.

1. Is this a standalone extension?

   RESOLVED: No, this extension requires VK_KHR_fragment_shading_rate. In order to use the features of this extension, applications must enable the relevant features of KHR extension.

2. How are the shading rate enums used, and how were the enum values assigned?

   RESOLVED: The shading rates supported by the enums in this extension are accepted as pipeline, primitive, and attachment shading rates and behave identically. For the shading rates also supported by the KHR extension, the values assigned to the corresponding enums are identical to the values already used for the primitive and attachment shading rates in the KHR extension. For those enums, bits 0 and 1 specify the base two logarithm of the fragment height and bits 2 and 3 specify the base two logarithm of the fragment width. For the new shading rates added by this extension, we chose to use 11 through 14 (10 plus the base two logarithm of the invocation count) for the supersample rates and 15 for the “no invocations” rate. None of those values are supported as primitive or attachment shading rates by the KHR extension.

3. Between this extension, VK_KHR_fragment_shading_rate, and VK_NV_shading_rate_image, there are three different ways to specify shading rate state in a pipeline. How should we handle this?

   RESOLVED: We do not allow the concurrent use of VK_NV_shading_rate_image and VK_KHR_fragment_shading_rate; it is an error to enable shading rate features from both extensions. But we do allow applications to enable this extension together with VK_KHR_fragment_shading_rate together. While we expect that applications will never attach pipeline CreateInfo structures for both this extension and the KHR extension concurrently, Vulkan does not have any precedent forbidding such behavior and instead typically treats a pipeline created without an extension-specific CreateInfo structure as equivalent to one containing default values specified by the extension. Rather than adding such a rule considering the presence or absence of our new CreateInfo structure, we instead included a shadingRateType member to PipelineFragmentShadingRateEnumStateCreateInfoNV that selects between using state specified by that structure and state specified by PipelineFragmentShadingRateStateCreateInfoKHR.

Version History

• Revision 1, 2020-09-02 (pbrown)

  • Internal revisions

See Also

FragmentShadingRateNV, FragmentShadingRateTypeNV, PhysicalDeviceFragmentShadingRateEnumsFeaturesNV, PhysicalDeviceFragmentShadingRateEnumsPropertiesNV, PipelineFragmentShadingRateEnumStateCreateInfoNV, cmdSetFragmentShadingRateEnumNV

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

cmdSetFragmentShadingRateEnumNV

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> FragmentShadingRateNV

shadingRate specifies a FragmentShadingRateNV enum indicating 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 ()

vkCmdSetFragmentShadingRateEnumNV - Set pipeline fragment shading rate dynamically for a command buffer using enums

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 PipelineFragmentShadingRateEnumStateCreateInfoNV values used to create the currently active pipeline.

Note

This command allows specifying additional shading rates beyond those supported by cmdSetFragmentShadingRateKHR. For more information, refer to the VK_NV_fragment_shading_rate_enums appendix.

Valid Usage

• If pipelineFragmentShadingRate is not enabled, shadingRate must be FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV

• If supersampleFragmentShadingRates is not enabled, shadingRate must not be FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV, FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV, FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV, or FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV
• If noInvocationFragmentShadingRates is not enabled, shadingRate must not be FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV
• The fragmentShadingRateEnums feature must be enabled
• One of the pipelineFragmentShadingRate, primitiveFragmentShadingRate, or attachmentFragmentShadingRate features 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

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• shadingRate must be a valid FragmentShadingRateNV value
• 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
• This command must only be called outside of a video coding scope

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	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Both	Outside	Graphics	State

See Also

VK_NV_fragment_shading_rate_enums, CommandBuffer, FragmentShadingRateCombinerOpKHR, FragmentShadingRateNV

data PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

VkPhysicalDeviceFragmentShadingRateEnumsFeaturesNV - Structure indicating support for fragment shading rate enums

Members

This structure describes the following features:

Description

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

Valid Usage (Implicit)

See Also

VK_NV_fragment_shading_rate_enums, Bool32, StructureType

Constructors

PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Fields

• fragmentShadingRateEnums :: Bool

  fragmentShadingRateEnums indicates that the implementation supports specifying fragment shading rates using the FragmentShadingRateNV enumerated type.

• supersampleFragmentShadingRates :: Bool

  supersampleFragmentShadingRates indicates that the implementation supports fragment shading rate enum values indicating more than one invocation per fragment.

• noInvocationFragmentShadingRates :: Bool

  noInvocationFragmentShadingRates indicates that the implementation supports a fragment shading rate enum value indicating that no fragment shaders should be invoked when that shading rate is used.

Instances

Storable PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

sizeOf :: PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> Int

alignment :: PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> Int -> IO PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

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

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

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

peek :: Ptr PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> IO PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

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

Show PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> ShowS

show :: PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> String

showList :: [PhysicalDeviceFragmentShadingRateEnumsFeaturesNV] -> ShowS

Eq PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

(==) :: PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> Bool

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

FromCStruct PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> IO PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

ToCStruct PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsFeaturesNV -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

zero :: PhysicalDeviceFragmentShadingRateEnumsFeaturesNV

data PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

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

Description

If the PhysicalDeviceFragmentShadingRateEnumsPropertiesNV 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_NV_fragment_shading_rate_enums, SampleCountFlagBits, StructureType

Constructors

PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Fields

• maxFragmentShadingRateInvocationCount :: SampleCountFlagBits

  maxFragmentShadingRateInvocationCount is a SampleCountFlagBits value indicating the maximum number of fragment shader invocations per fragment supported in pipeline, primitive, and attachment fragment shading rates.

  maxFragmentShadingRateInvocationCount must be a valid SampleCountFlagBits value

Instances

Storable PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

sizeOf :: PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> Int

alignment :: PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> Int

peekElemOff :: Ptr PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> Int -> IO PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

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

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

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

peek :: Ptr PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> IO PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

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

Show PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

showsPrec :: Int -> PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> ShowS

show :: PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> String

showList :: [PhysicalDeviceFragmentShadingRateEnumsPropertiesNV] -> ShowS

Eq PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

(==) :: PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> Bool

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

FromCStruct PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

peekCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> IO PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

ToCStruct PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

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

pokeCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceFragmentShadingRateEnumsPropertiesNV -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

zero :: PhysicalDeviceFragmentShadingRateEnumsPropertiesNV

data PipelineFragmentShadingRateEnumStateCreateInfoNV

VkPipelineFragmentShadingRateEnumStateCreateInfoNV - Structure specifying parameters controlling the fragment shading rate using rate enums

Description

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

If this structure is not present, shadingRateType is considered to be equal to FRAGMENT_SHADING_RATE_TYPE_FRAGMENT_SIZE_NV, shadingRate is considered to be equal to FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV, and both elements of combinerOps are considered to be equal to FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR.

Valid Usage (Implicit)

See Also

VK_NV_fragment_shading_rate_enums, FragmentShadingRateCombinerOpKHR, FragmentShadingRateNV, FragmentShadingRateTypeNV, StructureType

Constructors

PipelineFragmentShadingRateEnumStateCreateInfoNV

Fields

• shadingRateType :: FragmentShadingRateTypeNV

  shadingRateType specifies a FragmentShadingRateTypeNV value indicating whether fragment shading rates are specified using fragment sizes or FragmentShadingRateNV enums.

• shadingRate :: FragmentShadingRateNV

  shadingRate specifies a FragmentShadingRateNV value indicating the pipeline fragment shading rate.

• combinerOps :: (FragmentShadingRateCombinerOpKHR, FragmentShadingRateCombinerOpKHR)

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

Instances

Storable PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

sizeOf :: PipelineFragmentShadingRateEnumStateCreateInfoNV -> Int

alignment :: PipelineFragmentShadingRateEnumStateCreateInfoNV -> Int

peekElemOff :: Ptr PipelineFragmentShadingRateEnumStateCreateInfoNV -> Int -> IO PipelineFragmentShadingRateEnumStateCreateInfoNV

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

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

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

peek :: Ptr PipelineFragmentShadingRateEnumStateCreateInfoNV -> IO PipelineFragmentShadingRateEnumStateCreateInfoNV

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

Show PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

showsPrec :: Int -> PipelineFragmentShadingRateEnumStateCreateInfoNV -> ShowS

show :: PipelineFragmentShadingRateEnumStateCreateInfoNV -> String

showList :: [PipelineFragmentShadingRateEnumStateCreateInfoNV] -> ShowS

Eq PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

(==) :: PipelineFragmentShadingRateEnumStateCreateInfoNV -> PipelineFragmentShadingRateEnumStateCreateInfoNV -> Bool

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

FromCStruct PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

peekCStruct :: Ptr PipelineFragmentShadingRateEnumStateCreateInfoNV -> IO PipelineFragmentShadingRateEnumStateCreateInfoNV

ToCStruct PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

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

pokeCStruct :: Ptr PipelineFragmentShadingRateEnumStateCreateInfoNV -> PipelineFragmentShadingRateEnumStateCreateInfoNV -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PipelineFragmentShadingRateEnumStateCreateInfoNV -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PipelineFragmentShadingRateEnumStateCreateInfoNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

zero :: PipelineFragmentShadingRateEnumStateCreateInfoNV

newtype FragmentShadingRateNV

VkFragmentShadingRateNV - Enumeration with fragment shading rates

Description

To use the shading rates FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV, FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV, FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV, and FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV as a pipeline, primitive, or attachment shading rate, the supersampleFragmentShadingRates feature must be enabled. To use the shading rate FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV as a pipeline, primitive, or attachment shading rate, the noInvocationFragmentShadingRates feature must be enabled.

See Also

VK_NV_fragment_shading_rate_enums, PipelineFragmentShadingRateEnumStateCreateInfoNV, cmdSetFragmentShadingRateEnumNV

Constructors

FragmentShadingRateNV Int32

Bundled Patterns

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV specifies a fragment size of 1x1 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_1X2_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_1X2_PIXELS_NV specifies a fragment size of 1x2 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X1_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X1_PIXELS_NV specifies a fragment size of 2x1 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X2_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X2_PIXELS_NV specifies a fragment size of 2x2 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X4_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_2X4_PIXELS_NV specifies a fragment size of 2x4 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_4X2_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_4X2_PIXELS_NV specifies a fragment size of 4x2 pixels.

pattern FRAGMENT_SHADING_RATE_1_INVOCATION_PER_4X4_PIXELS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_1_INVOCATION_PER_4X4_PIXELS_NV specifies a fragment size of 4x4 pixels.

pattern FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV specifies a fragment size of 1x1 pixels, with two fragment shader invocations per fragment.

pattern FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV specifies a fragment size of 1x1 pixels, with four fragment shader invocations per fragment.

pattern FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV specifies a fragment size of 1x1 pixels, with eight fragment shader invocations per fragment.

pattern FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV specifies a fragment size of 1x1 pixels, with sixteen fragment shader invocations per fragment.

pattern FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV :: FragmentShadingRateNV

FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV specifies that any portions of a primitive that use that shading rate should be discarded without invoking any fragment shader.

Instances

Storable FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

sizeOf :: FragmentShadingRateNV -> Int

alignment :: FragmentShadingRateNV -> Int

peekElemOff :: Ptr FragmentShadingRateNV -> Int -> IO FragmentShadingRateNV

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

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

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

peek :: Ptr FragmentShadingRateNV -> IO FragmentShadingRateNV

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

Read FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

readsPrec :: Int -> ReadS FragmentShadingRateNV

readList :: ReadS [FragmentShadingRateNV]

readPrec :: ReadPrec FragmentShadingRateNV

readListPrec :: ReadPrec [FragmentShadingRateNV]

Show FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

showsPrec :: Int -> FragmentShadingRateNV -> ShowS

show :: FragmentShadingRateNV -> String

showList :: [FragmentShadingRateNV] -> ShowS

Eq FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

(==) :: FragmentShadingRateNV -> FragmentShadingRateNV -> Bool

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

Ord FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

compare :: FragmentShadingRateNV -> FragmentShadingRateNV -> Ordering

(<) :: FragmentShadingRateNV -> FragmentShadingRateNV -> Bool

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

(>) :: FragmentShadingRateNV -> FragmentShadingRateNV -> Bool

(>=) :: FragmentShadingRateNV -> FragmentShadingRateNV -> Bool

max :: FragmentShadingRateNV -> FragmentShadingRateNV -> FragmentShadingRateNV

min :: FragmentShadingRateNV -> FragmentShadingRateNV -> FragmentShadingRateNV

Zero FragmentShadingRateNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

zero :: FragmentShadingRateNV

newtype FragmentShadingRateTypeNV

VkFragmentShadingRateTypeNV - Enumeration with fragment shading rate types

See Also

VK_NV_fragment_shading_rate_enums, PipelineFragmentShadingRateEnumStateCreateInfoNV

Constructors

FragmentShadingRateTypeNV Int32

Bundled Patterns

pattern FRAGMENT_SHADING_RATE_TYPE_FRAGMENT_SIZE_NV :: FragmentShadingRateTypeNV

FRAGMENT_SHADING_RATE_TYPE_FRAGMENT_SIZE_NV specifies that a graphics pipeline should obtain its pipeline fragment shading rate and shading rate combiner state from the PipelineFragmentShadingRateStateCreateInfoKHR structure and that any state specified by the PipelineFragmentShadingRateEnumStateCreateInfoNV structure should be ignored.

pattern FRAGMENT_SHADING_RATE_TYPE_ENUMS_NV :: FragmentShadingRateTypeNV

FRAGMENT_SHADING_RATE_TYPE_ENUMS_NV specifies that a graphics pipeline should obtain its pipeline fragment shading rate and shading rate combiner state from the PipelineFragmentShadingRateEnumStateCreateInfoNV structure and that any state specified by the PipelineFragmentShadingRateStateCreateInfoKHR structure should be ignored.

Instances

Storable FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

sizeOf :: FragmentShadingRateTypeNV -> Int

alignment :: FragmentShadingRateTypeNV -> Int

peekElemOff :: Ptr FragmentShadingRateTypeNV -> Int -> IO FragmentShadingRateTypeNV

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

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

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

peek :: Ptr FragmentShadingRateTypeNV -> IO FragmentShadingRateTypeNV

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

Read FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

readsPrec :: Int -> ReadS FragmentShadingRateTypeNV

readList :: ReadS [FragmentShadingRateTypeNV]

readPrec :: ReadPrec FragmentShadingRateTypeNV

readListPrec :: ReadPrec [FragmentShadingRateTypeNV]

Show FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

showsPrec :: Int -> FragmentShadingRateTypeNV -> ShowS

show :: FragmentShadingRateTypeNV -> String

showList :: [FragmentShadingRateTypeNV] -> ShowS

Eq FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

(==) :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> Bool

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

Ord FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

compare :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> Ordering

(<) :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> Bool

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

(>) :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> Bool

(>=) :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> Bool

max :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV

min :: FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV -> FragmentShadingRateTypeNV

Zero FragmentShadingRateTypeNV

Defined in Vulkan.Extensions.VK_NV_fragment_shading_rate_enums

Methods

zero :: FragmentShadingRateTypeNV

type NV_FRAGMENT_SHADING_RATE_ENUMS_SPEC_VERSION = 1

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

type NV_FRAGMENT_SHADING_RATE_ENUMS_EXTENSION_NAME = "VK_NV_fragment_shading_rate_enums"

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

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

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 ()

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

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

Zero FragmentShadingRateCombinerOpKHR

Defined in Vulkan.Extensions.VK_KHR_fragment_shading_rate

Methods

zero :: FragmentShadingRateCombinerOpKHR