vkCmdSetCullMode - Set cull mode dynamically for a command buffer

Description

This command sets the cull mode for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_CULL_MODE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineRasterizationStateCreateInfo::cullMode value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• cullMode must be a valid combination of CullModeFlagBits values
• 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

'

Conditional Rendering

vkCmdSetCullMode is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, CullModeFlags

vkCmdSetFrontFace - Set front face orientation dynamically for a command buffer

Description

This command sets the front face orientation for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_FRONT_FACE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineRasterizationStateCreateInfo::frontFace value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• frontFace must be a valid FrontFace 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

'

Conditional Rendering

vkCmdSetFrontFace is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, FrontFace

vkCmdSetPrimitiveTopology - Set primitive topology state dynamically for a command buffer

Description

This command sets the primitive topology for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_PRIMITIVE_TOPOLOGY set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineInputAssemblyStateCreateInfo::topology value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• primitiveTopology must be a valid PrimitiveTopology 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

'

Conditional Rendering

vkCmdSetPrimitiveTopology is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, PrimitiveTopology

vkCmdSetViewportWithCount - Set the viewport count and viewports dynamically for a command buffer

Description

This command sets the viewport count and viewports state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_VIEWPORT_WITH_COUNT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the corresponding PipelineViewportStateCreateInfo::viewportCount and pViewports values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

• viewportCount must be between 1 and PhysicalDeviceLimits::maxViewports, inclusive
• If the multiViewport feature is not enabled, viewportCount must be 1
• commandBuffer must not have CommandBufferInheritanceViewportScissorInfoNV::viewportScissor2D enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pViewports must be a valid pointer to an array of viewportCount valid Viewport structures
• 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
• viewportCount must be greater than 0

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

'

Conditional Rendering

vkCmdSetViewportWithCount is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, Viewport

vkCmdSetScissorWithCount - Set the scissor count and scissor rectangular bounds dynamically for a command buffer

Description

This command sets the scissor count and scissor rectangular bounds state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_SCISSOR_WITH_COUNT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the corresponding PipelineViewportStateCreateInfo::scissorCount and pScissors values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

• scissorCount must be between 1 and PhysicalDeviceLimits::maxViewports, inclusive
• If the multiViewport feature is not enabled, scissorCount must be 1
• The x and y members of offset member of any element of pScissors must be greater than or equal to 0
• Evaluation of (offset.x + extent.width) must not cause a signed integer addition overflow for any element of pScissors
• Evaluation of (offset.y + extent.height) must not cause a signed integer addition overflow for any element of pScissors
• commandBuffer must not have CommandBufferInheritanceViewportScissorInfoNV::viewportScissor2D enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pScissors must be a valid pointer to an array of scissorCount Rect2D structures
• 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
• scissorCount must be greater than 0

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

'

Conditional Rendering

vkCmdSetScissorWithCount is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, Rect2D

vkCmdBindVertexBuffers2 - Bind vertex buffers to a command buffer and dynamically set strides

Description

The values taken from elements i of pBuffers and pOffsets replace the current state for the vertex input binding firstBinding + i, for i in [0, bindingCount). The vertex input binding is updated to start at the offset indicated by pOffsets[i] from the start of the buffer pBuffers[i]. If pSizes is not NULL then pSizes[i] specifies the bound size of the vertex buffer starting from the corresponding elements of pBuffers[i] plus pOffsets[i]. If pSizes[i] is WHOLE_SIZE then the bound size is from pBuffers[i] plus pOffsets[i] to the end of the buffer pBuffers[i]. All vertex input attributes that use each of these bindings will use these updated addresses in their address calculations for subsequent drawing commands. If the nullDescriptor feature is enabled, elements of pBuffers can be NULL_HANDLE, and can be used by the vertex shader. If a vertex input attribute is bound to a vertex input binding that is NULL_HANDLE, the values taken from memory are considered to be zero, and missing G, B, or A components are filled with (0,0,1).

This command also dynamically sets the byte strides between consecutive elements within buffer pBuffers[i] to the corresponding pStrides[i] value when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, strides are specified by the VertexInputBindingDescription::stride values used to create the currently active pipeline.

If drawing using shader objects or if the bound pipeline state object was also created with the DYNAMIC_STATE_VERTEX_INPUT_EXT dynamic state enabled then cmdSetVertexInputEXT can be used instead of cmdBindVertexBuffers2 to set the stride.

Unlike the static state to set the same, pStrides must be between 0 and the maximum extent of the attributes in the binding. cmdSetVertexInputEXT does not have this restriction so can be used if other stride values are desired.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

• firstBinding must be less than PhysicalDeviceLimits::maxVertexInputBindings
• The sum of firstBinding and bindingCount must be less than or equal to PhysicalDeviceLimits::maxVertexInputBindings
• If pSizes is not NULL, all elements of pOffsets must be less than the size of the corresponding element in pBuffers
• If pSizes is not NULL, all elements of pOffsets plus pSizes , where pSizes is not WHOLE_SIZE, must be less than or equal to the size of the corresponding element in pBuffers
• All elements of pBuffers must have been created with the BUFFER_USAGE_VERTEX_BUFFER_BIT usage flag set
• Each element of pBuffers that is non-sparse must be bound completely and contiguously to a single DeviceMemory object
• If the nullDescriptor feature is not enabled, all elements of pBuffers must not be NULL_HANDLE
• If an element of pBuffers is NULL_HANDLE, then the corresponding element of pOffsets must be zero
• If pStrides is not NULL each element of pStrides must be less than or equal to PhysicalDeviceLimits::maxVertexInputBindingStride
• If pStrides is not NULL each element of pStrides must be either 0 or greater than or equal to the maximum extent of all vertex input attributes fetched from the corresponding binding, where the extent is calculated as the VertexInputAttributeDescription::offset plus VertexInputAttributeDescription::format size

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pBuffers must be a valid pointer to an array of bindingCount valid or NULL_HANDLE Buffer handles
• pOffsets must be a valid pointer to an array of bindingCount DeviceSize values
• If pSizes is not NULL, pSizes must be a valid pointer to an array of bindingCount DeviceSize values
• If pStrides is not NULL, pStrides must be a valid pointer to an array of bindingCount DeviceSize values
• 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
• If any of pSizes, or pStrides are not NULL, bindingCount must be greater than 0
• Both of commandBuffer, and the elements of pBuffers that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the same Device

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

'

Conditional Rendering

vkCmdBindVertexBuffers2 is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, Buffer, CommandBuffer, DeviceSize

vkCmdSetDepthTestEnable - Set depth test enable dynamically for a command buffer

Description

This command sets the depth test enable for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_TEST_ENABLE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineDepthStencilStateCreateInfo::depthTestEnable value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

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

'

Conditional Rendering

vkCmdSetDepthTestEnable is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, Bool32, CommandBuffer

vkCmdSetDepthWriteEnable - Set depth write enable dynamically for a command buffer

Description

This command sets the depth write enable for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_WRITE_ENABLE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineDepthStencilStateCreateInfo::depthWriteEnable value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

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

'

Conditional Rendering

vkCmdSetDepthWriteEnable is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, Bool32, CommandBuffer

vkCmdSetDepthCompareOp - Set depth comparison operator dynamically for a command buffer

Description

This command sets the depth comparison operator for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_COMPARE_OP set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineDepthStencilStateCreateInfo::depthCompareOp value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• depthCompareOp must be a valid CompareOp 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

'

Conditional Rendering

vkCmdSetDepthCompareOp is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, CompareOp

vkCmdSetDepthBoundsTestEnable - Set depth bounds test enable dynamically for a command buffer

Description

This command sets the depth bounds enable for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineDepthStencilStateCreateInfo::depthBoundsTestEnable value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

• If the depthBounds feature is not enabled, depthBoundsTestEnable must be FALSE

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

'

Conditional Rendering

vkCmdSetDepthBoundsTestEnable is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, Bool32, CommandBuffer

vkCmdSetStencilTestEnable - Set stencil test enable dynamically for a command buffer

Description

This command sets the stencil test enable for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_STENCIL_TEST_ENABLE set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineDepthStencilStateCreateInfo::stencilTestEnable value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

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

'

Conditional Rendering

vkCmdSetStencilTestEnable is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, Bool32, CommandBuffer

vkCmdSetStencilOp - Set stencil operation dynamically for a command buffer

Description

This command sets the stencil operation for subsequent drawing commands when when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_STENCIL_OP set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the corresponding PipelineDepthStencilStateCreateInfo::failOp, passOp, depthFailOp, and compareOp values used to create the currently active pipeline, for both front and back faces.

Valid Usage

• At least one of the following must be true:

  • the extendedDynamicState feature is enabled
  • the shaderObject feature is enabled
  • the value of ApplicationInfo::apiVersion used to create the Instance parent of commandBuffer is greater than or equal to Version 1.3

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• faceMask must be a valid combination of StencilFaceFlagBits values
• faceMask must not be 0
• failOp must be a valid StencilOp value
• passOp must be a valid StencilOp value
• depthFailOp must be a valid StencilOp value
• compareOp must be a valid CompareOp 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

'

Conditional Rendering

vkCmdSetStencilOp is not affected by conditional rendering

See Also

VK_EXT_extended_dynamic_state, VK_EXT_shader_object, VK_VERSION_1_3, CommandBuffer, CompareOp, StencilFaceFlags, StencilOp

VkDynamicState - Indicate which dynamic state is taken from dynamic state commands

Description

• DYNAMIC_STATE_VIEWPORT specifies that the pViewports state in PipelineViewportStateCreateInfo will be ignored and must be set dynamically with cmdSetViewport before any drawing commands. The number of viewports used by a pipeline is still specified by the viewportCount member of PipelineViewportStateCreateInfo.

• DYNAMIC_STATE_SCISSOR specifies that the pScissors state in PipelineViewportStateCreateInfo will be ignored and must be set dynamically with cmdSetScissor before any drawing commands. The number of scissor rectangles used by a pipeline is still specified by the scissorCount member of PipelineViewportStateCreateInfo.
• DYNAMIC_STATE_LINE_WIDTH specifies that the lineWidth state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetLineWidth before any drawing commands that generate line primitives for the rasterizer.
• DYNAMIC_STATE_DEPTH_BIAS specifies that any instance of DepthBiasRepresentationInfoEXT included in the pNext chain of PipelineRasterizationStateCreateInfo as well as the depthBiasConstantFactor, depthBiasClamp and depthBiasSlopeFactor states in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBias or cmdSetDepthBias2EXT before any draws are performed with depth bias enabled.
• DYNAMIC_STATE_BLEND_CONSTANTS specifies that the blendConstants state in PipelineColorBlendStateCreateInfo will be ignored and must be set dynamically with cmdSetBlendConstants before any draws are performed with a pipeline state with PipelineColorBlendAttachmentState member blendEnable set to TRUE and any of the blend functions using a constant blend color.
• DYNAMIC_STATE_DEPTH_BOUNDS specifies that the minDepthBounds and maxDepthBounds states of PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBounds before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo member depthBoundsTestEnable set to TRUE.
• DYNAMIC_STATE_STENCIL_COMPARE_MASK specifies that the compareMask state in PipelineDepthStencilStateCreateInfo for both front and back will be ignored and must be set dynamically with cmdSetStencilCompareMask before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo member stencilTestEnable set to TRUE
• DYNAMIC_STATE_STENCIL_WRITE_MASK specifies that the writeMask state in PipelineDepthStencilStateCreateInfo for both front and back will be ignored and must be set dynamically with cmdSetStencilWriteMask before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo member stencilTestEnable set to TRUE
• DYNAMIC_STATE_STENCIL_REFERENCE specifies that the reference state in PipelineDepthStencilStateCreateInfo for both front and back will be ignored and must be set dynamically with cmdSetStencilReference before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo member stencilTestEnable set to TRUE
• DYNAMIC_STATE_VIEWPORT_W_SCALING_NV specifies that the pViewportWScalings state in PipelineViewportWScalingStateCreateInfoNV will be ignored and must be set dynamically with cmdSetViewportWScalingNV before any draws are performed with a pipeline state with PipelineViewportWScalingStateCreateInfoNV member viewportScalingEnable set to TRUE
• DYNAMIC_STATE_DISCARD_RECTANGLE_EXT specifies that the pDiscardRectangles state in PipelineDiscardRectangleStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetDiscardRectangleEXT before any draw or clear commands.
• DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT specifies that the presence of the PipelineDiscardRectangleStateCreateInfoEXT structure in the GraphicsPipelineCreateInfo chain with a discardRectangleCount greater than zero does not implicitly enable discard rectangles and they must be enabled dynamically with cmdSetDiscardRectangleEnableEXT before any draw commands. This is available on implementations that support at least specVersion 2 of the VK_EXT_discard_rectangles extension.
• DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT specifies that the discardRectangleMode state in PipelineDiscardRectangleStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetDiscardRectangleModeEXT before any draw commands. This is available on implementations that support at least specVersion 2 of the VK_EXT_discard_rectangles extension.
• DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT specifies that the sampleLocationsInfo state in PipelineSampleLocationsStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetSampleLocationsEXT before any draw or clear commands. Enabling custom sample locations is still indicated by the sampleLocationsEnable member of PipelineSampleLocationsStateCreateInfoEXT.
• DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV specifies that the pExclusiveScissors state in PipelineViewportExclusiveScissorStateCreateInfoNV will be ignored and must be set dynamically with cmdSetExclusiveScissorNV before any drawing commands.
• DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV specifies that the exclusive scissors must be explicitly enabled with cmdSetExclusiveScissorEnableNV and the exclusiveScissorCount value in PipelineViewportExclusiveScissorStateCreateInfoNV will not implicitly enable them. This is available on implementations that support at least specVersion 2 of the VK_NV_scissor_exclusive extension.
• DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV specifies that the pShadingRatePalettes state in PipelineViewportShadingRateImageStateCreateInfoNV will be ignored and must be set dynamically with cmdSetViewportShadingRatePaletteNV before any drawing commands.
• DYNAMIC_STATE_VIEWPORT_COARSE_SAMPLE_ORDER_NV specifies that the coarse sample order state in PipelineViewportCoarseSampleOrderStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoarseSampleOrderNV before any drawing commands.
• DYNAMIC_STATE_LINE_STIPPLE specifies that the lineStippleFactor and lineStipplePattern state in PipelineRasterizationLineStateCreateInfo will be ignored and must be set dynamically with cmdSetLineStipple before any draws are performed with a pipeline state with PipelineRasterizationLineStateCreateInfo member stippledLineEnable set to TRUE.
• DYNAMIC_STATE_CULL_MODE specifies that the cullMode state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetCullMode before any drawing commands.
• DYNAMIC_STATE_FRONT_FACE specifies that the frontFace state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetFrontFace before any drawing commands.
• DYNAMIC_STATE_PRIMITIVE_TOPOLOGY specifies that the topology state in PipelineInputAssemblyStateCreateInfo only specifies the topology class, and the specific topology order and adjacency must be set dynamically with cmdSetPrimitiveTopology before any drawing commands.
• DYNAMIC_STATE_VIEWPORT_WITH_COUNT specifies that the viewportCount and pViewports state in PipelineViewportStateCreateInfo will be ignored and must be set dynamically with cmdSetViewportWithCount before any draw call.
• DYNAMIC_STATE_SCISSOR_WITH_COUNT specifies that the scissorCount and pScissors state in PipelineViewportStateCreateInfo will be ignored and must be set dynamically with cmdSetScissorWithCount before any draw call.
• DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE specifies that the stride state in VertexInputBindingDescription will be ignored and must be set dynamically with cmdBindVertexBuffers2 before any draw call.
• DYNAMIC_STATE_DEPTH_TEST_ENABLE specifies that the depthTestEnable state in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthTestEnable before any draw call.
• DYNAMIC_STATE_DEPTH_WRITE_ENABLE specifies that the depthWriteEnable state in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthWriteEnable before any draw call.
• DYNAMIC_STATE_DEPTH_COMPARE_OP specifies that the depthCompareOp state in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthCompareOp before any draw call.
• DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE specifies that the depthBoundsTestEnable state in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBoundsTestEnable before any draw call.
• DYNAMIC_STATE_STENCIL_TEST_ENABLE specifies that the stencilTestEnable state in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetStencilTestEnable before any draw call.
• DYNAMIC_STATE_STENCIL_OP specifies that the failOp, passOp, depthFailOp, and compareOp states in PipelineDepthStencilStateCreateInfo for both front and back will be ignored and must be set dynamically with cmdSetStencilOp before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo member stencilTestEnable set to TRUE
• DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT specifies that the patchControlPoints state in PipelineTessellationStateCreateInfo will be ignored and must be set dynamically with cmdSetPatchControlPointsEXT before any drawing commands.
• DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE specifies that the rasterizerDiscardEnable state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetRasterizerDiscardEnable before any drawing commands.
• DYNAMIC_STATE_DEPTH_BIAS_ENABLE specifies that the depthBiasEnable state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBiasEnable before any drawing commands.
• DYNAMIC_STATE_LOGIC_OP_EXT specifies that the logicOp state in PipelineColorBlendStateCreateInfo will be ignored and must be set dynamically with cmdSetLogicOpEXT before any drawing commands.
• DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE specifies that the primitiveRestartEnable state in PipelineInputAssemblyStateCreateInfo will be ignored and must be set dynamically with cmdSetPrimitiveRestartEnable before any drawing commands.
• DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR specifies that state in PipelineFragmentShadingRateStateCreateInfoKHR and PipelineFragmentShadingRateEnumStateCreateInfoNV will be ignored and must be set dynamically with cmdSetFragmentShadingRateKHR or cmdSetFragmentShadingRateEnumNV before any drawing commands.
• DYNAMIC_STATE_RAY_TRACING_PIPELINE_STACK_SIZE_KHR specifies that the default stack size computation for the pipeline will be ignored and must be set dynamically with cmdSetRayTracingPipelineStackSizeKHR before any ray tracing calls are performed.
• DYNAMIC_STATE_VERTEX_INPUT_EXT specifies that the pVertexInputState state will be ignored and must be set dynamically with cmdSetVertexInputEXT before any drawing commands
• DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT specifies that the pColorWriteEnables state in PipelineColorWriteCreateInfoEXT will be ignored and must be set dynamically with cmdSetColorWriteEnableEXT before any draw call.
• DYNAMIC_STATE_TESSELLATION_DOMAIN_ORIGIN_EXT specifies that the domainOrigin state in PipelineTessellationDomainOriginStateCreateInfo will be ignored and must be set dynamically with cmdSetTessellationDomainOriginEXT before any draw call.
• DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXT specifies that the depthClampEnable state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthClampEnableEXT before any draw call.
• DYNAMIC_STATE_POLYGON_MODE_EXT specifies that the polygonMode state in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetPolygonModeEXT before any draw call.
• DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT specifies that the rasterizationSamples state in PipelineMultisampleStateCreateInfo will be ignored and must be set dynamically with cmdSetRasterizationSamplesEXT before any draw call.
• DYNAMIC_STATE_SAMPLE_MASK_EXT specifies that the pSampleMask state in PipelineMultisampleStateCreateInfo will be ignored and must be set dynamically with cmdSetSampleMaskEXT before any draw call.
• DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT specifies that the alphaToCoverageEnable state in PipelineMultisampleStateCreateInfo will be ignored and must be set dynamically with cmdSetAlphaToCoverageEnableEXT before any draw call.
• DYNAMIC_STATE_ALPHA_TO_ONE_ENABLE_EXT specifies that the alphaToOneEnable state in PipelineMultisampleStateCreateInfo will be ignored and must be set dynamically with cmdSetAlphaToOneEnableEXT before any draw call.
• DYNAMIC_STATE_LOGIC_OP_ENABLE_EXT specifies that the logicOpEnable state in PipelineColorBlendStateCreateInfo will be ignored and must be set dynamically with cmdSetLogicOpEnableEXT before any draw call.
• DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT specifies that the blendEnable state in PipelineColorBlendAttachmentState will be ignored and must be set dynamically with cmdSetColorBlendEnableEXT before any draw call.
• DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT specifies that the srcColorBlendFactor, dstColorBlendFactor, colorBlendOp, srcAlphaBlendFactor, dstAlphaBlendFactor, and alphaBlendOp states in PipelineColorBlendAttachmentState will be ignored and must be set dynamically with cmdSetColorBlendEquationEXT before any draw call.
• DYNAMIC_STATE_COLOR_WRITE_MASK_EXT specifies that the colorWriteMask state in PipelineColorBlendAttachmentState will be ignored and must be set dynamically with cmdSetColorWriteMaskEXT before any draw call.
• DYNAMIC_STATE_RASTERIZATION_STREAM_EXT specifies that the rasterizationStream state in PipelineRasterizationStateStreamCreateInfoEXT will be ignored and must be set dynamically with cmdSetRasterizationStreamEXT before any draw call.
• DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT specifies that the conservativeRasterizationMode state in PipelineRasterizationConservativeStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetConservativeRasterizationModeEXT before any draw call.
• DYNAMIC_STATE_EXTRA_PRIMITIVE_OVERESTIMATION_SIZE_EXT specifies that the extraPrimitiveOverestimationSize state in PipelineRasterizationConservativeStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetExtraPrimitiveOverestimationSizeEXT before any draw call.
• DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT specifies that the depthClipEnable state in PipelineRasterizationDepthClipStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetDepthClipEnableEXT before any draw call.
• DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT specifies that the sampleLocationsEnable state in PipelineSampleLocationsStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetSampleLocationsEnableEXT before any draw call.
• DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT specifies that the colorBlendOp state in PipelineColorBlendAttachmentState, and srcPremultiplied, dstPremultiplied, and blendOverlap states in PipelineColorBlendAdvancedStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetColorBlendAdvancedEXT before any draw call.
• DYNAMIC_STATE_PROVOKING_VERTEX_MODE_EXT specifies that the provokingVertexMode state in PipelineRasterizationProvokingVertexStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetProvokingVertexModeEXT before any draw call.
• DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT specifies that the lineRasterizationMode state in PipelineRasterizationLineStateCreateInfo will be ignored and must be set dynamically with cmdSetLineRasterizationModeEXT before any draw call.
• DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT specifies that the stippledLineEnable state in PipelineRasterizationLineStateCreateInfo will be ignored and must be set dynamically with cmdSetLineStippleEnableEXT before any draw call.
• DYNAMIC_STATE_DEPTH_CLIP_NEGATIVE_ONE_TO_ONE_EXT specifies that the negativeOneToOne state in PipelineViewportDepthClipControlCreateInfoEXT will be ignored and must be set dynamically with cmdSetDepthClipNegativeOneToOneEXT before any draw call.
• DYNAMIC_STATE_DEPTH_CLAMP_RANGE_EXT specifies that the depthClampMode and pDepthClampRange state in PipelineViewportDepthClampControlCreateInfoEXT will be ignored and must be set dynamically with cmdSetDepthClampRangeEXT before any draw call.
• DYNAMIC_STATE_VIEWPORT_W_SCALING_ENABLE_NV specifies that the viewportWScalingEnable state in PipelineViewportWScalingStateCreateInfoNV will be ignored and must be set dynamically with cmdSetViewportWScalingEnableNV before any draw call.
• DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV specifies that the viewportCount, and pViewportSwizzles states in PipelineViewportSwizzleStateCreateInfoNV will be ignored and must be set dynamically with cmdSetViewportSwizzleNV before any draw call.
• DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV specifies that the coverageToColorEnable state in PipelineCoverageToColorStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageToColorEnableNV before any draw call.
• DYNAMIC_STATE_COVERAGE_TO_COLOR_LOCATION_NV specifies that the coverageToColorLocation state in PipelineCoverageToColorStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageToColorLocationNV before any draw call.
• DYNAMIC_STATE_COVERAGE_MODULATION_MODE_NV specifies that the coverageModulationMode state in PipelineCoverageModulationStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageModulationModeNV before any draw call.
• DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV specifies that the coverageModulationTableEnable state in PipelineCoverageModulationStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageModulationTableEnableNV before any draw call.
• DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NV specifies that the coverageModulationTableCount, and pCoverageModulationTable states in PipelineCoverageModulationStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageModulationTableNV before any draw call.
• DYNAMIC_STATE_SHADING_RATE_IMAGE_ENABLE_NV specifies that the shadingRateImageEnable state in PipelineViewportShadingRateImageStateCreateInfoNV will be ignored and must be set dynamically with cmdSetShadingRateImageEnableNV before any draw call.
• DYNAMIC_STATE_REPRESENTATIVE_FRAGMENT_TEST_ENABLE_NV specifies that the representativeFragmentTestEnable state in PipelineRepresentativeFragmentTestStateCreateInfoNV will be ignored and must be set dynamically with cmdSetRepresentativeFragmentTestEnableNV before any draw call.
• DYNAMIC_STATE_COVERAGE_REDUCTION_MODE_NV specifies that the coverageReductionMode state in PipelineCoverageReductionStateCreateInfoNV will be ignored and must be set dynamically with cmdSetCoverageReductionModeNV before any draw call.
• DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT specifies that the PIPELINE_CREATE_COLOR_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT and PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT flags will be ignored and must be set dynamically with cmdSetAttachmentFeedbackLoopEnableEXT before any draw call.

See Also

VK_VERSION_1_0, PipelineDynamicStateCreateInfo