VkDynamicState - Indicate which dynamic state is taken from dynamic state commands
Description
DYNAMIC_STATE_VIEWPORT specifies that the
pViewportsstate 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 theviewportCountmember of PipelineViewportStateCreateInfo.
DYNAMIC_STATE_SCISSOR specifies that the
pScissorsstate 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 thescissorCountmember of PipelineViewportStateCreateInfo.DYNAMIC_STATE_LINE_WIDTH specifies that the
lineWidthstate 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
pNextchain of PipelineRasterizationStateCreateInfo as well as thedepthBiasConstantFactor,depthBiasClampanddepthBiasSlopeFactorstates 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
blendConstantsstate in PipelineColorBlendStateCreateInfo will be ignored and must be set dynamically with cmdSetBlendConstants before any draws are performed with a pipeline state with PipelineColorBlendAttachmentState memberblendEnableset to TRUE and any of the blend functions using a constant blend color.DYNAMIC_STATE_DEPTH_BOUNDS specifies that the
minDepthBoundsandmaxDepthBoundsstates of PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBounds before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo memberdepthBoundsTestEnableset to TRUE.DYNAMIC_STATE_STENCIL_COMPARE_MASK specifies that the
compareMaskstate in PipelineDepthStencilStateCreateInfo for bothfrontandbackwill be ignored and must be set dynamically with cmdSetStencilCompareMask before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo memberstencilTestEnableset to TRUEDYNAMIC_STATE_STENCIL_WRITE_MASK specifies that the
writeMaskstate in PipelineDepthStencilStateCreateInfo for bothfrontandbackwill be ignored and must be set dynamically with cmdSetStencilWriteMask before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo memberstencilTestEnableset to TRUEDYNAMIC_STATE_STENCIL_REFERENCE specifies that the
referencestate in PipelineDepthStencilStateCreateInfo for bothfrontandbackwill be ignored and must be set dynamically with cmdSetStencilReference before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo memberstencilTestEnableset to TRUEDYNAMIC_STATE_VIEWPORT_W_SCALING_NV specifies that the
pViewportWScalingsstate in PipelineViewportWScalingStateCreateInfoNV will be ignored and must be set dynamically with cmdSetViewportWScalingNV before any draws are performed with a pipeline state with PipelineViewportWScalingStateCreateInfoNV memberviewportScalingEnableset to TRUEDYNAMIC_STATE_DISCARD_RECTANGLE_EXT specifies that the
pDiscardRectanglesstate 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
discardRectangleCountgreater 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 leastspecVersion2of theVK_EXT_discard_rectanglesextension.DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT specifies that the
discardRectangleModestate in PipelineDiscardRectangleStateCreateInfoEXT will be ignored and must be set dynamically with cmdSetDiscardRectangleModeEXT before any draw commands. This is available on implementations that support at leastspecVersion2of theVK_EXT_discard_rectanglesextension.DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT specifies that the
sampleLocationsInfostate 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 thesampleLocationsEnablemember of PipelineSampleLocationsStateCreateInfoEXT.DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV specifies that the
pExclusiveScissorsstate 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
exclusiveScissorCountvalue in PipelineViewportExclusiveScissorStateCreateInfoNV will not implicitly enable them. This is available on implementations that support at leastspecVersion2of theVK_NV_scissor_exclusiveextension.DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV specifies that the
pShadingRatePalettesstate 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
lineStippleFactorandlineStipplePatternstate in PipelineRasterizationLineStateCreateInfo will be ignored and must be set dynamically with cmdSetLineStipple before any draws are performed with a pipeline state with PipelineRasterizationLineStateCreateInfo memberstippledLineEnableset to TRUE.DYNAMIC_STATE_CULL_MODE specifies that the
cullModestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetCullMode before any drawing commands.DYNAMIC_STATE_FRONT_FACE specifies that the
frontFacestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetFrontFace before any drawing commands.DYNAMIC_STATE_PRIMITIVE_TOPOLOGY specifies that the
topologystate 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
viewportCountandpViewportsstate in PipelineViewportStateCreateInfo will be ignored and must be set dynamically with cmdSetViewportWithCount before any draw call.DYNAMIC_STATE_SCISSOR_WITH_COUNT specifies that the
scissorCountandpScissorsstate 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
stridestate in VertexInputBindingDescription will be ignored and must be set dynamically with cmdBindVertexBuffers2 before any draw call.DYNAMIC_STATE_DEPTH_TEST_ENABLE specifies that the
depthTestEnablestate in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthTestEnable before any draw call.DYNAMIC_STATE_DEPTH_WRITE_ENABLE specifies that the
depthWriteEnablestate in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthWriteEnable before any draw call.DYNAMIC_STATE_DEPTH_COMPARE_OP specifies that the
depthCompareOpstate 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
depthBoundsTestEnablestate in PipelineDepthStencilStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBoundsTestEnable before any draw call.DYNAMIC_STATE_STENCIL_TEST_ENABLE specifies that the
stencilTestEnablestate 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, andcompareOpstates in PipelineDepthStencilStateCreateInfo for bothfrontandbackwill be ignored and must be set dynamically with cmdSetStencilOp before any draws are performed with a pipeline state with PipelineDepthStencilStateCreateInfo memberstencilTestEnableset to TRUEDYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT specifies that the
patchControlPointsstate in PipelineTessellationStateCreateInfo will be ignored and must be set dynamically with cmdSetPatchControlPointsEXT before any drawing commands.DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE specifies that the
rasterizerDiscardEnablestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetRasterizerDiscardEnable before any drawing commands.DYNAMIC_STATE_DEPTH_BIAS_ENABLE specifies that the
depthBiasEnablestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthBiasEnable before any drawing commands.DYNAMIC_STATE_LOGIC_OP_EXT specifies that the
logicOpstate in PipelineColorBlendStateCreateInfo will be ignored and must be set dynamically with cmdSetLogicOpEXT before any drawing commands.DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE specifies that the
primitiveRestartEnablestate 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
pVertexInputStatestate will be ignored and must be set dynamically with cmdSetVertexInputEXT before any drawing commandsDYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT specifies that the
pColorWriteEnablesstate 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
domainOriginstate 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
depthClampEnablestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetDepthClampEnableEXT before any draw call.DYNAMIC_STATE_POLYGON_MODE_EXT specifies that the
polygonModestate in PipelineRasterizationStateCreateInfo will be ignored and must be set dynamically with cmdSetPolygonModeEXT before any draw call.DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT specifies that the
rasterizationSamplesstate in PipelineMultisampleStateCreateInfo will be ignored and must be set dynamically with cmdSetRasterizationSamplesEXT before any draw call.DYNAMIC_STATE_SAMPLE_MASK_EXT specifies that the
pSampleMaskstate 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
alphaToCoverageEnablestate 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
alphaToOneEnablestate 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
logicOpEnablestate 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
blendEnablestate 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, andalphaBlendOpstates 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
colorWriteMaskstate in PipelineColorBlendAttachmentState will be ignored and must be set dynamically with cmdSetColorWriteMaskEXT before any draw call.DYNAMIC_STATE_RASTERIZATION_STREAM_EXT specifies that the
rasterizationStreamstate 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
conservativeRasterizationModestate 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
extraPrimitiveOverestimationSizestate 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
depthClipEnablestate 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
sampleLocationsEnablestate 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
colorBlendOpstate in PipelineColorBlendAttachmentState, andsrcPremultiplied,dstPremultiplied, andblendOverlapstates 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
provokingVertexModestate 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
lineRasterizationModestate 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
stippledLineEnablestate 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
negativeOneToOnestate 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
depthClampModeandpDepthClampRangestate 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
viewportWScalingEnablestate 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, andpViewportSwizzlesstates 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
coverageToColorEnablestate 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
coverageToColorLocationstate 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
coverageModulationModestate 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
coverageModulationTableEnablestate 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, andpCoverageModulationTablestates 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
shadingRateImageEnablestate 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
representativeFragmentTestEnablestate 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
coverageReductionModestate 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
Constructors
Instances6Eq, Ord, Read, Show, Storable, Zero
Eq DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicStateOrd DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicStateRead DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicStateShow DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicStateStorable DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicStateZero DynamicStateDefined in vulkan-3.27 · Vulkan.Core10.Enums.DynamicState