Class NVMeshShader
There are new programmable shader types — the task and mesh shader — to generate these collections to be processed by fixed-function primitive assembly and rasterization logic. When task and mesh shaders are dispatched, they replace the core pre-rasterization stages, including vertex array attribute fetching, vertex shader processing, tessellation, and geometry shader processing.
This extension also adds support for the following SPIR-V extension in Vulkan:
VK_NV_mesh_shader
- Name String
VK_NV_mesh_shader
- Extension Type
- Device extension
- Registered Extension Number
- 203
- Revision
- 1
- Extension and Version Dependencies
VK_KHR_get_physical_device_properties2
- Contact
- Christoph Kubisch pixeljetstream
Other Extension Metadata
- Last Modified Date
- 2018-07-19
- Interactions and External Dependencies
- This extension requires
SPV_NV_mesh_shader
- This extension provides API support for
GLSL_NV_mesh_shader
- This extension requires
- Contributors
- Pat Brown, NVIDIA
- Jeff Bolz, NVIDIA
- Daniel Koch, NVIDIA
- Piers Daniell, NVIDIA
- Pierre Boudier, NVIDIA
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
The extension name.static final int
The extension specification version.static final int
ExtendsVkPipelineStageFlagBits
.static final int
ExtendsVkPipelineStageFlagBits
.static final int
ExtendsVkShaderStageFlagBits
.static final int
ExtendsVkShaderStageFlagBits
.static final int
ExtendsVkStructureType
.static final int
ExtendsVkStructureType
. -
Method Summary
Modifier and TypeMethodDescriptionstatic void
vkCmdDrawMeshTasksIndirectCountNV
(VkCommandBuffer commandBuffer, long buffer, long offset, long countBuffer, long countBufferOffset, int maxDrawCount, int stride) Perform an indirect mesh tasks draw with the draw count sourced from a buffer.static void
vkCmdDrawMeshTasksIndirectNV
(VkCommandBuffer commandBuffer, long buffer, long offset, int drawCount, int stride) Issue an indirect mesh tasks draw into a command buffer.static void
vkCmdDrawMeshTasksNV
(VkCommandBuffer commandBuffer, int taskCount, int firstTask) Draw mesh task work items.
-
Field Details
-
VK_NV_MESH_SHADER_SPEC_VERSION
public static final int VK_NV_MESH_SHADER_SPEC_VERSIONThe extension specification version.- See Also:
-
VK_NV_MESH_SHADER_EXTENSION_NAME
The extension name.- See Also:
-
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_NV
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_NVExtendsVkStructureType
.Enum values:
- See Also:
-
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_NV
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_NVExtendsVkStructureType
.Enum values:
- See Also:
-
VK_SHADER_STAGE_TASK_BIT_NV
public static final int VK_SHADER_STAGE_TASK_BIT_NV- See Also:
-
VK_SHADER_STAGE_MESH_BIT_NV
public static final int VK_SHADER_STAGE_MESH_BIT_NV- See Also:
-
VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV
public static final int VK_PIPELINE_STAGE_TASK_SHADER_BIT_NVExtendsVkPipelineStageFlagBits
.Enum values:
- See Also:
-
VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV
public static final int VK_PIPELINE_STAGE_MESH_SHADER_BIT_NVExtendsVkPipelineStageFlagBits
.Enum values:
- See Also:
-
-
Method Details
-
vkCmdDrawMeshTasksNV
public static void vkCmdDrawMeshTasksNV(VkCommandBuffer commandBuffer, int taskCount, int firstTask) Draw mesh task work items.C Specification
To record a mesh tasks drawing command, call:
void vkCmdDrawMeshTasksNV( VkCommandBuffer commandBuffer, uint32_t taskCount, uint32_t firstTask);
Description
When the command is executed, a global workgroup consisting of
taskCount
local workgroups is assembled.Valid Usage
- If a
VkSampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkSampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
VkImageView
is accessed using atomic operations as a result of this command, then the image view’s format features must containFORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT
- If a
DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER
descriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containFORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT
- If a
VkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT
- If the
VK_EXT_filter_cubic
extension is not enabled and anyVkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, it must not have aVkImageViewType
ofIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
, orIMAGE_VIEW_TYPE_CUBE_ARRAY
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aVkImageViewType
and format that supports cubic filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned byGetPhysicalDeviceImageFormatProperties2
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
with a reduction mode of eitherSAMPLER_REDUCTION_MODE_MIN
orSAMPLER_REDUCTION_MODE_MAX
as a result of this command must have aVkImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned byGetPhysicalDeviceImageFormatProperties2
- If the
cubicRangeClamp
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must not have aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
- Any
VkImageView
being sampled with aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
as a result of this command must sample withFILTER_CUBIC_EXT
- If the
selectableCubicWeights
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must haveVkSamplerCubicWeightsCreateInfoQCOM
::cubicWeights
equal toCUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM
- Any
VkImage
created with aVkImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aVkSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
VkImageView
being written as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- For any
VkImageView
being read as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For any
VkBufferView
being written as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
, the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- Any
VkBufferView
being read as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
then the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a
VkPipelineLayout
that is compatible for set n, with theVkPipelineLayout
orVkDescriptorSetLayout
array that was used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a
VkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - If the
maintenance4
feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with aVkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - Descriptors in each bound descriptor set, specified via
CmdBindDescriptorSets
, must be valid if they are statically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was not created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdBindDescriptorSets
, the boundVkPipeline
must have been created withoutPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command - If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdSetDescriptorBufferOffsetsEXT
, the boundVkPipeline
must have been created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If a descriptor is dynamically used with a
VkPipeline
created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If a descriptor is dynamically used with a
VkShaderEXT
created with aVkDescriptorSetLayout
that was created withDESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If the
shaderObject
feature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command - If the
shaderObject
is enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid andNULL_HANDLE
shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command - If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the
VkPipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyVkImage
with aVkImageView
of the typeIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
,IMAGE_VIEW_TYPE_1D_ARRAY
,IMAGE_VIEW_TYPE_2D_ARRAY
orIMAGE_VIEW_TYPE_CUBE_ARRAY
, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions withImplicitLod
,Dref
orProj
in their name, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions that includes a LOD bias or any offset values, in any shader stage - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
foruniformBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
forstorageBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If
commandBuffer
is an unprotected command buffer andprotectedNoFault
is not supported, any resource accessed by bound shaders must not be a protected resource - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
VkImageView
is accessed as a result of this command, then the image view’sviewType
must match theDim
operand of theOpTypeImage
as described in textures-operation-validation - If a
VkImageView
is accessed as a result of this command, then the numeric type of the image view’sformat
and theSampled
Type
operand of theOpTypeImage
must match - If a
VkImageView
created with a format other thanFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the image view’s format - If a
VkImageView
created with the formatFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have four components - If a
VkBufferView
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the buffer view’s format - If a
VkImageView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkImageView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If a
VkBufferView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkBufferView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If the
sparseImageInt64Atomics
feature is not enabled,VkImage
objects created with theIMAGE_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If the
sparseImageInt64Atomics
feature is not enabled,VkBuffer
objects created with theBUFFER_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If
OpImageWeightedSampleQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM
- If
OpImageWeightedSampleQCOM
uses aVkImageView
as a sample weight image as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM
- If
OpImageBoxFilterQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM
- If
OpImageBlockMatchSSDQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - If
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If any command other than
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format must be a single-component format. - If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - Any shader invocation executed by this command must terminate
- The current render pass must be compatible with the
renderPass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass index of the current render pass must be equal to the
subpass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- If any shader statically accesses an input attachment, a valid descriptor must be bound to the pipeline via a descriptor set
- If any shader executed by this pipeline accesses an
OpTypeImage
variable with aDim
operand ofSubpassData
, it must be decorated with anInputAttachmentIndex
that corresponds to a valid input attachment in the current subpass - Input attachment views accessed in a subpass must be created with the same
VkFormat
as the corresponding subpass definition, and be created with aVkImageView
that is compatible with the attachment referenced by the subpass'pInputAttachments
[InputAttachmentIndex
] in the currently boundVkFramebuffer
as specified by Fragment Input Attachment Compatibility - Memory backing image subresources used as attachments in the current render pass must not be written in any way other than as an attachment by this command
- If a color attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_COLOR_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_COLOR_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a depth attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_DEPTH_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a stencil attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_STENCIL_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If an attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it must not be accessed in any way other than as an attachment, storage image, or sampled image by this command
- If any previously recorded command in the current subpass accessed an image subresource used as an attachment in this subpass in any way other than as an attachment, this command must not write to that image subresource as an attachment
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, depth writes must be disabled
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect, both front and back
writeMask
are not zero, and stencil test is enabled, all stencil ops must beSTENCIL_OP_KEEP
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT
dynamic state enabled thenCmdSetViewport
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR
dynamic state enabled thenCmdSetScissor
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_WIDTH
dynamic state enabled thenCmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object that outputs line primitives is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS
dynamic state enabled thenCmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBiasEnable
in the current command buffer setdepthBiasEnable
toTRUE
,CmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_BLEND_CONSTANTS
dynamic state enabled thenCmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
in the current command buffer set any element ofpColorBlendEnables
toTRUE
, and the most recent call toCmdSetColorBlendEquationEXT
in the current command buffer set the same element ofpColorBlendEquations
to aVkColorBlendEquationEXT
structure with anyVkBlendFactor
member with a value ofBLEND_FACTOR_CONSTANT_COLOR
,BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR
,BLEND_FACTOR_CONSTANT_ALPHA
, orBLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA
,CmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS
dynamic state enabled, and if the currentdepthBoundsTestEnable
state isTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBoundsTestEnable
in the current command buffer setdepthBoundsTestEnable
toTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_COMPARE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_WRITE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_REFERENCE
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index must be less than or equal to
VkPhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
- If the bound graphics pipeline was created with
VkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
set toTRUE
and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
dynamic state enabled thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetSampleLocationsEnableEXT
in the current command buffer setsampleLocationsEnable
toTRUE
, thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CULL_MODE
dynamic state enabled thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_FRONT_FACE
dynamic state enabled thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_TEST_ENABLE
dynamic state enabled thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
dynamic state enabled thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_COMPARE_OP
dynamic state enabled thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthTestEnable
in the current command buffer setdepthTestEnable
toTRUE
, thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE
dynamic state enabled thenCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the
depthBounds
feature is enabled, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_TEST_ENABLE
dynamic state enabled thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_OP
dynamic state enabled thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
, thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match theVkPipelineViewportStateCreateInfo
::scissorCount
of the pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, thenCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and thescissorCount
parameter ofvkCmdSetScissorWithCount
must match theVkPipelineViewportStateCreateInfo
::viewportCount
of the pipeline - If the bound graphics pipeline state was created with both the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic states enabled then bothCmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If a shader object is bound to any graphics stage, then both
CmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportWScalingStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, thenCmdSetViewportWScalingNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportShadingRateImageStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoarseSampleOrderNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, thenCmdSetViewportShadingRatePaletteNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportSwizzleStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV
dynamic state enabled thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV
dynamic state enabled thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetExclusiveScissorEnableNV
in the current command buffer set any element ofpExclusiveScissorEnables
toTRUE
, thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE
dynamic state enabled thenCmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, then
CmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS_ENABLE
dynamic state enabled thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_EXT
dynamic state enabled thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLogicOpEnableEXT
setlogicOpEnable
toTRUE
, thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, and any shader object bound to a graphics stage writes to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s format features do not contain
FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then theblendEnable
member of the corresponding element of thepAttachments
member ofpColorBlendState
must beFALSE
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then for each color attachment in the render pass, if the corresponding image view’s format features do not containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then the corresponding member ofpColorBlendEnables
in the most recent call tovkCmdSetColorBlendEnableEXT
in the current command buffer that affected that attachment index must have beenFALSE
- If rasterization is not disabled in the bound graphics pipeline, and none of the
VK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, thenrasterizationSamples
for the currently bound graphics pipeline must be the same as the current subpass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and none of theVK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, then the most recent call toCmdSetRasterizationSamplesEXT
in the current command buffer must have setrasterizationSamples
to be the same as the number of samples for the current render pass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, the current render pass instance must have been begun with
CmdBeginRendering
- If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::viewMask
equal toVkRenderingInfo
::viewMask
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::colorAttachmentCount
equal toVkRenderingInfo
::colorAttachmentCount
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - If the
dynamicRenderingUnusedAttachments
feature is enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline, or the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
, if it exists, must beFORMAT_UNDEFINED
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
equal toNULL_HANDLE
must have the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound pipeline equal toFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, with aVkRenderingInfo
::colorAttachmentCount
equal to 1, there is no shader object bound to any graphics stage, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aresolveImageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If there is no shader object bound to any graphics stage, the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled, thenCmdSetColorBlendEnableEXT
must have set the blend enable toFALSE
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetColorBlendEnableEXT
must have set blend enable toFALSE
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled then theattachmentCount
parameter ofvkCmdSetColorWriteEnableEXT
must be greater than or equal to theVkPipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theattachmentCount
parameter of most recent call tovkCmdSetColorWriteEnableEXT
in the current command buffer must be greater than or equal to the number of color attachments in the current render pass instance - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command for each discard rectangle inVkPipelineDiscardRectangleStateCreateInfoEXT
::discardRectangleCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT
dynamic state enabled thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentShadingRateAttachmentInfoKHR
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentDensityMapAttachmentInfoEXT
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
- If the currently bound pipeline was created with a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the currently bound pipeline was created without a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofrasterizationSamples
for the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If this command has been called inside a render pass instance started with
CmdBeginRendering
, and thepNext
chain ofVkRenderingInfo
includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal toVkMultisampledRenderToSingleSampledInfoEXT
::rasterizationSamples
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline must have been created with aVkGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound with a fragment shader that statically writes to a color attachment, the color write mask is not zero, color writes are enabled, and the corresponding element of theVkRenderingInfo
::pColorAttachments→imageView
was notNULL_HANDLE
, then the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, depth test is enabled, depth write is enabled, and theVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, stencil test is enabled and theVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled - If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inVkPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_TESSELLATION_DOMAIN_ORIGIN_EXT
dynamic state enabled thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
stage, thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClamp
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_POLYGON_MODE_EXT
dynamic state enabled thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
dynamic state enabled thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled, andalphaToCoverageEnable
wasTRUE
in the last call toCmdSetAlphaToCoverageEnableEXT
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetAlphaToCoverageEnableEXT
in the current command buffer setalphaToCoverageEnable
toTRUE
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_ONE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
alphaToOne
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_ENABLE_EXT
dynamic state enabled thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
logicOp
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
for any attachment set that attachment’s value inpColorBlendEnables
toTRUE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_STREAM_EXT
dynamic state enabled thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the
geometryStreams
feature is enabled, and a shader object is bound to theSHADER_STAGE_GEOMETRY_BIT
stage, thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXTRA_PRIMITIVE_OVERESTIMATION_SIZE_EXT
dynamic state enabled thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetConservativeRasterizationModeEXT
in the current command buffer setconservativeRasterizationMode
toCONSERVATIVE_RASTERIZATION_MODE_OVERESTIMATE_EXT
, thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipEnable
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
dynamic state enabled thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_sample_locations
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_blend_operation_advanced
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then at least one ofCmdSetColorBlendEquationEXT
andCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_PROVOKING_VERTEX_MODE_EXT
dynamic state enabled thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_provoking_vertex
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
dynamic state enabled thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_EXT
dynamic state enabled thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLineStippleEnableEXT
in the current command buffer setstippledLineEnable
toTRUE
, thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_NEGATIVE_ONE_TO_ONE_EXT
dynamic state enabled thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipControl
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_W_SCALING_ENABLE_NV
dynamic state enabled thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
dynamic state enabled thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_LOCATION_NV
dynamic state enabled thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageToColorEnableNV
in the current command buffer setcoverageToColorEnable
toTRUE
, thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_MODE_NV
dynamic state enabled thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationModeNV
in the current command buffer set coverageModulationMode to any value other thanCOVERAGE_MODULATION_MODE_NONE_NV
, thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationTableEnableNV
in the current command buffer setcoverageModulationTableEnable
toTRUE
, thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SHADING_RATE_IMAGE_ENABLE_NV
dynamic state enabled thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the
pipelineFragmentShadingRate
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer set rasterizerDiscardEnable toFALSE
, thenCmdSetFragmentShadingRateKHR
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_REPRESENTATIVE_FRAGMENT_TEST_ENABLE_NV
dynamic state enabled thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the
representativeFragmentTest
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_REDUCTION_MODE_NV
dynamic state enabled thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the
coverageReductionMode
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
state enabled and the last call toCmdSetColorBlendEnableEXT
setpColorBlendEnables
for any attachment toTRUE
, then for those attachments in the subpass the corresponding image view’s format features must containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and the current subpass does not use any color and/or depth/stencil attachments, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must follow the rules for a zero-attachment subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to theVkPipelineMultisampleStateCreateInfo
::rasterizationSamples
parameter used to create the bound graphics pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to therasterizationSamples
parameter in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and neither theVK_AMD_mixed_attachment_samples
nor theVK_NV_framebuffer_mixed_samples
extensions are enabled, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as the current subpass color and/or depth/stencil attachments - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, or a shader object is bound to any graphics stage, and the current render pass instance includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as therasterizationSamples
member of that structure - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendAdvancedEXT
calls must specify the advanced blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
andDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic states enabled and the last calls toCmdSetColorBlendEnableEXT
andCmdSetColorBlendAdvancedEXT
have enabled advanced blending, then the number of active color attachments in the current subpass must not exceedadvancedBlendMaxColorAttachments
- If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, and the bound graphics pipeline was created withDYNAMIC_STATE_RASTERIZATION_STREAM_EXT
state enabled, the last call toCmdSetRasterizationStreamEXT
must have set therasterizationStream
to zero - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
parameter of the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, andsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.width
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.height
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, the fragment shader code must not statically use the extended instructionInterpolateAtSample
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.width
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.height
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationsPerPixel
must equalrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to any graphics stage or the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
state enabled, and the last call toCmdSetCoverageModulationTableEnableNV
setcoverageModulationTableEnable
toTRUE
, then thecoverageModulationTableCount
parameter in the last call toCmdSetCoverageModulationTableNV
must equal the currentrasterizationSamples
divided by the number of color samples in the current subpass - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if current subpass has a depth/stencil attachment and depth test, stencil test, or depth bounds test are enabled in the currently bound pipeline state, then the currentrasterizationSamples
must be the same as the sample count of the depth/stencil attachment - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
state enabled and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If this
VK_NV_coverage_reduction_mode
extension is enabled, the bound graphics pipeline state was created with theDYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, the current coverage reduction modecoverageReductionMode
, then the currentrasterizationSamples
, and the sample counts for the color and depth/stencil attachments (if the subpass has them) must be a valid combination returned byGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if the current subpass has any color attachments andrasterizationSamples
of the last call toCmdSetRasterizationSamplesEXT
is greater than the number of color samples, then the pipelinesampleShadingEnable
must beFALSE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_EXT
, then thestippledRectangularLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_BRESENHAM_EXT
, then thestippledBresenhamLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT
, then thestippledSmoothLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_DEFAULT_EXT
, then thestippledRectangularLines
feature must be enabled andVkPhysicalDeviceLimits
::strictLines
must beTRUE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled,conservativePointAndLineRasterization
is not supported, and the effective primitive topology output by the last pre-rasterization shader stage is a line or point, then theconservativeRasterizationMode
set by the last call toCmdSetConservativeRasterizationModeEXT
must beCONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT
- If the currently bound pipeline was created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
, then Mesh Shader Queries must not be active - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
dynamic stateCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If dynamic state was inherited from
VkCommandBufferInheritanceViewportScissorInfoNV
, it must be set in the current command buffer prior to this drawing command - If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_VERTEX_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_CONTROL_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_EVALUATION_BIT
- If there is no bound graphics pipeline, and the
geometryShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_GEOMETRY_BIT
- If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_FRAGMENT_BIT
- If there is no bound graphics pipeline, and the
taskShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TASK_BIT_EXT
- If there is no bound graphics pipeline, and the
meshShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_MESH_BIT_EXT
- If there is no bound graphics pipeline, and at least one of the
taskShader
andmeshShader
features is enabled, one of theSHADER_STAGE_VERTEX_BIT
orSHADER_STAGE_MESH_BIT_EXT
stages must have a validVkShaderEXT
bound, and the other must have noVkShaderEXT
bound - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created without theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, a validVkShaderEXT
must be bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created with theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, there must be noVkShaderEXT
bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and a valid
VkShaderEXT
is bound to theSHADER_STAGE_VERTEX_BIT
stage, there must be noVkShaderEXT
bound to either theSHADER_STAGE_TASK_BIT_EXT
stage or theSHADER_STAGE_MESH_BIT_EXT
stage - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, then all shaders created with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag in the sameCreateShadersEXT
call must also be bound - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, any stages in between stages whose shaders which did not create a shader with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag as part of the sameCreateShadersEXT
call must not have anyVkShaderEXT
bound - All bound graphics shader objects must have been created with identical or identically defined push constant ranges
- All bound graphics shader objects must have been created with identical or identically defined arrays of descriptor set layouts
- If the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, and a fragment shader is bound, it must not declare theDepthReplacing
orStencilRefReplacingEXT
execution modes - If the attachmentFeedbackLoopDynamicState feature is enabled on the device, and a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpDepthAttachmentReadEXT
, thedepthWriteEnable
parameter in the last call toCmdSetDepthWriteEnable
must beFALSE
- If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_STENCIL_WRITE_MASK
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpStencilAttachmentReadEXT
, thewriteMask
parameter in the last call toCmdSetStencilWriteMask
must be 0 - If a shader object is bound to any graphics stage or the currently bound graphics pipeline was created with
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
, and the format of any color attachment isFORMAT_E5B9G9R9_UFLOAT_PACK32
, the corresponding element of thepColorWriteMasks
parameter ofCmdSetColorWriteMaskEXT
must either include all ofCOLOR_COMPONENT_R_BIT
,COLOR_COMPONENT_G_BIT
, andCOLOR_COMPONENT_B_BIT
, or none of them - If blending is enabled for any attachment where either the source or destination blend factors for that attachment use the secondary color input, the maximum value of
Location
for any output attachment statically used in theFragment
Execution
Model
executed by this command must be less thanmaxFragmentDualSrcAttachments
- The bound graphics pipeline must not have been created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
- Transform Feedback Queries must not be active
- Primitives Generated Queries must not be active
- The
pipelineStatistics
member used to create any active Pipeline Statistics Query must not containQUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_VERTICES_BIT
,QUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_VERTEX_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_TESSELLATION_CONTROL_SHADER_PATCHES_BIT
, orQUERY_PIPELINE_STATISTIC_TESSELLATION_EVALUATION_SHADER_INVOCATIONS_BIT
taskCount
must be less than or equal toVkPhysicalDeviceMeshShaderPropertiesNV
::maxDrawMeshTasksCount
- The current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshNV
Execution
Model
Valid Usage (Implicit)
commandBuffer
must be a validVkCommandBuffer
handlecommandBuffer
must be in the recording state- The
VkCommandPool
thatcommandBuffer
was allocated from must support graphics operations - This command must only be called inside of a render pass instance
- 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
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized
Command Properties
Command Buffer Levels Render Pass Scope Video Coding Scope Supported Queue Types Command Type Primary Secondary Inside Outside Graphics Action - Parameters:
commandBuffer
- the command buffer into which the command will be recorded.taskCount
- the number of local workgroups to dispatch in the X dimension. Y and Z dimension are implicitly set to one.firstTask
- the X component of the first workgroup ID.
- If a
-
vkCmdDrawMeshTasksIndirectNV
public static void vkCmdDrawMeshTasksIndirectNV(VkCommandBuffer commandBuffer, long buffer, long offset, int drawCount, int stride) Issue an indirect mesh tasks draw into a command buffer.C Specification
To record an indirect mesh tasks drawing command, call:
void vkCmdDrawMeshTasksIndirectNV( VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, uint32_t drawCount, uint32_t stride);
Description
vkCmdDrawMeshTasksIndirectNV
behaves similarly toCmdDrawMeshTasksNV
except that the parameters are read by the device from a buffer during execution.drawCount
draws are executed by the command, with parameters taken frombuffer
starting atoffset
and increasing bystride
bytes for each successive draw. The parameters of each draw are encoded in an array ofVkDrawMeshTasksIndirectCommandNV
structures. IfdrawCount
is less than or equal to one,stride
is ignored.Valid Usage
- If a
VkSampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkSampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
VkImageView
is accessed using atomic operations as a result of this command, then the image view’s format features must containFORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT
- If a
DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER
descriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containFORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT
- If a
VkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT
- If the
VK_EXT_filter_cubic
extension is not enabled and anyVkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, it must not have aVkImageViewType
ofIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
, orIMAGE_VIEW_TYPE_CUBE_ARRAY
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aVkImageViewType
and format that supports cubic filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned byGetPhysicalDeviceImageFormatProperties2
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
with a reduction mode of eitherSAMPLER_REDUCTION_MODE_MIN
orSAMPLER_REDUCTION_MODE_MAX
as a result of this command must have aVkImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned byGetPhysicalDeviceImageFormatProperties2
- If the
cubicRangeClamp
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must not have aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
- Any
VkImageView
being sampled with aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
as a result of this command must sample withFILTER_CUBIC_EXT
- If the
selectableCubicWeights
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must haveVkSamplerCubicWeightsCreateInfoQCOM
::cubicWeights
equal toCUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM
- Any
VkImage
created with aVkImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aVkSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
VkImageView
being written as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- For any
VkImageView
being read as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For any
VkBufferView
being written as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
, the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- Any
VkBufferView
being read as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
then the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a
VkPipelineLayout
that is compatible for set n, with theVkPipelineLayout
orVkDescriptorSetLayout
array that was used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a
VkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - If the
maintenance4
feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with aVkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - Descriptors in each bound descriptor set, specified via
CmdBindDescriptorSets
, must be valid if they are statically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was not created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdBindDescriptorSets
, the boundVkPipeline
must have been created withoutPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command - If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdSetDescriptorBufferOffsetsEXT
, the boundVkPipeline
must have been created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If a descriptor is dynamically used with a
VkPipeline
created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If a descriptor is dynamically used with a
VkShaderEXT
created with aVkDescriptorSetLayout
that was created withDESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If the
shaderObject
feature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command - If the
shaderObject
is enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid andNULL_HANDLE
shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command - If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the
VkPipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyVkImage
with aVkImageView
of the typeIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
,IMAGE_VIEW_TYPE_1D_ARRAY
,IMAGE_VIEW_TYPE_2D_ARRAY
orIMAGE_VIEW_TYPE_CUBE_ARRAY
, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions withImplicitLod
,Dref
orProj
in their name, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions that includes a LOD bias or any offset values, in any shader stage - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
foruniformBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
forstorageBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If
commandBuffer
is an unprotected command buffer andprotectedNoFault
is not supported, any resource accessed by bound shaders must not be a protected resource - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
VkImageView
is accessed as a result of this command, then the image view’sviewType
must match theDim
operand of theOpTypeImage
as described in textures-operation-validation - If a
VkImageView
is accessed as a result of this command, then the numeric type of the image view’sformat
and theSampled
Type
operand of theOpTypeImage
must match - If a
VkImageView
created with a format other thanFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the image view’s format - If a
VkImageView
created with the formatFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have four components - If a
VkBufferView
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the buffer view’s format - If a
VkImageView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkImageView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If a
VkBufferView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkBufferView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If the
sparseImageInt64Atomics
feature is not enabled,VkImage
objects created with theIMAGE_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If the
sparseImageInt64Atomics
feature is not enabled,VkBuffer
objects created with theBUFFER_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If
OpImageWeightedSampleQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM
- If
OpImageWeightedSampleQCOM
uses aVkImageView
as a sample weight image as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM
- If
OpImageBoxFilterQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM
- If
OpImageBlockMatchSSDQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - If
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If any command other than
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format must be a single-component format. - If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - Any shader invocation executed by this command must terminate
- The current render pass must be compatible with the
renderPass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass index of the current render pass must be equal to the
subpass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- If any shader statically accesses an input attachment, a valid descriptor must be bound to the pipeline via a descriptor set
- If any shader executed by this pipeline accesses an
OpTypeImage
variable with aDim
operand ofSubpassData
, it must be decorated with anInputAttachmentIndex
that corresponds to a valid input attachment in the current subpass - Input attachment views accessed in a subpass must be created with the same
VkFormat
as the corresponding subpass definition, and be created with aVkImageView
that is compatible with the attachment referenced by the subpass'pInputAttachments
[InputAttachmentIndex
] in the currently boundVkFramebuffer
as specified by Fragment Input Attachment Compatibility - Memory backing image subresources used as attachments in the current render pass must not be written in any way other than as an attachment by this command
- If a color attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_COLOR_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_COLOR_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a depth attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_DEPTH_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a stencil attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_STENCIL_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If an attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it must not be accessed in any way other than as an attachment, storage image, or sampled image by this command
- If any previously recorded command in the current subpass accessed an image subresource used as an attachment in this subpass in any way other than as an attachment, this command must not write to that image subresource as an attachment
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, depth writes must be disabled
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect, both front and back
writeMask
are not zero, and stencil test is enabled, all stencil ops must beSTENCIL_OP_KEEP
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT
dynamic state enabled thenCmdSetViewport
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR
dynamic state enabled thenCmdSetScissor
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_WIDTH
dynamic state enabled thenCmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object that outputs line primitives is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS
dynamic state enabled thenCmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBiasEnable
in the current command buffer setdepthBiasEnable
toTRUE
,CmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_BLEND_CONSTANTS
dynamic state enabled thenCmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
in the current command buffer set any element ofpColorBlendEnables
toTRUE
, and the most recent call toCmdSetColorBlendEquationEXT
in the current command buffer set the same element ofpColorBlendEquations
to aVkColorBlendEquationEXT
structure with anyVkBlendFactor
member with a value ofBLEND_FACTOR_CONSTANT_COLOR
,BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR
,BLEND_FACTOR_CONSTANT_ALPHA
, orBLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA
,CmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS
dynamic state enabled, and if the currentdepthBoundsTestEnable
state isTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBoundsTestEnable
in the current command buffer setdepthBoundsTestEnable
toTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_COMPARE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_WRITE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_REFERENCE
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index must be less than or equal to
VkPhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
- If the bound graphics pipeline was created with
VkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
set toTRUE
and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
dynamic state enabled thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetSampleLocationsEnableEXT
in the current command buffer setsampleLocationsEnable
toTRUE
, thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CULL_MODE
dynamic state enabled thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_FRONT_FACE
dynamic state enabled thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_TEST_ENABLE
dynamic state enabled thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
dynamic state enabled thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_COMPARE_OP
dynamic state enabled thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthTestEnable
in the current command buffer setdepthTestEnable
toTRUE
, thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE
dynamic state enabled thenCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the
depthBounds
feature is enabled, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_TEST_ENABLE
dynamic state enabled thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_OP
dynamic state enabled thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
, thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match theVkPipelineViewportStateCreateInfo
::scissorCount
of the pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, thenCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and thescissorCount
parameter ofvkCmdSetScissorWithCount
must match theVkPipelineViewportStateCreateInfo
::viewportCount
of the pipeline - If the bound graphics pipeline state was created with both the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic states enabled then bothCmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If a shader object is bound to any graphics stage, then both
CmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportWScalingStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, thenCmdSetViewportWScalingNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportShadingRateImageStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoarseSampleOrderNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, thenCmdSetViewportShadingRatePaletteNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportSwizzleStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV
dynamic state enabled thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV
dynamic state enabled thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetExclusiveScissorEnableNV
in the current command buffer set any element ofpExclusiveScissorEnables
toTRUE
, thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE
dynamic state enabled thenCmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, then
CmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS_ENABLE
dynamic state enabled thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_EXT
dynamic state enabled thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLogicOpEnableEXT
setlogicOpEnable
toTRUE
, thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, and any shader object bound to a graphics stage writes to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s format features do not contain
FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then theblendEnable
member of the corresponding element of thepAttachments
member ofpColorBlendState
must beFALSE
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then for each color attachment in the render pass, if the corresponding image view’s format features do not containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then the corresponding member ofpColorBlendEnables
in the most recent call tovkCmdSetColorBlendEnableEXT
in the current command buffer that affected that attachment index must have beenFALSE
- If rasterization is not disabled in the bound graphics pipeline, and none of the
VK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, thenrasterizationSamples
for the currently bound graphics pipeline must be the same as the current subpass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and none of theVK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, then the most recent call toCmdSetRasterizationSamplesEXT
in the current command buffer must have setrasterizationSamples
to be the same as the number of samples for the current render pass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, the current render pass instance must have been begun with
CmdBeginRendering
- If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::viewMask
equal toVkRenderingInfo
::viewMask
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::colorAttachmentCount
equal toVkRenderingInfo
::colorAttachmentCount
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - If the
dynamicRenderingUnusedAttachments
feature is enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline, or the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
, if it exists, must beFORMAT_UNDEFINED
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
equal toNULL_HANDLE
must have the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound pipeline equal toFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, with aVkRenderingInfo
::colorAttachmentCount
equal to 1, there is no shader object bound to any graphics stage, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aresolveImageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If there is no shader object bound to any graphics stage, the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled, thenCmdSetColorBlendEnableEXT
must have set the blend enable toFALSE
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetColorBlendEnableEXT
must have set blend enable toFALSE
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled then theattachmentCount
parameter ofvkCmdSetColorWriteEnableEXT
must be greater than or equal to theVkPipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theattachmentCount
parameter of most recent call tovkCmdSetColorWriteEnableEXT
in the current command buffer must be greater than or equal to the number of color attachments in the current render pass instance - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command for each discard rectangle inVkPipelineDiscardRectangleStateCreateInfoEXT
::discardRectangleCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT
dynamic state enabled thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentShadingRateAttachmentInfoKHR
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentDensityMapAttachmentInfoEXT
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
- If the currently bound pipeline was created with a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the currently bound pipeline was created without a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofrasterizationSamples
for the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If this command has been called inside a render pass instance started with
CmdBeginRendering
, and thepNext
chain ofVkRenderingInfo
includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal toVkMultisampledRenderToSingleSampledInfoEXT
::rasterizationSamples
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline must have been created with aVkGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound with a fragment shader that statically writes to a color attachment, the color write mask is not zero, color writes are enabled, and the corresponding element of theVkRenderingInfo
::pColorAttachments→imageView
was notNULL_HANDLE
, then the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, depth test is enabled, depth write is enabled, and theVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, stencil test is enabled and theVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled - If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inVkPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_TESSELLATION_DOMAIN_ORIGIN_EXT
dynamic state enabled thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
stage, thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClamp
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_POLYGON_MODE_EXT
dynamic state enabled thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
dynamic state enabled thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled, andalphaToCoverageEnable
wasTRUE
in the last call toCmdSetAlphaToCoverageEnableEXT
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetAlphaToCoverageEnableEXT
in the current command buffer setalphaToCoverageEnable
toTRUE
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_ONE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
alphaToOne
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_ENABLE_EXT
dynamic state enabled thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
logicOp
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
for any attachment set that attachment’s value inpColorBlendEnables
toTRUE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_STREAM_EXT
dynamic state enabled thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the
geometryStreams
feature is enabled, and a shader object is bound to theSHADER_STAGE_GEOMETRY_BIT
stage, thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXTRA_PRIMITIVE_OVERESTIMATION_SIZE_EXT
dynamic state enabled thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetConservativeRasterizationModeEXT
in the current command buffer setconservativeRasterizationMode
toCONSERVATIVE_RASTERIZATION_MODE_OVERESTIMATE_EXT
, thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipEnable
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
dynamic state enabled thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_sample_locations
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_blend_operation_advanced
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then at least one ofCmdSetColorBlendEquationEXT
andCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_PROVOKING_VERTEX_MODE_EXT
dynamic state enabled thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_provoking_vertex
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
dynamic state enabled thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_EXT
dynamic state enabled thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLineStippleEnableEXT
in the current command buffer setstippledLineEnable
toTRUE
, thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_NEGATIVE_ONE_TO_ONE_EXT
dynamic state enabled thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipControl
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_W_SCALING_ENABLE_NV
dynamic state enabled thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
dynamic state enabled thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_LOCATION_NV
dynamic state enabled thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageToColorEnableNV
in the current command buffer setcoverageToColorEnable
toTRUE
, thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_MODE_NV
dynamic state enabled thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationModeNV
in the current command buffer set coverageModulationMode to any value other thanCOVERAGE_MODULATION_MODE_NONE_NV
, thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationTableEnableNV
in the current command buffer setcoverageModulationTableEnable
toTRUE
, thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SHADING_RATE_IMAGE_ENABLE_NV
dynamic state enabled thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the
pipelineFragmentShadingRate
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer set rasterizerDiscardEnable toFALSE
, thenCmdSetFragmentShadingRateKHR
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_REPRESENTATIVE_FRAGMENT_TEST_ENABLE_NV
dynamic state enabled thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the
representativeFragmentTest
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_REDUCTION_MODE_NV
dynamic state enabled thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the
coverageReductionMode
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
state enabled and the last call toCmdSetColorBlendEnableEXT
setpColorBlendEnables
for any attachment toTRUE
, then for those attachments in the subpass the corresponding image view’s format features must containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and the current subpass does not use any color and/or depth/stencil attachments, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must follow the rules for a zero-attachment subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to theVkPipelineMultisampleStateCreateInfo
::rasterizationSamples
parameter used to create the bound graphics pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to therasterizationSamples
parameter in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and neither theVK_AMD_mixed_attachment_samples
nor theVK_NV_framebuffer_mixed_samples
extensions are enabled, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as the current subpass color and/or depth/stencil attachments - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, or a shader object is bound to any graphics stage, and the current render pass instance includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as therasterizationSamples
member of that structure - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendAdvancedEXT
calls must specify the advanced blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
andDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic states enabled and the last calls toCmdSetColorBlendEnableEXT
andCmdSetColorBlendAdvancedEXT
have enabled advanced blending, then the number of active color attachments in the current subpass must not exceedadvancedBlendMaxColorAttachments
- If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, and the bound graphics pipeline was created withDYNAMIC_STATE_RASTERIZATION_STREAM_EXT
state enabled, the last call toCmdSetRasterizationStreamEXT
must have set therasterizationStream
to zero - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
parameter of the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, andsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.width
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.height
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, the fragment shader code must not statically use the extended instructionInterpolateAtSample
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.width
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.height
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationsPerPixel
must equalrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to any graphics stage or the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
state enabled, and the last call toCmdSetCoverageModulationTableEnableNV
setcoverageModulationTableEnable
toTRUE
, then thecoverageModulationTableCount
parameter in the last call toCmdSetCoverageModulationTableNV
must equal the currentrasterizationSamples
divided by the number of color samples in the current subpass - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if current subpass has a depth/stencil attachment and depth test, stencil test, or depth bounds test are enabled in the currently bound pipeline state, then the currentrasterizationSamples
must be the same as the sample count of the depth/stencil attachment - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
state enabled and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If this
VK_NV_coverage_reduction_mode
extension is enabled, the bound graphics pipeline state was created with theDYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, the current coverage reduction modecoverageReductionMode
, then the currentrasterizationSamples
, and the sample counts for the color and depth/stencil attachments (if the subpass has them) must be a valid combination returned byGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if the current subpass has any color attachments andrasterizationSamples
of the last call toCmdSetRasterizationSamplesEXT
is greater than the number of color samples, then the pipelinesampleShadingEnable
must beFALSE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_EXT
, then thestippledRectangularLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_BRESENHAM_EXT
, then thestippledBresenhamLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT
, then thestippledSmoothLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_DEFAULT_EXT
, then thestippledRectangularLines
feature must be enabled andVkPhysicalDeviceLimits
::strictLines
must beTRUE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled,conservativePointAndLineRasterization
is not supported, and the effective primitive topology output by the last pre-rasterization shader stage is a line or point, then theconservativeRasterizationMode
set by the last call toCmdSetConservativeRasterizationModeEXT
must beCONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT
- If the currently bound pipeline was created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
, then Mesh Shader Queries must not be active - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
dynamic stateCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If dynamic state was inherited from
VkCommandBufferInheritanceViewportScissorInfoNV
, it must be set in the current command buffer prior to this drawing command - If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_VERTEX_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_CONTROL_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_EVALUATION_BIT
- If there is no bound graphics pipeline, and the
geometryShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_GEOMETRY_BIT
- If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_FRAGMENT_BIT
- If there is no bound graphics pipeline, and the
taskShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TASK_BIT_EXT
- If there is no bound graphics pipeline, and the
meshShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_MESH_BIT_EXT
- If there is no bound graphics pipeline, and at least one of the
taskShader
andmeshShader
features is enabled, one of theSHADER_STAGE_VERTEX_BIT
orSHADER_STAGE_MESH_BIT_EXT
stages must have a validVkShaderEXT
bound, and the other must have noVkShaderEXT
bound - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created without theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, a validVkShaderEXT
must be bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created with theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, there must be noVkShaderEXT
bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and a valid
VkShaderEXT
is bound to theSHADER_STAGE_VERTEX_BIT
stage, there must be noVkShaderEXT
bound to either theSHADER_STAGE_TASK_BIT_EXT
stage or theSHADER_STAGE_MESH_BIT_EXT
stage - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, then all shaders created with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag in the sameCreateShadersEXT
call must also be bound - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, any stages in between stages whose shaders which did not create a shader with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag as part of the sameCreateShadersEXT
call must not have anyVkShaderEXT
bound - All bound graphics shader objects must have been created with identical or identically defined push constant ranges
- All bound graphics shader objects must have been created with identical or identically defined arrays of descriptor set layouts
- If the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, and a fragment shader is bound, it must not declare theDepthReplacing
orStencilRefReplacingEXT
execution modes - If the attachmentFeedbackLoopDynamicState feature is enabled on the device, and a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpDepthAttachmentReadEXT
, thedepthWriteEnable
parameter in the last call toCmdSetDepthWriteEnable
must beFALSE
- If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_STENCIL_WRITE_MASK
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpStencilAttachmentReadEXT
, thewriteMask
parameter in the last call toCmdSetStencilWriteMask
must be 0 - If a shader object is bound to any graphics stage or the currently bound graphics pipeline was created with
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
, and the format of any color attachment isFORMAT_E5B9G9R9_UFLOAT_PACK32
, the corresponding element of thepColorWriteMasks
parameter ofCmdSetColorWriteMaskEXT
must either include all ofCOLOR_COMPONENT_R_BIT
,COLOR_COMPONENT_G_BIT
, andCOLOR_COMPONENT_B_BIT
, or none of them - If blending is enabled for any attachment where either the source or destination blend factors for that attachment use the secondary color input, the maximum value of
Location
for any output attachment statically used in theFragment
Execution
Model
executed by this command must be less thanmaxFragmentDualSrcAttachments
- The bound graphics pipeline must not have been created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
- Transform Feedback Queries must not be active
- Primitives Generated Queries must not be active
- The
pipelineStatistics
member used to create any active Pipeline Statistics Query must not containQUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_VERTICES_BIT
,QUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_VERTEX_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_TESSELLATION_CONTROL_SHADER_PATCHES_BIT
, orQUERY_PIPELINE_STATISTIC_TESSELLATION_EVALUATION_SHADER_INVOCATIONS_BIT
- If
buffer
is non-sparse then it must be bound completely and contiguously to a singleVkDeviceMemory
object buffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit setoffset
must be a multiple of 4commandBuffer
must not be a protected command buffer
- If the
multiDrawIndirect
feature is not enabled,drawCount
must be 0 or 1 drawCount
must be less than or equal toVkPhysicalDeviceLimits
::maxDrawIndirectCount
- If
drawCount
is greater than 1,stride
must be a multiple of 4 and must be greater than or equal tosizeof
(VkDrawMeshTasksIndirectCommandNV
) - If
drawCount
is equal to 1,(offset + sizeof(
must be less than or equal to the size ofVkDrawMeshTasksIndirectCommandNV
))buffer
- If
drawCount
is greater than 1,(stride × (drawCount - 1) + offset + sizeof(
must be less than or equal to the size ofVkDrawMeshTasksIndirectCommandNV
))buffer
- The current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshNV
Execution
Model
Valid Usage (Implicit)
commandBuffer
must be a validVkCommandBuffer
handlebuffer
must be a validVkBuffer
handlecommandBuffer
must be in the recording state- The
VkCommandPool
thatcommandBuffer
was allocated from must support graphics operations - This command must only be called inside of a render pass instance
- This command must only be called outside of a video coding scope
- Both of
buffer
, andcommandBuffer
must have been created, allocated, or retrieved from the sameVkDevice
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized - Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized
Command Properties
Command Buffer Levels Render Pass Scope Video Coding Scope Supported Queue Types Command Type Primary Secondary Inside Outside Graphics Action - Parameters:
commandBuffer
- the command buffer into which the command is recorded.buffer
- the buffer containing draw parameters.offset
- the byte offset intobuffer
where parameters begin.drawCount
- the number of draws to execute, and can be zero.stride
- the byte stride between successive sets of draw parameters.
- If a
-
vkCmdDrawMeshTasksIndirectCountNV
public static void vkCmdDrawMeshTasksIndirectCountNV(VkCommandBuffer commandBuffer, long buffer, long offset, long countBuffer, long countBufferOffset, int maxDrawCount, int stride) Perform an indirect mesh tasks draw with the draw count sourced from a buffer.C Specification
To record an indirect mesh tasks drawing command with the draw count sourced from a buffer, call:
void vkCmdDrawMeshTasksIndirectCountNV( VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, VkBuffer countBuffer, VkDeviceSize countBufferOffset, uint32_t maxDrawCount, uint32_t stride);
Description
vkCmdDrawMeshTasksIndirectCountNV
behaves similarly toCmdDrawMeshTasksIndirectNV
except that the draw count is read by the device from a buffer during execution. The command will read an unsigned 32-bit integer fromcountBuffer
located atcountBufferOffset
and use this as the draw count.Valid Usage
- If a
VkSampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkSampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
VkImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
VkImageView
is accessed using atomic operations as a result of this command, then the image view’s format features must containFORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT
- If a
DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER
descriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containFORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT
- If a
VkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT
- If the
VK_EXT_filter_cubic
extension is not enabled and anyVkImageView
is sampled withFILTER_CUBIC_EXT
as a result of this command, it must not have aVkImageViewType
ofIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
, orIMAGE_VIEW_TYPE_CUBE_ARRAY
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aVkImageViewType
and format that supports cubic filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned byGetPhysicalDeviceImageFormatProperties2
- Any
VkImageView
being sampled withFILTER_CUBIC_EXT
with a reduction mode of eitherSAMPLER_REDUCTION_MODE_MIN
orSAMPLER_REDUCTION_MODE_MAX
as a result of this command must have aVkImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byVkFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned byGetPhysicalDeviceImageFormatProperties2
- If the
cubicRangeClamp
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must not have aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
- Any
VkImageView
being sampled with aVkSamplerReductionModeCreateInfo
::reductionMode
equal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM
as a result of this command must sample withFILTER_CUBIC_EXT
- If the
selectableCubicWeights
feature is not enabled, then anyVkImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must haveVkSamplerCubicWeightsCreateInfoQCOM
::cubicWeights
equal toCUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM
- Any
VkImage
created with aVkImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aVkSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
VkImageView
being written as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- For any
VkImageView
being read as a storage image where the image format field of theOpTypeImage
isUnknown
, the view’s format features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For any
VkBufferView
being written as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
, the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
- Any
VkBufferView
being read as a storage texel buffer where the image format field of theOpTypeImage
isUnknown
then the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
- For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a
VkPipelineLayout
that is compatible for set n, with theVkPipelineLayout
orVkDescriptorSetLayout
array that was used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a
VkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - If the
maintenance4
feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with aVkPipelineLayout
that is compatible for push constants, with theVkPipelineLayout
orVkDescriptorSetLayout
andVkPushConstantRange
arrays used to create the currentVkPipeline
orVkShaderEXT
, as described in Pipeline Layout Compatibility - Descriptors in each bound descriptor set, specified via
CmdBindDescriptorSets
, must be valid if they are statically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was not created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdBindDescriptorSets
, the boundVkPipeline
must have been created withoutPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by theVkPipeline
bound to the pipeline bind point used by this command and the boundVkPipeline
was created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- Descriptors in bound descriptor buffers, specified via
CmdSetDescriptorBufferOffsetsEXT
, must be valid if they are dynamically used by anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command - If the descriptors used by the
VkPipeline
bound to the pipeline bind point were specified viaCmdSetDescriptorBufferOffsetsEXT
, the boundVkPipeline
must have been created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
- If a descriptor is dynamically used with a
VkPipeline
created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If a descriptor is dynamically used with a
VkShaderEXT
created with aVkDescriptorSetLayout
that was created withDESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT
, the descriptor memory must be resident - If the
shaderObject
feature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command - If the
shaderObject
is enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid andNULL_HANDLE
shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command - If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the
VkPipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyVkImage
with aVkImageView
of the typeIMAGE_VIEW_TYPE_3D
,IMAGE_VIEW_TYPE_CUBE
,IMAGE_VIEW_TYPE_1D_ARRAY
,IMAGE_VIEW_TYPE_2D_ARRAY
orIMAGE_VIEW_TYPE_CUBE_ARRAY
, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions withImplicitLod
,Dref
orProj
in their name, in any shader stage - If the
VkPipeline
object bound to the pipeline bind point used by this command or anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses aVkSampler
object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions that includes a LOD bias or any offset values, in any shader stage - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
foruniformBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If any stage of the
VkPipeline
object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT
orPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
forstorageBuffers
, and therobustBufferAccess
feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If the
robustBufferAccess
feature is not enabled, and anyVkShaderEXT
bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If
commandBuffer
is an unprotected command buffer andprotectedNoFault
is not supported, any resource accessed by bound shaders must not be a protected resource - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If a bound shader accesses a
VkSampler
orVkImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
VkImageView
is accessed as a result of this command, then the image view’sviewType
must match theDim
operand of theOpTypeImage
as described in textures-operation-validation - If a
VkImageView
is accessed as a result of this command, then the numeric type of the image view’sformat
and theSampled
Type
operand of theOpTypeImage
must match - If a
VkImageView
created with a format other thanFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the image view’s format - If a
VkImageView
created with the formatFORMAT_A8_UNORM_KHR
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have four components - If a
VkBufferView
is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the buffer view’s format - If a
VkImageView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkImageView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If a
VkBufferView
with aVkFormat
that has a 64-bit component width is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 64 - If a
VkBufferView
with aVkFormat
that has a component width less than 64-bit is accessed as a result of this command, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 - If the
sparseImageInt64Atomics
feature is not enabled,VkImage
objects created with theIMAGE_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If the
sparseImageInt64Atomics
feature is not enabled,VkBuffer
objects created with theBUFFER_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command - If
OpImageWeightedSampleQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM
- If
OpImageWeightedSampleQCOM
uses aVkImageView
as a sample weight image as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM
- If
OpImageBoxFilterQCOM
is used to sample aVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM
- If
OpImageBlockMatchSSDQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If
OpImageBlockMatchSADQCOM
or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - If
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If any command other than
OpImageWeightedSampleQCOM
,OpImageBoxFilterQCOM
,OpImageBlockMatchWindowSSDQCOM
,OpImageBlockMatchWindowSADQCOM
,OpImageBlockMatchGatherSSDQCOM
,OpImageBlockMatchGatherSADQCOM
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aVkSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
- If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
instruction is used to read from anVkImageView
as a result of this command, then the image view’s format must be a single-component format. - If a
OpImageBlockMatchWindow*QCOM
orOpImageBlockMatchGather*QCOM
read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - Any shader invocation executed by this command must terminate
- The current render pass must be compatible with the
renderPass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass index of the current render pass must be equal to the
subpass
member of theVkGraphicsPipelineCreateInfo
structure specified when creating theVkPipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- If any shader statically accesses an input attachment, a valid descriptor must be bound to the pipeline via a descriptor set
- If any shader executed by this pipeline accesses an
OpTypeImage
variable with aDim
operand ofSubpassData
, it must be decorated with anInputAttachmentIndex
that corresponds to a valid input attachment in the current subpass - Input attachment views accessed in a subpass must be created with the same
VkFormat
as the corresponding subpass definition, and be created with aVkImageView
that is compatible with the attachment referenced by the subpass'pInputAttachments
[InputAttachmentIndex
] in the currently boundVkFramebuffer
as specified by Fragment Input Attachment Compatibility - Memory backing image subresources used as attachments in the current render pass must not be written in any way other than as an attachment by this command
- If a color attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_COLOR_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_COLOR_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a depth attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_DEPTH_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If a stencil attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
image layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT
is set on the currently bound pipeline or - the last call to
CmdSetAttachmentFeedbackLoopEnableEXT
includedIMAGE_ASPECT_STENCIL_BIT
and- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
it must not be accessed in any way other than as an attachment by this command
- the
- If an attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it must not be accessed in any way other than as an attachment, storage image, or sampled image by this command
- If any previously recorded command in the current subpass accessed an image subresource used as an attachment in this subpass in any way other than as an attachment, this command must not write to that image subresource as an attachment
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, depth writes must be disabled
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect, both front and back
writeMask
are not zero, and stencil test is enabled, all stencil ops must beSTENCIL_OP_KEEP
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT
dynamic state enabled thenCmdSetViewport
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR
dynamic state enabled thenCmdSetScissor
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_WIDTH
dynamic state enabled thenCmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If a shader object that outputs line primitives is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
,CmdSetLineWidth
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS
dynamic state enabled thenCmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBiasEnable
in the current command buffer setdepthBiasEnable
toTRUE
,CmdSetDepthBias
orCmdSetDepthBias2EXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_BLEND_CONSTANTS
dynamic state enabled thenCmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
in the current command buffer set any element ofpColorBlendEnables
toTRUE
, and the most recent call toCmdSetColorBlendEquationEXT
in the current command buffer set the same element ofpColorBlendEquations
to aVkColorBlendEquationEXT
structure with anyVkBlendFactor
member with a value ofBLEND_FACTOR_CONSTANT_COLOR
,BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR
,BLEND_FACTOR_CONSTANT_ALPHA
, orBLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA
,CmdSetBlendConstants
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS
dynamic state enabled, and if the currentdepthBoundsTestEnable
state isTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthBoundsTestEnable
in the current command buffer setdepthBoundsTestEnable
toTRUE
, thenCmdSetDepthBounds
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_COMPARE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilCompareMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_WRITE_MASK
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilWriteMask
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_REFERENCE
dynamic state enabled, and if the currentstencilTestEnable
state isTRUE
, thenCmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
,CmdSetStencilReference
must have been called in the current command buffer prior to this drawing command - If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index must be less than or equal to
VkPhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
- If the bound graphics pipeline was created with
VkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
set toTRUE
and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
dynamic state enabled thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetSampleLocationsEnableEXT
in the current command buffer setsampleLocationsEnable
toTRUE
, thenCmdSetSampleLocationsEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CULL_MODE
dynamic state enabled thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCullMode
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_FRONT_FACE
dynamic state enabled thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetFrontFace
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_TEST_ENABLE
dynamic state enabled thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
dynamic state enabled thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthWriteEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_COMPARE_OP
dynamic state enabled thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDepthTestEnable
in the current command buffer setdepthTestEnable
toTRUE
, thenCmdSetDepthCompareOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE
dynamic state enabled thenCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the
depthBounds
feature is enabled, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theCmdSetDepthBoundsTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_TEST_ENABLE
dynamic state enabled thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetStencilTestEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_OP
dynamic state enabled thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetStencilTestEnable
in the current command buffer setstencilTestEnable
toTRUE
, thenCmdSetStencilOp
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match theVkPipelineViewportStateCreateInfo
::scissorCount
of the pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, thenCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and thescissorCount
parameter ofvkCmdSetScissorWithCount
must match theVkPipelineViewportStateCreateInfo
::viewportCount
of the pipeline - If the bound graphics pipeline state was created with both the
DYNAMIC_STATE_SCISSOR_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic states enabled then bothCmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If a shader object is bound to any graphics stage, then both
CmdSetViewportWithCount
andCmdSetScissorWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must match thescissorCount
parameter ofvkCmdSetScissorWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportWScalingStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_W_SCALING_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, thenCmdSetViewportWScalingNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetViewportWScalingEnableNV
in the current command buffer setviewportWScalingEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportWScalingNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportShadingRateImageStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoarseSampleOrderNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, thenCmdSetViewportShadingRatePaletteNV
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetShadingRateImageEnableNV
in the current command buffer setshadingRateImageEnable
toTRUE
, then theviewportCount
parameter in the last call toCmdSetViewportShadingRatePaletteNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportSwizzleStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aVkPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromVkPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withVkPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NV
dynamic state enabled thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV
dynamic state enabled thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetExclusiveScissorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetExclusiveScissorEnableNV
in the current command buffer set any element ofpExclusiveScissorEnables
toTRUE
, thenCmdSetExclusiveScissorNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE
dynamic state enabled thenCmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, then
CmdSetRasterizerDiscardEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BIAS_ENABLE
dynamic state enabled thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthBiasEnable
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_EXT
dynamic state enabled thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLogicOpEnableEXT
setlogicOpEnable
toTRUE
, thenCmdSetLogicOpEXT
must have been called in the current command buffer prior to this drawing command and thelogicOp
must be a validVkLogicOp
value - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with theDYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, and any shader object bound to a graphics stage writes to thePrimitiveShadingRateKHR
built-in, thenCmdSetViewportWithCount
must have been called in the current command buffer prior to this drawing command, and theviewportCount
parameter ofvkCmdSetViewportWithCount
must be 1 - If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s format features do not contain
FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then theblendEnable
member of the corresponding element of thepAttachments
member ofpColorBlendState
must beFALSE
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then for each color attachment in the render pass, if the corresponding image view’s format features do not containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
, then the corresponding member ofpColorBlendEnables
in the most recent call tovkCmdSetColorBlendEnableEXT
in the current command buffer that affected that attachment index must have beenFALSE
- If rasterization is not disabled in the bound graphics pipeline, and none of the
VK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, thenrasterizationSamples
for the currently bound graphics pipeline must be the same as the current subpass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and none of theVK_AMD_mixed_attachment_samples
extension, theVK_NV_framebuffer_mixed_samples
extension, or themultisampledRenderToSingleSampled
feature is enabled, then the most recent call toCmdSetRasterizationSamplesEXT
in the current command buffer must have setrasterizationSamples
to be the same as the number of samples for the current render pass color and/or depth/stencil attachments - If a shader object is bound to any graphics stage, the current render pass instance must have been begun with
CmdBeginRendering
- If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpDepthAttachment
is notNULL_HANDLE
, and thelayout
member ofpDepthAttachment
isIMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
, this command must not write any values to the depth attachment - If the current render pass instance was begun with
CmdBeginRendering
, theimageView
member ofpStencilAttachment
is notNULL_HANDLE
, and thelayout
member ofpStencilAttachment
isIMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
, this command must not write any values to the stencil attachment - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::viewMask
equal toVkRenderingInfo
::viewMask
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound graphics pipeline must have been created with aVkPipelineRenderingCreateInfo
::colorAttachmentCount
equal toVkRenderingInfo
::colorAttachmentCount
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - If the
dynamicRenderingUnusedAttachments
feature is enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aVkFormat
equal to the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline, or the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
, if it exists, must beFORMAT_UNDEFINED
- If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
andVkRenderingInfo
::colorAttachmentCount
greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
equal toNULL_HANDLE
must have the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound pipeline equal toFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, with aVkRenderingInfo
::colorAttachmentCount
equal to 1, there is no shader object bound to any graphics stage, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aresolveImageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If there is no shader object bound to any graphics stage, the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with an image created with aVkExternalFormatANDROID
::externalFormat
value equal to theVkExternalFormatANDROID
::externalFormat
value used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled, thenCmdSetColorBlendEnableEXT
must have set the blend enable toFALSE
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetColorBlendEnableEXT
must have set blend enable toFALSE
prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetRasterizationSamplesEXT
must have setrasterizationSamples
toSAMPLE_COUNT_1_BIT
prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroVkExternalFormatANDROID
::externalFormat
value and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR
dynamic state enabled, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→width
to 1 prior to this drawing command - If there is a shader object bound to any graphics stage, and the current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
resolve mode, thenCmdSetFragmentShadingRateKHR
must have setpFragmentSize→height
to 1 prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT
dynamic state enabled then theattachmentCount
parameter ofvkCmdSetColorWriteEnableEXT
must be greater than or equal to theVkPipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then theattachmentCount
parameter of most recent call tovkCmdSetColorWriteEnableEXT
in the current command buffer must be greater than or equal to the number of color attachments in the current render pass instance - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command for each discard rectangle inVkPipelineDiscardRectangleStateCreateInfoEXT
::discardRectangleCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXT
dynamic state enabled thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDiscardRectangleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXT
dynamic state enabled thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectangles
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetDiscardRectangleEnableEXT
in the current command buffer setdiscardRectangleEnable
toTRUE
, thenCmdSetDiscardRectangleModeEXT
must have been called in the current command buffer prior to this drawing command - If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pDepthAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
wasNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED
- If current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, thedynamicRenderingUnusedAttachments
feature is enabled,VkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, and the value ofVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline was not equal to theVkFormat
used to createVkRenderingInfo
::pStencilAttachment→imageView
, the value of the format must beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentShadingRateAttachmentInfoKHR
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
- If the current render pass instance was begun with
CmdBeginRendering
andVkRenderingFragmentDensityMapAttachmentInfoEXT
::imageView
was notNULL_HANDLE
, the currently bound graphics pipeline must have been created withPIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
- If the currently bound pipeline was created with a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created with aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If the currently bound pipeline was created without a
VkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, and the current render pass instance was begun withCmdBeginRendering
with aVkRenderingInfo
::colorAttachmentCount
parameter greater than 0, then each element of theVkRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofrasterizationSamples
for the currently bound graphics pipeline - If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pDepthAttachment→imageView
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline was created without aVkAttachmentSampleCountInfoAMD
orVkAttachmentSampleCountInfoNV
structure, and themultisampledRenderToSingleSampled
feature is not enabled, andVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal to the sample count used to createVkRenderingInfo
::pStencilAttachment→imageView
- If this command has been called inside a render pass instance started with
CmdBeginRendering
, and thepNext
chain ofVkRenderingInfo
includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then the value ofrasterizationSamples
for the currently bound graphics pipeline must be equal toVkMultisampledRenderToSingleSampledInfoEXT
::rasterizationSamples
- If the current render pass instance was begun with
CmdBeginRendering
, the currently bound pipeline must have been created with aVkGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound with a fragment shader that statically writes to a color attachment, the color write mask is not zero, color writes are enabled, and the corresponding element of theVkRenderingInfo
::pColorAttachments→imageView
was notNULL_HANDLE
, then the corresponding element ofVkPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, depth test is enabled, depth write is enabled, and theVkRenderingInfo
::pDepthAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the current render pass instance was begun with
CmdBeginRendering
, there is a graphics pipeline bound, stencil test is enabled and theVkRenderingInfo
::pStencilAttachment→imageView
was notNULL_HANDLE
, then theVkPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the pipeline must not beFORMAT_UNDEFINED
- If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled - If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inVkPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_TESSELLATION_DOMAIN_ORIGIN_EXT
dynamic state enabled thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BIT
stage, thenCmdSetTessellationDomainOriginEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClamp
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetDepthClampEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_POLYGON_MODE_EXT
dynamic state enabled thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetPolygonModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
dynamic state enabled thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRasterizationSamplesEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
dynamic state enabled thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXT
dynamic state enabled, andalphaToCoverageEnable
wasTRUE
in the last call toCmdSetAlphaToCoverageEnableEXT
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToCoverageEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to any graphics stage, and the most recent call to
CmdSetAlphaToCoverageEnableEXT
in the current command buffer setalphaToCoverageEnable
toTRUE
, then the Fragment Output Interface must contain a variable for the alphaComponent
word inLocation
0 atIndex
0 - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_ONE_ENABLE_EXT
dynamic state enabled thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
alphaToOne
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAlphaToOneEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_ENABLE_EXT
dynamic state enabled thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
logicOp
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLogicOpEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetColorBlendEnableEXT
for any attachment set that attachment’s value inpColorBlendEnables
toTRUE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_STREAM_EXT
dynamic state enabled thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the
geometryStreams
feature is enabled, and a shader object is bound to theSHADER_STAGE_GEOMETRY_BIT
stage, thenCmdSetRasterizationStreamEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetConservativeRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_EXTRA_PRIMITIVE_OVERESTIMATION_SIZE_EXT
dynamic state enabled thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetConservativeRasterizationModeEXT
in the current command buffer setconservativeRasterizationMode
toCONSERVATIVE_RASTERIZATION_MODE_OVERESTIMATE_EXT
, thenCmdSetExtraPrimitiveOverestimationSizeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXT
dynamic state enabled thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipEnable
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
dynamic state enabled thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_sample_locations
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetSampleLocationsEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_blend_operation_advanced
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, then at least one ofCmdSetColorBlendEquationEXT
andCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_PROVOKING_VERTEX_MODE_EXT
dynamic state enabled thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_provoking_vertex
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetProvokingVertexModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic state enabled thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineRasterizationModeEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
dynamic state enabled thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPolygonModeEXT
in the current command buffer setpolygonMode
toPOLYGON_MODE_LINE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetPrimitiveTopology
in the current command buffer setprimitiveTopology
to any line topology, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetLineStippleEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_EXT
dynamic state enabled thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterization
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetLineStippleEnableEXT
in the current command buffer setstippledLineEnable
toTRUE
, thenCmdSetLineStippleEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_NEGATIVE_ONE_TO_ONE_EXT
dynamic state enabled thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the
depthClipControl
feature is enabled, and a shader object is bound to any graphics stage, thenCmdSetDepthClipNegativeOneToOneEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_W_SCALING_ENABLE_NV
dynamic state enabled thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scaling
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportWScalingEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, thenCmdSetViewportSwizzleNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
dynamic state enabled thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageToColorEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_LOCATION_NV
dynamic state enabled thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageToColorEnableNV
in the current command buffer setcoverageToColorEnable
toTRUE
, thenCmdSetCoverageToColorLocationNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_MODE_NV
dynamic state enabled thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageModulationModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationModeNV
in the current command buffer set coverageModulationMode to any value other thanCOVERAGE_MODULATION_MODE_NONE_NV
, thenCmdSetCoverageModulationTableEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NV
dynamic state enabled thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the most recent call toCmdSetCoverageModulationTableEnableNV
in the current command buffer setcoverageModulationTableEnable
toTRUE
, thenCmdSetCoverageModulationTableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SHADING_RATE_IMAGE_ENABLE_NV
dynamic state enabled thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the
pipelineFragmentShadingRate
feature is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer set rasterizerDiscardEnable toFALSE
, thenCmdSetFragmentShadingRateKHR
must have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetShadingRateImageEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_REPRESENTATIVE_FRAGMENT_TEST_ENABLE_NV
dynamic state enabled thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the
representativeFragmentTest
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetRepresentativeFragmentTestEnableNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_REDUCTION_MODE_NV
dynamic state enabled thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the
coverageReductionMode
feature is enabled, and a shader object is bound to any graphics stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetCoverageReductionModeNV
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
state enabled and the last call toCmdSetColorBlendEnableEXT
setpColorBlendEnables
for any attachment toTRUE
, then for those attachments in the subpass the corresponding image view’s format features must containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and the current subpass does not use any color and/or depth/stencil attachments, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must follow the rules for a zero-attachment subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to theVkPipelineMultisampleStateCreateInfo
::rasterizationSamples
parameter used to create the bound graphics pipeline - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXT
state andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, then thesamples
parameter in the last call toCmdSetSampleMaskEXT
must be greater or equal to therasterizationSamples
parameter in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, and neither theVK_AMD_mixed_attachment_samples
nor theVK_NV_framebuffer_mixed_samples
extensions are enabled, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as the current subpass color and/or depth/stencil attachments - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, or a shader object is bound to any graphics stage, and the current render pass instance includes aVkMultisampledRenderToSingleSampledInfoEXT
structure withmultisampledRenderToSingleSampledEnable
equal toTRUE
, then therasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
must be the same as therasterizationSamples
member of that structure - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic state enabled thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEnableEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEnableEXT
calls must specify an enable for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT
dynamic state enabled thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorBlendEquationEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendEquationEXT
calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
dynamic state enabled thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetColorWriteMaskEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorWriteMaskEXT
calls must specify the color write mask for all active color attachments in the current subpass - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
dynamic state enabled thenCmdSetColorBlendAdvancedEXT
must have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachment
andattachmentCount
parameters ofvkCmdSetColorBlendAdvancedEXT
calls must specify the advanced blend equations for all active color attachments in the current subpass where blending is enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT
andDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT
dynamic states enabled and the last calls toCmdSetColorBlendEnableEXT
andCmdSetColorBlendAdvancedEXT
have enabled advanced blending, then the number of active color attachments in the current subpass must not exceedadvancedBlendMaxColorAttachments
- If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and theQUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, and the bound graphics pipeline was created withDYNAMIC_STATE_RASTERIZATION_STREAM_EXT
state enabled, the last call toCmdSetRasterizationStreamEXT
must have set therasterizationStream
to zero - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state disabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
member of theVkPipelineMultisampleStateCreateInfo
structure the bound graphics pipeline has been created with - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, then thesampleLocationsPerPixel
member ofpSampleLocationsInfo
in the last call toCmdSetSampleLocationsEXT
must equal therasterizationSamples
parameter of the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, andsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, and the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT
bit set - If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.width
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, then thesampleLocationsInfo.sampleLocationGridSize.height
in the last call toCmdSetSampleLocationsEXT
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, and ifsampleLocationsEnable
wasTRUE
in the last call toCmdSetSampleLocationsEnableEXT
, the fragment shader code must not statically use the extended instructionInterpolateAtSample
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.width
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationGridSize.height
must evenly divideVkMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned byGetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equaling the value ofrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT
state disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
state enabled, thesampleLocationsEnable
member of aVkPipelineSampleLocationsStateCreateInfoEXT
::sampleLocationsEnable
in the bound graphics pipeline isTRUE
orDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT
state enabled, then,sampleLocationsInfo.sampleLocationsPerPixel
must equalrasterizationSamples
in the last call toCmdSetRasterizationSamplesEXT
- If a shader object is bound to any graphics stage or the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV
state enabled, and the last call toCmdSetCoverageModulationTableEnableNV
setcoverageModulationTableEnable
toTRUE
, then thecoverageModulationTableCount
parameter in the last call toCmdSetCoverageModulationTableNV
must equal the currentrasterizationSamples
divided by the number of color samples in the current subpass - If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if current subpass has a depth/stencil attachment and depth test, stencil test, or depth bounds test are enabled in the currently bound pipeline state, then the currentrasterizationSamples
must be the same as the sample count of the depth/stencil attachment - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
state enabled and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If the
VK_NV_fragment_coverage_to_color
extension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, and the last call toCmdSetCoverageToColorEnableNV
set thecoverageToColorEnable
toTRUE
, then the current subpass must have a color attachment at the location selected by the last call toCmdSetCoverageToColorLocationNV
coverageToColorLocation
, with aVkFormat
ofFORMAT_R8_UINT
,FORMAT_R8_SINT
,FORMAT_R16_UINT
,FORMAT_R16_SINT
,FORMAT_R32_UINT
, orFORMAT_R32_SINT
- If this
VK_NV_coverage_reduction_mode
extension is enabled, the bound graphics pipeline state was created with theDYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV
andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT
states enabled, the current coverage reduction modecoverageReductionMode
, then the currentrasterizationSamples
, and the sample counts for the color and depth/stencil attachments (if the subpass has them) must be a valid combination returned byGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic state enabled, then the bound graphics pipeline must have been created withVkPipelineViewportSwizzleStateCreateInfoNV
::viewportCount
greater or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
andDYNAMIC_STATE_VIEWPORT_SWIZZLE_NV
dynamic states enabled then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_viewport_swizzle
extension is enabled, and a shader object is bound to any graphics stage, then theviewportCount
parameter in the last call toCmdSetViewportSwizzleNV
must be greater than or equal to theviewportCount
parameter in the last call toCmdSetViewportWithCount
- If the
VK_NV_framebuffer_mixed_samples
extension is enabled, and if the current subpass has any color attachments andrasterizationSamples
of the last call toCmdSetRasterizationSamplesEXT
is greater than the number of color samples, then the pipelinesampleShadingEnable
must beFALSE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_EXT
, then thestippledRectangularLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_BRESENHAM_EXT
, then thestippledBresenhamLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT
, then thestippledSmoothLines
feature must be enabled - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT
orDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT
dynamic states enabled, and if the currentstippledLineEnable
state isTRUE
and the currentlineRasterizationMode
state isLINE_RASTERIZATION_MODE_DEFAULT_EXT
, then thestippledRectangularLines
feature must be enabled andVkPhysicalDeviceLimits
::strictLines
must beTRUE
- If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT
dynamic state enabled,conservativePointAndLineRasterization
is not supported, and the effective primitive topology output by the last pre-rasterization shader stage is a line or point, then theconservativeRasterizationMode
set by the last call toCmdSetConservativeRasterizationModeEXT
must beCONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT
- If the currently bound pipeline was created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
, then Mesh Shader Queries must not be active - If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT
dynamic stateCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If dynamic state was inherited from
VkCommandBufferInheritanceViewportScissorInfoNV
, it must be set in the current command buffer prior to this drawing command - If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_VERTEX_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_CONTROL_BIT
- If there is no bound graphics pipeline, and the
tessellationShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TESSELLATION_EVALUATION_BIT
- If there is no bound graphics pipeline, and the
geometryShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_GEOMETRY_BIT
- If there is no bound graphics pipeline,
vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_FRAGMENT_BIT
- If there is no bound graphics pipeline, and the
taskShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_TASK_BIT_EXT
- If there is no bound graphics pipeline, and the
meshShader
feature is enabled,vkCmdBindShadersEXT
must have been called in the current command buffer withpStages
with an element ofSHADER_STAGE_MESH_BIT_EXT
- If there is no bound graphics pipeline, and at least one of the
taskShader
andmeshShader
features is enabled, one of theSHADER_STAGE_VERTEX_BIT
orSHADER_STAGE_MESH_BIT_EXT
stages must have a validVkShaderEXT
bound, and the other must have noVkShaderEXT
bound - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created without theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, a validVkShaderEXT
must be bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and both the
taskShader
andmeshShader
features are enabled, and a validVkShaderEXT
is bound the to theSHADER_STAGE_MESH_BIT_EXT
stage, and thatVkShaderEXT
was created with theSHADER_CREATE_NO_TASK_SHADER_BIT_EXT
flag, there must be noVkShaderEXT
bound to theSHADER_STAGE_TASK_BIT_EXT
stage - If there is no bound graphics pipeline, and a valid
VkShaderEXT
is bound to theSHADER_STAGE_VERTEX_BIT
stage, there must be noVkShaderEXT
bound to either theSHADER_STAGE_TASK_BIT_EXT
stage or theSHADER_STAGE_MESH_BIT_EXT
stage - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, then all shaders created with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag in the sameCreateShadersEXT
call must also be bound - If any graphics shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXT
flag, any stages in between stages whose shaders which did not create a shader with theSHADER_CREATE_LINK_STAGE_BIT_EXT
flag as part of the sameCreateShadersEXT
call must not have anyVkShaderEXT
bound - All bound graphics shader objects must have been created with identical or identically defined push constant ranges
- All bound graphics shader objects must have been created with identical or identically defined arrays of descriptor set layouts
- If the current render pass instance was begun with
CmdBeginRendering
and aVkRenderingInfo
::colorAttachmentCount
equal to 1, a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID
, and a fragment shader is bound, it must not declare theDepthReplacing
orStencilRefReplacingEXT
execution modes - If the attachmentFeedbackLoopDynamicState feature is enabled on the device, and a shader object is bound to the
SHADER_STAGE_FRAGMENT_BIT
stage, and the most recent call toCmdSetRasterizerDiscardEnable
in the current command buffer setrasterizerDiscardEnable
toFALSE
, thenCmdSetAttachmentFeedbackLoopEnableEXT
must have been called in the current command buffer prior to this drawing command - If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_DEPTH_WRITE_ENABLE
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpDepthAttachmentReadEXT
, thedepthWriteEnable
parameter in the last call toCmdSetDepthWriteEnable
must beFALSE
- If the bound graphics pipeline state includes a fragment shader stage, was created with
DYNAMIC_STATE_STENCIL_WRITE_MASK
set inVkPipelineDynamicStateCreateInfo
::pDynamicStates
, and the fragment shader declares theEarlyFragmentTests
execution mode and usesOpStencilAttachmentReadEXT
, thewriteMask
parameter in the last call toCmdSetStencilWriteMask
must be 0 - If a shader object is bound to any graphics stage or the currently bound graphics pipeline was created with
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT
, and the format of any color attachment isFORMAT_E5B9G9R9_UFLOAT_PACK32
, the corresponding element of thepColorWriteMasks
parameter ofCmdSetColorWriteMaskEXT
must either include all ofCOLOR_COMPONENT_R_BIT
,COLOR_COMPONENT_G_BIT
, andCOLOR_COMPONENT_B_BIT
, or none of them - If blending is enabled for any attachment where either the source or destination blend factors for that attachment use the secondary color input, the maximum value of
Location
for any output attachment statically used in theFragment
Execution
Model
executed by this command must be less thanmaxFragmentDualSrcAttachments
- The bound graphics pipeline must not have been created with the
VkPipelineShaderStageCreateInfo
::stage
member of an element ofVkGraphicsPipelineCreateInfo
::pStages
set toSHADER_STAGE_VERTEX_BIT
,SHADER_STAGE_TESSELLATION_CONTROL_BIT
,SHADER_STAGE_TESSELLATION_EVALUATION_BIT
orSHADER_STAGE_GEOMETRY_BIT
- Transform Feedback Queries must not be active
- Primitives Generated Queries must not be active
- The
pipelineStatistics
member used to create any active Pipeline Statistics Query must not containQUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_VERTICES_BIT
,QUERY_PIPELINE_STATISTIC_INPUT_ASSEMBLY_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_VERTEX_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_GEOMETRY_SHADER_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_INVOCATIONS_BIT
,QUERY_PIPELINE_STATISTIC_CLIPPING_PRIMITIVES_BIT
,QUERY_PIPELINE_STATISTIC_TESSELLATION_CONTROL_SHADER_PATCHES_BIT
, orQUERY_PIPELINE_STATISTIC_TESSELLATION_EVALUATION_SHADER_INVOCATIONS_BIT
- If
buffer
is non-sparse then it must be bound completely and contiguously to a singleVkDeviceMemory
object buffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit setoffset
must be a multiple of 4commandBuffer
must not be a protected command buffer
- If
countBuffer
is non-sparse then it must be bound completely and contiguously to a singleVkDeviceMemory
object countBuffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit setcountBufferOffset
must be a multiple of 4- The count stored in
countBuffer
must be less than or equal toVkPhysicalDeviceLimits
::maxDrawIndirectCount
(countBufferOffset + sizeof(uint32_t))
must be less than or equal to the size ofcountBuffer
- If
drawIndirectCount
is not enabled this function must not be used stride
must be a multiple of 4 and must be greater than or equal tosizeof
(VkDrawMeshTasksIndirectCommandNV
)- If
maxDrawCount
is greater than or equal to 1,(stride × (maxDrawCount - 1) + offset + sizeof(
must be less than or equal to the size ofVkDrawMeshTasksIndirectCommandNV
))buffer
- If the count stored in
countBuffer
is equal to 1,(offset + sizeof(
must be less than or equal to the size ofVkDrawMeshTasksIndirectCommandNV
))buffer
- If the count stored in
countBuffer
is greater than 1,(stride × (drawCount - 1) + offset + sizeof(
must be less than or equal to the size ofVkDrawMeshTasksIndirectCommandNV
))buffer
- The current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshNV
Execution
Model
Valid Usage (Implicit)
commandBuffer
must be a validVkCommandBuffer
handlebuffer
must be a validVkBuffer
handlecountBuffer
must be a validVkBuffer
handlecommandBuffer
must be in the recording state- The
VkCommandPool
thatcommandBuffer
was allocated from must support graphics operations - This command must only be called inside of a render pass instance
- This command must only be called outside of a video coding scope
- Each of
buffer
,commandBuffer
, andcountBuffer
must have been created, allocated, or retrieved from the sameVkDevice
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized - Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized
Command Properties
Command Buffer Levels Render Pass Scope Video Coding Scope Supported Queue Types Command Type Primary Secondary Inside Outside Graphics Action - Parameters:
commandBuffer
- the command buffer into which the command is recorded.buffer
- the buffer containing draw parameters.offset
- the byte offset intobuffer
where parameters begin.countBuffer
- the buffer containing the draw count.countBufferOffset
- the byte offset intocountBuffer
where the draw count begins.maxDrawCount
- specifies the maximum number of draws that will be executed. The actual number of executed draw calls is the minimum of the count specified incountBuffer
andmaxDrawCount
.stride
- the byte stride between successive sets of draw parameters.
- If a
-