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