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 Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2

Contact

• Vikram Kushwaha https://github.com/KhronosGroup/Vulkan-Docs/issues/new?title=VK_EXT_extended_dynamic_state2:%20&body=@vkushwaha-nv%20

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

• 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

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 number of control points per patch.

-> io ()

vkCmdSetPatchControlPointsEXT - Specify the number of control points per patch

Description

This command sets the state for a given draw when the graphics pipeline is created with DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates.

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

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

CommandBuffer

cmdSetRasterizerDiscardEnableEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> ("rasterizerDiscardEnable" ::: Bool)

rasterizerDiscardEnable controls whether primitives are discarded immediately before the rasterization stage.

-> io ()

vkCmdSetRasterizerDiscardEnableEXT - Control whether primitives are discarded before the rasterization stage for a command buffer

Description

This command sets the state for a given draw when the graphics pipeline is created with DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates.

Valid Usage

• The extendedDynamicState2 feature must be enabled

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

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

Bool32, CommandBuffer

cmdSetDepthBiasEnableEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> ("depthBiasEnable" ::: Bool)

depthBiasEnable controls whether to bias fragment depth values.

-> io ()

vkCmdSetDepthBiasEnableEXT - Controls whether to bias fragment depth values for a command buffer

Description

This command sets the state for a given draw when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_BIAS_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates.

Valid Usage

• The extendedDynamicState2 feature must be enabled

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

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

Bool32, 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

Description

This command sets the state for a given draw when the graphics pipeline is created with DYNAMIC_STATE_LOGIC_OP_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates.

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

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

CommandBuffer, LogicOp

cmdSetPrimitiveRestartEnableEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

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

-> ("primitiveRestartEnable" ::: Bool)

primitiveRestartEnable controls whether a special vertex index value is treated as restarting the assembly of primitives. It behaves in the same way as PipelineInputAssemblyStateCreateInfo::primitiveRestartEnable

-> io ()

vkCmdSetPrimitiveRestartEnableEXT - Control whether a special vertex index value is treated as restarting the assembly of primitives

Description

This command sets the state for a given draw when the graphics pipeline is created with DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates.

Valid Usage

• The extendedDynamicState2 feature must be enabled

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

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

Bool32, CommandBuffer

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

Bool32, StructureType

Constructors

PhysicalDeviceExtendedDynamicState2FeaturesEXT

Fields

• extendedDynamicState2 :: Bool

  extendedDynamicState2 indicates that the implementation supports the following dynamic states:

  • DYNAMIC_STATE_DEPTH_BIAS_ENABLE_EXT
  • DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT
  • DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE_EXT
• 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

Eq PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

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

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

Show PhysicalDeviceExtendedDynamicState2FeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state2

Methods

showsPrec :: Int -> PhysicalDeviceExtendedDynamicState2FeaturesEXT -> ShowS

show :: PhysicalDeviceExtendedDynamicState2FeaturesEXT -> String

showList :: [PhysicalDeviceExtendedDynamicState2FeaturesEXT] -> ShowS

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

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