Vulkan.Extensions.VK_EXT_extended_dynamic_state

Name

VK_EXT_extended_dynamic_state - device extension

VK_EXT_extended_dynamic_state

Name String

VK_EXT_extended_dynamic_state

Extension Type

Device extension

Registered Extension Number

268

Revision

1

Ratification Status

Not ratified

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2 or Version 1.1

Deprecation State

• Promoted to Vulkan 1.3

Contact

• Piers Daniell @pdaniell-nv%0A*Here describe the issue or question you have about the VK_EXT_extended_dynamic_state extension*

Other Extension Metadata

Last Modified Date

2019-12-09

Interactions and External Dependencies

• Promoted to Vulkan 1.3 Core

IP Status

No known IP claims.

Contributors

• Dan Ginsburg, Valve Corporation
• Graeme Leese, Broadcom
• Hans-Kristian Arntzen, Valve Corporation
• Jan-Harald Fredriksen, Arm Limited
• Faith Ekstrand, Intel
• Jeff Bolz, NVIDIA
• Jesse Hall, Google
• Philip Rebohle, Valve Corporation
• Stuart Smith, Imagination Technologies
• Tobias Hector, AMD

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

• cmdBindVertexBuffers2EXT

• cmdSetCullModeEXT
• cmdSetDepthBoundsTestEnableEXT
• cmdSetDepthCompareOpEXT
• cmdSetDepthTestEnableEXT
• cmdSetDepthWriteEnableEXT
• cmdSetFrontFaceEXT
• cmdSetPrimitiveTopologyEXT
• cmdSetScissorWithCountEXT
• cmdSetStencilOpEXT
• cmdSetStencilTestEnableEXT
• cmdSetViewportWithCountEXT

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceExtendedDynamicStateFeaturesEXT

New Enum Constants

• EXT_EXTENDED_DYNAMIC_STATE_EXTENSION_NAME

• EXT_EXTENDED_DYNAMIC_STATE_SPEC_VERSION

• Extending DynamicState:

  • DYNAMIC_STATE_CULL_MODE_EXT
  • DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE_EXT
  • DYNAMIC_STATE_DEPTH_COMPARE_OP_EXT
  • DYNAMIC_STATE_DEPTH_TEST_ENABLE_EXT
  • DYNAMIC_STATE_DEPTH_WRITE_ENABLE_EXT
  • DYNAMIC_STATE_FRONT_FACE_EXT
  • DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT
  • DYNAMIC_STATE_SCISSOR_WITH_COUNT_EXT
  • DYNAMIC_STATE_STENCIL_OP_EXT
  • DYNAMIC_STATE_STENCIL_TEST_ENABLE_EXT
  • DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT
  • DYNAMIC_STATE_VIEWPORT_WITH_COUNT_EXT

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_FEATURES_EXT

Promotion to Vulkan 1.3

This extension has been partially promoted. All dynamic state enumerants and entry points in this extension are included in core Vulkan 1.3, with the EXT suffix omitted. The feature structure is not promoted. Extension interfaces that were promoted remain available as aliases of the core functionality.

Issues

1) Why are the values of pStrides in cmdBindVertexBuffers2 limited to be between 0 and the maximum extent of the binding, when this restriction is not present for the same static state?

Implementing these edge cases adds overhead to some implementations that would require significant cost when calling this function, and the intention is that this state should be more or less free to change.

VK_EXT_vertex_input_dynamic_state allows the stride to be changed freely when supported via cmdSetVertexInputEXT[].

Version History

• Revision 1, 2019-12-09 (Piers Daniell)

  • Internal revisions

See Also

PhysicalDeviceExtendedDynamicStateFeaturesEXT, cmdBindVertexBuffers2EXT, cmdSetCullModeEXT, cmdSetDepthBoundsTestEnableEXT, cmdSetDepthCompareOpEXT, cmdSetDepthTestEnableEXT, cmdSetDepthWriteEnableEXT, cmdSetFrontFaceEXT, cmdSetPrimitiveTopologyEXT, cmdSetScissorWithCountEXT, cmdSetStencilOpEXT, cmdSetStencilTestEnableEXT, cmdSetViewportWithCountEXT

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

pattern DYNAMIC_STATE_CULL_MODE_EXT :: DynamicState

pattern DYNAMIC_STATE_FRONT_FACE_EXT :: DynamicState

pattern DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT :: DynamicState

pattern DYNAMIC_STATE_VIEWPORT_WITH_COUNT_EXT :: DynamicState

pattern DYNAMIC_STATE_SCISSOR_WITH_COUNT_EXT :: DynamicState

pattern DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT :: DynamicState

pattern DYNAMIC_STATE_DEPTH_TEST_ENABLE_EXT :: DynamicState

pattern DYNAMIC_STATE_DEPTH_WRITE_ENABLE_EXT :: DynamicState

pattern DYNAMIC_STATE_DEPTH_COMPARE_OP_EXT :: DynamicState

pattern DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE_EXT :: DynamicState

pattern DYNAMIC_STATE_STENCIL_TEST_ENABLE_EXT :: DynamicState

pattern DYNAMIC_STATE_STENCIL_OP_EXT :: DynamicState

cmdSetCullModeEXT :: MonadIO io => CommandBuffer -> CullModeFlags -> io ()

cmdSetFrontFaceEXT :: MonadIO io => CommandBuffer -> FrontFace -> io ()

cmdSetPrimitiveTopologyEXT :: MonadIO io => CommandBuffer -> PrimitiveTopology -> io ()

cmdSetViewportWithCountEXT :: MonadIO io => CommandBuffer -> ("viewports" ::: Vector Viewport) -> io ()

cmdSetScissorWithCountEXT :: MonadIO io => CommandBuffer -> ("scissors" ::: Vector Rect2D) -> io ()

cmdBindVertexBuffers2EXT :: MonadIO io => CommandBuffer -> ("firstBinding" ::: Word32) -> ("buffers" ::: Vector Buffer) -> ("offsets" ::: Vector DeviceSize) -> ("sizes" ::: Vector DeviceSize) -> ("strides" ::: Vector DeviceSize) -> io ()

cmdSetDepthTestEnableEXT :: MonadIO io => CommandBuffer -> ("depthTestEnable" ::: Bool) -> io ()

cmdSetDepthWriteEnableEXT :: MonadIO io => CommandBuffer -> ("depthWriteEnable" ::: Bool) -> io ()

cmdSetDepthCompareOpEXT :: MonadIO io => CommandBuffer -> ("depthCompareOp" ::: CompareOp) -> io ()

cmdSetDepthBoundsTestEnableEXT :: MonadIO io => CommandBuffer -> ("depthBoundsTestEnable" ::: Bool) -> io ()

cmdSetStencilTestEnableEXT :: MonadIO io => CommandBuffer -> ("stencilTestEnable" ::: Bool) -> io ()

cmdSetStencilOpEXT :: MonadIO io => CommandBuffer -> ("faceMask" ::: StencilFaceFlags) -> ("failOp" ::: StencilOp) -> ("passOp" ::: StencilOp) -> ("depthFailOp" ::: StencilOp) -> CompareOp -> io ()

data PhysicalDeviceExtendedDynamicStateFeaturesEXT

VkPhysicalDeviceExtendedDynamicStateFeaturesEXT - Structure describing what extended dynamic state can be used

Members

This structure describes the following feature:

Description

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

Valid Usage (Implicit)

See Also

VK_EXT_extended_dynamic_state, Bool32, StructureType

Constructors

PhysicalDeviceExtendedDynamicStateFeaturesEXT

Fields

• extendedDynamicState :: Bool

  extendedDynamicState indicates that the implementation supports the following dynamic states:

  • DYNAMIC_STATE_CULL_MODE
  • DYNAMIC_STATE_FRONT_FACE
  • DYNAMIC_STATE_PRIMITIVE_TOPOLOGY
  • DYNAMIC_STATE_VIEWPORT_WITH_COUNT
  • DYNAMIC_STATE_SCISSOR_WITH_COUNT
  • DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE
  • DYNAMIC_STATE_DEPTH_TEST_ENABLE
  • DYNAMIC_STATE_DEPTH_WRITE_ENABLE
  • DYNAMIC_STATE_DEPTH_COMPARE_OP
  • DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE
  • DYNAMIC_STATE_STENCIL_TEST_ENABLE
  • DYNAMIC_STATE_STENCIL_OP

Instances

Storable PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

sizeOf :: PhysicalDeviceExtendedDynamicStateFeaturesEXT -> Int

alignment :: PhysicalDeviceExtendedDynamicStateFeaturesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceExtendedDynamicStateFeaturesEXT -> Int -> IO PhysicalDeviceExtendedDynamicStateFeaturesEXT

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

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

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

peek :: Ptr PhysicalDeviceExtendedDynamicStateFeaturesEXT -> IO PhysicalDeviceExtendedDynamicStateFeaturesEXT

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

Show PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

showsPrec :: Int -> PhysicalDeviceExtendedDynamicStateFeaturesEXT -> ShowS

show :: PhysicalDeviceExtendedDynamicStateFeaturesEXT -> String

showList :: [PhysicalDeviceExtendedDynamicStateFeaturesEXT] -> ShowS

Eq PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

(==) :: PhysicalDeviceExtendedDynamicStateFeaturesEXT -> PhysicalDeviceExtendedDynamicStateFeaturesEXT -> Bool

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

FromCStruct PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

peekCStruct :: Ptr PhysicalDeviceExtendedDynamicStateFeaturesEXT -> IO PhysicalDeviceExtendedDynamicStateFeaturesEXT

ToCStruct PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

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

pokeCStruct :: Ptr PhysicalDeviceExtendedDynamicStateFeaturesEXT -> PhysicalDeviceExtendedDynamicStateFeaturesEXT -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceExtendedDynamicStateFeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceExtendedDynamicStateFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_extended_dynamic_state

Methods

zero :: PhysicalDeviceExtendedDynamicStateFeaturesEXT

type EXT_EXTENDED_DYNAMIC_STATE_SPEC_VERSION = 1

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

type EXT_EXTENDED_DYNAMIC_STATE_EXTENSION_NAME = "VK_EXT_extended_dynamic_state"

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