VkDynamicState - Indicate which dynamic state is taken from dynamic
state commands
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.