Vulkan.Extensions.VK_EXT_extended_dynamic_state2

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

Extension and Version Dependencies

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

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

Interactions and External Dependencies

• Promoted to Vulkan 1.3 Core

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

• cmdSetLogicOpEXT
• cmdSetPatchControlPointsEXT
• cmdSetPrimitiveRestartEnableEXT
• cmdSetRasterizerDiscardEnableEXT

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceExtendedDynamicState2FeaturesEXT

New Enum Constants

• EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME

• EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION

• Extending DynamicState:

  • DYNAMIC_STATE_DEPTH_BIAS_ENABLE_EXT
  • DYNAMIC_STATE_LOGIC_OP_EXT
  • DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT
  • DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT
  • DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE_EXT

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_2_FEATURES_EXT

Promotion to Vulkan 1.3

This extension has been partially promoted. 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 entry points in this extension are included in core Vulkan 1.3, with the EXT suffix omitted. The enumerants and entry points 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

See Also

PhysicalDeviceExtendedDynamicState2FeaturesEXT, cmdSetDepthBiasEnableEXT, cmdSetLogicOpEXT, cmdSetPatchControlPointsEXT, cmdSetPrimitiveRestartEnableEXT, cmdSetRasterizerDiscardEnableEXT

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

cmdSetPatchControlPointsEXT

Arguments

:: forall io. 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 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

• The extendedDynamicState2PatchControlPoints feature must be 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 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_EXT_extended_dynamic_state2, CommandBuffer

cmdSetLogicOpEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> LogicOp

logicOp specifies the logical operation to apply for blend state.

-> io ()

vkCmdSetLogicOpEXT - Select which logical operation to apply for blend state dynamically for a command buffer

Description

This command sets the logical operation for blend state for subsequent drawing commands 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

• The extendedDynamicState2LogicOp feature must be 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 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_EXT_extended_dynamic_state2, CommandBuffer, LogicOp

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

VkPhysicalDeviceExtendedDynamicState2FeaturesEXT - Structure describing what extended dynamic state can be used

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

Valid Usage (Implicit)

See Also

VK_EXT_extended_dynamic_state2, Bool32, StructureType

Constructors

PhysicalDeviceExtendedDynamicState2FeaturesEXT

Fields

• extendedDynamicState2 :: Bool

  extendedDynamicState2 indicates that the implementation supports the following dynamic states:

  • DYNAMIC_STATE_DEPTH_BIAS_ENABLE
  • DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE
  • DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE
• 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

Storable PhysicalDeviceExtendedDynamicState2FeaturesEXT

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

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

showsPrec :: Int -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> ShowS

show :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> String

showList :: [PhysicalDeviceExtendedDynamicState2FeaturesEXT] -> ShowS

Eq PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

(==) :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> Bool

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

FromCStruct PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

peekCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO PhysicalDeviceExtendedDynamicState2FeaturesEXT

ToCStruct PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

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

pokeCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceExtendedDynamicState2FeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

zero :: PhysicalDeviceExtendedDynamicState2FeaturesEXT

type EXT_EXTENDED_DYNAMIC_STATE_2_SPEC_VERSION = 1

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

type EXT_EXTENDED_DYNAMIC_STATE_2_EXTENSION_NAME = "VK_EXT_extended_dynamic_state2"

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