Safe Haskell	None
Language	Haskell2010

Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Description

Name

VK_EXT_extended_dynamic_state2 - device extension

VK_EXT_extended_dynamic_state2

Name String: VK_EXT_extended_dynamic_state2

Extension Type

Device extension

Registered Extension Number

378

Revision

1

Ratification Status

Ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Vulkan Version 1.1

Deprecation State

Promoted to Vulkan 1.3

Contact

Vikram Kushwaha @vkushwaha-nv%0A*Here describe the issue or question you have about the VK_EXT_extended_dynamic_state2 extension*

Other Extension Metadata

Last Modified Date: 2021-04-12

IP Status

No known IP claims.

Contributors

Vikram Kushwaha, NVIDIA
Piers Daniell, NVIDIA
Jeff Bolz, NVIDIA

Description

This extension adds some more dynamic state to support applications that need to reduce the number of pipeline state objects they compile and bind.

New Commands

cmdSetDepthBiasEnableEXT

New Structures

Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
- PhysicalDeviceExtendedDynamicState2FeaturesEXT

New Enum Constants

EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME

Promotion to Vulkan 1.3

The dynamic state enumerants DYNAMIC_STATE_DEPTH_BIAS_ENABLE_EXT, DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT, and DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE_EXT; and the corresponding commands in this extension are included in core Vulkan 1.3, with the EXT suffix omitted. The enumerants and commands for dynamic logic operation and patch control points are not promoted, nor is the feature structure. Extension interfaces that were promoted remain available as aliases of the core functionality.

Version History

Revision 1, 2021-04-12 (Vikram Kushwaha)
- Internal revisions

Document Notes

For more information, see the Vulkan Specification.

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Synopsis

cmdSetPatchControlPointsEXT :: MonadIO io => CommandBuffer -> ("patchControlPoints" ::: Word32) -> io ()
cmdSetLogicOpEXT :: MonadIO io => CommandBuffer -> LogicOp -> io ()
pattern DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE_EXT :: DynamicState
pattern DYNAMIC_STATE_DEPTH_BIAS_ENABLE_EXT :: DynamicState
pattern DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT :: DynamicState
cmdSetRasterizerDiscardEnableEXT :: MonadIO io => CommandBuffer -> ("rasterizerDiscardEnable" ::: Bool) -> io ()
cmdSetDepthBiasEnableEXT :: MonadIO io => CommandBuffer -> ("depthBiasEnable" ::: Bool) -> io ()
cmdSetPrimitiveRestartEnableEXT :: MonadIO io => CommandBuffer -> ("primitiveRestartEnable" ::: Bool) -> io ()
data PhysicalDeviceExtendedDynamicState2FeaturesEXT = PhysicalDeviceExtendedDynamicState2FeaturesEXT {
}
type EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION = 1
pattern EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION :: Integral a => a
type EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME = "VK_EXT_extended_dynamic_state2"
pattern EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME :: (Eq a, IsString a) => a

Documentation

cmdSetPatchControlPointsEXT Source #

Arguments

:: MonadIO io
=> CommandBuffer	`commandBuffer` is the command buffer into which the command will be recorded.
-> ("patchControlPoints" ::: Word32)	`patchControlPoints` specifies the number of control points per patch.
-> io ()

vkCmdSetPatchControlPointsEXT - Specify the number of control points per patch dynamically for a command buffer

Description

This command sets the number of control points per patch for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineTessellationStateCreateInfo::patchControlPoints value used to create the currently active pipeline.

Valid Usage

At least one of the following must be true:
- The extendedDynamicState2PatchControlPoints feature is enabled
- The shaderObject feature is enabled

patchControlPoints must be greater than zero and less than or equal to PhysicalDeviceLimits::maxTessellationPatchSize

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

commandBuffer must be in the recording state
The CommandPool that commandBuffer was allocated from must support QUEUE_GRAPHICS_BIT 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	VK_QUEUE_GRAPHICS_BIT	State

Conditional Rendering

vkCmdSetPatchControlPointsEXT is not affected by conditional rendering

Description

This command sets the logical operation for blend state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_LOGIC_OP_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendStateCreateInfo::logicOp value used to create the currently active pipeline.

Valid Usage

At least one of the following must be true:
- The extendedDynamicState2LogicOp feature is enabled
- The shaderObject feature is enabled

Valid Usage (Implicit)

commandBuffer must be a valid CommandBuffer handle

logicOp must be a valid LogicOp value
commandBuffer must be in the recording state
The CommandPool that commandBuffer was allocated from must support QUEUE_GRAPHICS_BIT 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	VK_QUEUE_GRAPHICS_BIT	State

Conditional Rendering

vkCmdSetLogicOpEXT is not affected by conditional rendering

Members

This structure describes the following features:

Description

If the PhysicalDeviceExtendedDynamicState2FeaturesEXT 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. If the application wishes to use a Device with any features described by PhysicalDeviceExtendedDynamicState2FeaturesEXT, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Valid Usage (Implicit)

extendedDynamicState2 :: Bool
extendedDynamicState2 indicates that the implementation supports the following dynamic states:
extendedDynamicState2LogicOp :: Bool
extendedDynamicState2LogicOp indicates that the implementation supports the following dynamic state:
- DYNAMIC_STATE_LOGIC_OP_EXT
extendedDynamicState2PatchControlPoints :: Bool
extendedDynamicState2PatchControlPoints indicates that the implementation supports the following dynamic state:
- DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT

Instances

Instances details

Eq PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods (==) :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Bool # (/=) :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Bool #
Storable PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods sizeOf :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Int # alignment :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Int # peekElemOff :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Int -> IO PhysicalDeviceExtendedDynamicState2FeaturesEXT # pokeElemOff :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Int -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO () # peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceExtendedDynamicState2FeaturesEXT # pokeByteOff :: Ptr b -> Int -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO () # peek :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO PhysicalDeviceExtendedDynamicState2FeaturesEXT # poke :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO () #
Show PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods showsPrec :: Int -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> ShowS # show :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> String # showList :: [PhysicalDeviceExtendedDynamicState2FeaturesEXT] -> ShowS #
FromCStruct PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods peekCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
ToCStruct PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods withCStruct :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> (Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b) -> IO b Source # pokeCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b -> IO b Source # withZeroCStruct :: (Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b -> IO b Source # cStructSize :: Int Source # cStructAlignment :: Int Source #
Zero PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #
Instance details Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2 Methods zero :: PhysicalDeviceExtendedDynamicState2FeaturesEXT Source #

type EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION = 1 Source #

pattern EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION :: Integral a => a Source #

type EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME = "VK_EXT_extended_dynamic_state2" Source #

pattern EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME :: (Eq a, IsString a) => a Source #

Name

VK_EXT_extended_dynamic_state2

Other Extension Metadata

Description

New Commands

New Structures

New Enum Constants

Promotion to Vulkan 1.3

Version History

See Also

Document Notes

Documentation

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

Conditional Rendering

See Also

Description

Valid Usage

Valid Usage (Implicit)

Host Synchronization

Command Properties

Conditional Rendering

See Also

Members

Description

Valid Usage (Implicit)

See Also

Instances