vkCmdSetTessellationDomainOriginEXT - Specify the origin of the tessellation domain space dynamically for a command buffer

Description

This command sets the origin of the tessellation domain space for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_TESSELLATION_DOMAIN_ORIGIN_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineTessellationDomainOriginStateCreateInfo::domainOrigin value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3TessellationDomainOrigin feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• domainOrigin must be a valid TessellationDomainOrigin 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, TessellationDomainOrigin

vkCmdSetDepthClampEnableEXT - Specify dynamically whether depth clamping is enabled in the command buffer

Description

This command sets whether depth clamping is enabled or disabled for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineRasterizationStateCreateInfo::depthClampEnable value used to create the currently active pipeline.

If the depth clamping state is changed dynamically, and the pipeline was not created with DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT enabled, then depth clipping is enabled when depth clamping is disabled and vice versa.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3DepthClampEnable feature is enabled
  • The shaderObject feature is enabled

• If the depthClamp feature is not enabled, depthClampEnable 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 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetPolygonModeEXT - Specify polygon mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3PolygonMode feature is enabled
  • The shaderObject feature is enabled

• If the fillModeNonSolid feature is not enabled, polygonMode must be POLYGON_MODE_FILL or POLYGON_MODE_FILL_RECTANGLE_NV
• If the VK_NV_fill_rectangle extension is not enabled, polygonMode must not be POLYGON_MODE_FILL_RECTANGLE_NV

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• polygonMode must be a valid PolygonMode 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, PolygonMode

vkCmdSetRasterizationSamplesEXT - Specify the rasterization samples dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3RasterizationSamples feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• rasterizationSamples must be a valid SampleCountFlagBits 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, SampleCountFlagBits

vkCmdSetSampleMaskEXT - Specify the sample mask dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3SampleMask feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• samples must be a valid SampleCountFlagBits value
• pSampleMask must be a valid pointer to an array of \(\lceil{\mathit{samples} \over 32}\rceil\) SampleMask values
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, SampleCountFlagBits, SampleMask

vkCmdSetAlphaToCoverageEnableEXT - Specify the alpha to coverage enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3AlphaToCoverageEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetAlphaToOneEnableEXT - Specify the alpha to one enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3AlphaToOneEnable feature is enabled
  • The shaderObject feature is enabled

• If the alphaToOne feature is not enabled, alphaToOneEnable 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 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetLogicOpEnableEXT - Specify dynamically whether logical operations are enabled for a command buffer

Description

This command sets whether logical operations are enabled for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_LOGIC_OP_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendStateCreateInfo::logicOpEnable value used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3LogicOpEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetColorBlendEnableEXT - Specify the blendEnable for each attachment dynamically for a command buffer

Description

This command sets the color blending enable of the specified color attachments for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendAttachmentState::blendEnable values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ColorBlendEnable feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pColorBlendEnables must be a valid pointer to an array of attachmentCount Bool32 values
• 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
• attachmentCount 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetColorBlendEquationEXT - Specify the blend factors and operations dynamically for a command buffer

Description

This command sets the color blending factors and operations of the specified attachments for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendAttachmentState::srcColorBlendFactor, PipelineColorBlendAttachmentState::dstColorBlendFactor, PipelineColorBlendAttachmentState::colorBlendOp, PipelineColorBlendAttachmentState::srcAlphaBlendFactor, PipelineColorBlendAttachmentState::dstAlphaBlendFactor, and PipelineColorBlendAttachmentState::alphaBlendOp values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ColorBlendEquation feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pColorBlendEquations must be a valid pointer to an array of attachmentCount valid ColorBlendEquationEXT structures
• 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
• attachmentCount 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, ColorBlendEquationEXT, CommandBuffer

vkCmdSetColorWriteMaskEXT - Specify the color write masks for each attachment dynamically for a command buffer

Description

This command sets the color write masks of the specified attachments for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_COLOR_WRITE_MASK_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendAttachmentState::colorWriteMask values used to create the currently active pipeline.

Note

Formats with bits that are shared between components specified by ColorComponentFlagBits, such as FORMAT_E5B9G9R9_UFLOAT_PACK32, cannot have their channels individually masked by this functionality; either all components that share bits have to be enabled, or none of them.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ColorWriteMask feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pColorWriteMasks must be a valid pointer to an array of attachmentCount valid combinations of ColorComponentFlagBits values
• 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
• attachmentCount 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, ColorComponentFlags, CommandBuffer

vkCmdSetRasterizationStreamEXT - Specify the rasterization stream dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3RasterizationStream feature is enabled
  • The shaderObject feature is enabled

• The transformFeedback feature must be enabled
• rasterizationStream must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackStreams
• rasterizationStream must be zero if PhysicalDeviceTransformFeedbackPropertiesEXT::transformFeedbackRasterizationStreamSelect is 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 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer

vkCmdSetConservativeRasterizationModeEXT - Specify the conservative rasterization mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ConservativeRasterizationMode feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• conservativeRasterizationMode must be a valid ConservativeRasterizationModeEXT 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, ConservativeRasterizationModeEXT

vkCmdSetExtraPrimitiveOverestimationSizeEXT - Specify the conservative rasterization extra primitive overestimation size dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ExtraPrimitiveOverestimationSize feature is enabled
  • The shaderObject feature is enabled

• extraPrimitiveOverestimationSize must be in the range of 0.0 to PhysicalDeviceConservativeRasterizationPropertiesEXT::maxExtraPrimitiveOverestimationSize inclusive

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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer

vkCmdSetDepthClipEnableEXT - Specify dynamically whether depth clipping is enabled in the command buffer

Description

This command sets whether depth clipping is enabled or disabled for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineRasterizationDepthClipStateCreateInfoEXT::depthClipEnable value used to create the currently active pipeline, or is set to the inverse of PipelineRasterizationStateCreateInfo::depthClampEnable if PipelineRasterizationDepthClipStateCreateInfoEXT is not specified.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3DepthClipEnable feature is enabled
  • The shaderObject feature is enabled

• The depthClipEnable 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetSampleLocationsEnableEXT - Specify the samples locations enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3SampleLocationsEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetColorBlendAdvancedEXT - Specify the advanced color blend state dynamically for a command buffer

Description

This command sets the advanced blend operation parameters of the specified attachments for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineColorBlendAdvancedStateCreateInfoEXT::srcPremultiplied, PipelineColorBlendAdvancedStateCreateInfoEXT::dstPremultiplied, and PipelineColorBlendAdvancedStateCreateInfoEXT::blendOverlap values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ColorBlendAdvanced feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pColorBlendAdvanced must be a valid pointer to an array of attachmentCount valid ColorBlendAdvancedEXT structures
• 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
• attachmentCount 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, ColorBlendAdvancedEXT, CommandBuffer

vkCmdSetProvokingVertexModeEXT - Specify the provoking vertex mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ProvokingVertexMode feature is enabled
  • The shaderObject feature is enabled

• If provokingVertexMode is PROVOKING_VERTEX_MODE_LAST_VERTEX_EXT, then the provokingVertexLast feature must be enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• provokingVertexMode must be a valid ProvokingVertexModeEXT 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, ProvokingVertexModeEXT

vkCmdSetLineRasterizationModeEXT - Specify the line rasterization mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3LineRasterizationMode feature is enabled
  • The shaderObject feature is enabled

• If lineRasterizationMode is LINE_RASTERIZATION_MODE_RECTANGULAR_EXT, then the rectangularLines feature must be enabled
• If lineRasterizationMode is LINE_RASTERIZATION_MODE_BRESENHAM_EXT, then the bresenhamLines feature must be enabled
• If lineRasterizationMode is LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT, then the smoothLines feature must be enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• lineRasterizationMode must be a valid LineRasterizationModeEXT 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, CommandBuffer, LineRasterizationModeEXT

vkCmdSetLineStippleEnableEXT - Specify the line stipple enable dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3LineStippleEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetDepthClipNegativeOneToOneEXT - Specify the negative one to one depth clip mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3DepthClipNegativeOneToOne feature is enabled
  • The shaderObject feature is enabled

• The depthClipControl 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, Bool32, CommandBuffer

vkCmdSetViewportWScalingEnableNV - Specify the viewport W scaling enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ViewportWScalingEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_clip_space_w_scaling, Bool32, CommandBuffer

vkCmdSetViewportSwizzleNV - Specify the viewport swizzle state dynamically for a command buffer

Description

This command sets the viewport swizzle state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineViewportSwizzleStateCreateInfoNV::viewportCount, and PipelineViewportSwizzleStateCreateInfoNV::pViewportSwizzles values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ViewportSwizzle feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pViewportSwizzles must be a valid pointer to an array of viewportCount valid ViewportSwizzleNV structures
• 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_viewport_swizzle, CommandBuffer, ViewportSwizzleNV

vkCmdSetCoverageToColorEnableNV - Specify the coverage to color enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageToColorEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_fragment_coverage_to_color, Bool32, CommandBuffer

vkCmdSetCoverageToColorLocationNV - Specify the coverage to color location dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageToColorLocation feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_fragment_coverage_to_color, CommandBuffer

vkCmdSetCoverageModulationModeNV - Specify the coverage modulation mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageModulationMode feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• coverageModulationMode must be a valid CoverageModulationModeNV 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_framebuffer_mixed_samples, CommandBuffer, CoverageModulationModeNV

vkCmdSetCoverageModulationTableEnableNV - Specify the coverage modulation table enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageModulationTableEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_framebuffer_mixed_samples, Bool32, CommandBuffer

vkCmdSetCoverageModulationTableNV - Specify the coverage modulation table dynamically for a command buffer

Description

This command sets the table of modulation factors for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NV set in PipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the PipelineCoverageModulationStateCreateInfoNV::coverageModulationTableCount, and PipelineCoverageModulationStateCreateInfoNV::pCoverageModulationTable values used to create the currently active pipeline.

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageModulationTable feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pCoverageModulationTable must be a valid pointer to an array of coverageModulationTableCount float values
• 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
• coverageModulationTableCount 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_framebuffer_mixed_samples, CommandBuffer

vkCmdSetShadingRateImageEnableNV - Specify the shading rate image enable state dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3ShadingRateImageEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_shading_rate_image, Bool32, CommandBuffer

vkCmdSetCoverageReductionModeNV - Specify the coverage reduction mode dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3CoverageReductionMode feature is enabled
  • The shaderObject feature is enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• coverageReductionMode must be a valid CoverageReductionModeNV 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_coverage_reduction_mode, CommandBuffer, CoverageReductionModeNV

vkCmdSetRepresentativeFragmentTestEnableNV - Specify the representative fragment test enable dynamically for a command buffer

Description

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

Valid Usage

• At least one of the following must be true:

  • The extendedDynamicState3RepresentativeFragmentTestEnable feature is enabled
  • The shaderObject feature is 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
• 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

'

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, VK_NV_representative_fragment_test, Bool32, CommandBuffer

VkPhysicalDeviceExtendedDynamicState3FeaturesEXT - Structure describing what extended dynamic state is supported by the implementation

Members

This structure describes the following features:

Description

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

Valid Usage (Implicit)

See Also

VK_EXT_extended_dynamic_state3, Bool32, StructureType

VkPhysicalDeviceExtendedDynamicState3PropertiesEXT - Structure describing capabilities of extended dynamic state

Description

If the PhysicalDeviceExtendedDynamicState3PropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_EXT_extended_dynamic_state3, Bool32, StructureType

VkColorBlendEquationEXT - Structure specifying the color blend factors and operations for an attachment

Valid Usage

• If the dualSrcBlend feature is not enabled, srcColorBlendFactor must not be BLEND_FACTOR_SRC1_COLOR, BLEND_FACTOR_ONE_MINUS_SRC1_COLOR, BLEND_FACTOR_SRC1_ALPHA, or BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA

• If the dualSrcBlend feature is not enabled, dstColorBlendFactor must not be BLEND_FACTOR_SRC1_COLOR, BLEND_FACTOR_ONE_MINUS_SRC1_COLOR, BLEND_FACTOR_SRC1_ALPHA, or BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA
• If the dualSrcBlend feature is not enabled, srcAlphaBlendFactor must not be BLEND_FACTOR_SRC1_COLOR, BLEND_FACTOR_ONE_MINUS_SRC1_COLOR, BLEND_FACTOR_SRC1_ALPHA, or BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA
• If the dualSrcBlend feature is not enabled, dstAlphaBlendFactor must not be BLEND_FACTOR_SRC1_COLOR, BLEND_FACTOR_ONE_MINUS_SRC1_COLOR, BLEND_FACTOR_SRC1_ALPHA, or BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA
• colorBlendOp and alphaBlendOp must not be BLEND_OP_ZERO_EXT, BLEND_OP_SRC_EXT, BLEND_OP_DST_EXT, BLEND_OP_SRC_OVER_EXT, BLEND_OP_DST_OVER_EXT, BLEND_OP_SRC_IN_EXT, BLEND_OP_DST_IN_EXT, BLEND_OP_SRC_OUT_EXT, BLEND_OP_DST_OUT_EXT, BLEND_OP_SRC_ATOP_EXT, BLEND_OP_DST_ATOP_EXT, BLEND_OP_XOR_EXT, BLEND_OP_MULTIPLY_EXT, BLEND_OP_SCREEN_EXT, BLEND_OP_OVERLAY_EXT, BLEND_OP_DARKEN_EXT, BLEND_OP_LIGHTEN_EXT, BLEND_OP_COLORDODGE_EXT, BLEND_OP_COLORBURN_EXT, BLEND_OP_HARDLIGHT_EXT, BLEND_OP_SOFTLIGHT_EXT, BLEND_OP_DIFFERENCE_EXT, BLEND_OP_EXCLUSION_EXT, BLEND_OP_INVERT_EXT, BLEND_OP_INVERT_RGB_EXT, BLEND_OP_LINEARDODGE_EXT, BLEND_OP_LINEARBURN_EXT, BLEND_OP_VIVIDLIGHT_EXT, BLEND_OP_LINEARLIGHT_EXT, BLEND_OP_PINLIGHT_EXT, BLEND_OP_HARDMIX_EXT, BLEND_OP_HSL_HUE_EXT, BLEND_OP_HSL_SATURATION_EXT, BLEND_OP_HSL_COLOR_EXT, BLEND_OP_HSL_LUMINOSITY_EXT, BLEND_OP_PLUS_EXT, BLEND_OP_PLUS_CLAMPED_EXT, BLEND_OP_PLUS_CLAMPED_ALPHA_EXT, BLEND_OP_PLUS_DARKER_EXT, BLEND_OP_MINUS_EXT, BLEND_OP_MINUS_CLAMPED_EXT, BLEND_OP_CONTRAST_EXT, BLEND_OP_INVERT_OVG_EXT, BLEND_OP_RED_EXT, BLEND_OP_GREEN_EXT, or BLEND_OP_BLUE_EXT
• If the VK_KHR_portability_subset extension is enabled, and PhysicalDevicePortabilitySubsetFeaturesKHR::constantAlphaColorBlendFactors is FALSE, srcColorBlendFactor must not be BLEND_FACTOR_CONSTANT_ALPHA or BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA
• If the VK_KHR_portability_subset extension is enabled, and PhysicalDevicePortabilitySubsetFeaturesKHR::constantAlphaColorBlendFactors is FALSE, dstColorBlendFactor must not be BLEND_FACTOR_CONSTANT_ALPHA or BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA

Valid Usage (Implicit)

• srcColorBlendFactor must be a valid BlendFactor value

• dstColorBlendFactor must be a valid BlendFactor value
• colorBlendOp must be a valid BlendOp value
• srcAlphaBlendFactor must be a valid BlendFactor value
• dstAlphaBlendFactor must be a valid BlendFactor value
• alphaBlendOp must be a valid BlendOp value

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, BlendFactor, BlendOp, cmdSetColorBlendEquationEXT

VkColorBlendAdvancedEXT - Structure specifying the advanced blend operation parameters for an attachment

Valid Usage

• If the non-premultiplied source color property is not supported, srcPremultiplied must be TRUE

• If the non-premultiplied destination color property is not supported, dstPremultiplied must be TRUE
• If the correlated overlap property is not supported, blendOverlap must be BLEND_OVERLAP_UNCORRELATED_EXT

Valid Usage (Implicit)

• advancedBlendOp must be a valid BlendOp value

• blendOverlap must be a valid BlendOverlapEXT value

See Also

VK_EXT_extended_dynamic_state3, VK_EXT_shader_object, BlendOp, BlendOverlapEXT, Bool32, cmdSetColorBlendAdvancedEXT

VkViewportSwizzleNV - Structure specifying a viewport swizzle

Valid Usage (Implicit)

See Also

VK_NV_viewport_swizzle, PipelineViewportSwizzleStateCreateInfoNV, ViewportCoordinateSwizzleNV, cmdSetViewportSwizzleNV

VkViewportCoordinateSwizzleNV - Specify how a viewport coordinate is swizzled

Description

These values are described in detail in Viewport Swizzle.

See Also

VK_NV_viewport_swizzle, ViewportSwizzleNV

VkBlendOverlapEXT - Enumerant specifying the blend overlap parameter

Description

'

Advanced Blend Overlap Modes

See Also

VK_EXT_blend_operation_advanced, ColorBlendAdvancedEXT, PipelineColorBlendAdvancedStateCreateInfoEXT

VkCoverageModulationModeNV - Specify the coverage modulation mode

See Also

VK_NV_framebuffer_mixed_samples, PipelineCoverageModulationStateCreateInfoNV, cmdSetCoverageModulationModeNV