Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
Name
VK_EXT_mesh_shader - device extension
VK_EXT_mesh_shader
- Name String
VK_EXT_mesh_shader
- Extension Type
- Device extension
- Registered Extension Number
- 329
- Revision
- 1
- Extension and Version Dependencies
- Requires support for Vulkan 1.0
- Requires
VK_KHR_get_physical_device_properties2
to be enabled for any device-level functionality - Requires
VK_KHR_spirv_1_4
to be enabled for any device-level functionality
- Contact
- Extension Proposal
- VK_EXT_mesh_shader
Other Extension Metadata
- Last Modified Date
- 2022-01-20
- Interactions and External Dependencies
- This extension requires SPV_EXT_mesh_shader
- This extension provides API support for GLSL_EXT_mesh_shader
- Interacts with Vulkan 1.1
- Interacts with
VK_KHR_multiview
- Interacts with
VK_KHR_fragment_shading_rate
- Contributors
- Christoph Kubisch, NVIDIA
- Pat Brown, NVIDIA
- Jeff Bolz, NVIDIA
- Daniel Koch, NVIDIA
- Piers Daniell, NVIDIA
- Pierre Boudier, NVIDIA
- Patrick Mours, NVIDIA
- David Zhao Akeley, NVIDIA
- Kedarnath Thangudu, NVIDIA
- Timur Kristóf, Valve
- Hans-Kristian Arntzen, Valve
- Philip Rebohle, Valve
- Mike Blumenkrantz, Valve
- Slawomir Grajewski, Intel
- Michal Pietrasiuk, Intel
- Mariusz Merecki, Intel
- Tom Olson, ARM
- Jan-Harald Fredriksen, ARM
- Sandeep Kakarlapudi, ARM
- Ruihao Zhang, QUALCOMM
- Ricardo Garcia, Igalia, S.L.
- Tobias Hector, AMD
- Stu Smith, AMD
Description
This extension provides a new mechanism allowing applications to generate collections of geometric primitives via programmable mesh shading. It is an alternative to the existing programmable primitive shading pipeline, which relied on generating input primitives by a fixed function assembler as well as fixed function vertex fetch.
This extension also adds support for the following SPIR-V extension in Vulkan:
New Commands
New Structures
Extending
PhysicalDeviceFeatures2
,DeviceCreateInfo
:Extending
PhysicalDeviceProperties2
:
New Enum Constants
EXT_MESH_SHADER_SPEC_VERSION
Extending
PipelineStageFlagBits
:Extending
QueryPipelineStatisticFlagBits
:Extending
QueryType
:Extending
ShaderStageFlagBits
:Extending
StructureType
:
If VK_NV_device_generated_commands is supported:
New or Modified Built-In Variables
- PrimitivePointIndicesEXT
- PrimitiveLineIndicesEXT
- PrimitiveTriangleIndicesEXT
- (modified)
Position
- (modified)
PointSize
- (modified)
ClipDistance
- (modified)
CullDistance
- (modified)
PrimitiveId
- (modified)
Layer
- (modified)
ViewportIndex
- (modified)
NumWorkgroups
- (modified)
WorkgroupSize
- (modified)
WorkgroupId
- (modified)
LocalInvocationId
- (modified)
GlobalInvocationId
- (modified)
LocalInvocationIndex
- (modified)
NumSubgroups
- (modified)
SubgroupId
- (modified)
DrawIndex
- (modified)
PrimitiveShadingRateKHR
- (modified)
ViewIndex
New SPIR-V Capability
Version History
Revision 1, 2022-03-08 (Christoph Kubisch, Daniel Koch, Patrick Mours)
- Initial revision
See Also
DrawMeshTasksIndirectCommandEXT
,
PhysicalDeviceMeshShaderFeaturesEXT
,
PhysicalDeviceMeshShaderPropertiesEXT
, cmdDrawMeshTasksEXT
,
cmdDrawMeshTasksIndirectCountEXT
, cmdDrawMeshTasksIndirectEXT
Document Notes
For more information, see the Vulkan Specification
This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.
Synopsis
- cmdDrawMeshTasksEXT :: forall io. MonadIO io => CommandBuffer -> ("groupCountX" ::: Word32) -> ("groupCountY" ::: Word32) -> ("groupCountZ" ::: Word32) -> io ()
- cmdDrawMeshTasksIndirectEXT :: forall io. MonadIO io => CommandBuffer -> Buffer -> ("offset" ::: DeviceSize) -> ("drawCount" ::: Word32) -> ("stride" ::: Word32) -> io ()
- cmdDrawMeshTasksIndirectCountEXT :: forall io. MonadIO io => CommandBuffer -> Buffer -> ("offset" ::: DeviceSize) -> ("countBuffer" ::: Buffer) -> ("countBufferOffset" ::: DeviceSize) -> ("maxDrawCount" ::: Word32) -> ("stride" ::: Word32) -> io ()
- data PhysicalDeviceMeshShaderFeaturesEXT = PhysicalDeviceMeshShaderFeaturesEXT {}
- data PhysicalDeviceMeshShaderPropertiesEXT = PhysicalDeviceMeshShaderPropertiesEXT {
- maxTaskWorkGroupTotalCount :: Word32
- maxTaskWorkGroupCount :: (Word32, Word32, Word32)
- maxTaskWorkGroupInvocations :: Word32
- maxTaskWorkGroupSize :: (Word32, Word32, Word32)
- maxTaskPayloadSize :: Word32
- maxTaskSharedMemorySize :: Word32
- maxTaskPayloadAndSharedMemorySize :: Word32
- maxMeshWorkGroupTotalCount :: Word32
- maxMeshWorkGroupCount :: (Word32, Word32, Word32)
- maxMeshWorkGroupInvocations :: Word32
- maxMeshWorkGroupSize :: (Word32, Word32, Word32)
- maxMeshSharedMemorySize :: Word32
- maxMeshPayloadAndSharedMemorySize :: Word32
- maxMeshOutputMemorySize :: Word32
- maxMeshPayloadAndOutputMemorySize :: Word32
- maxMeshOutputComponents :: Word32
- maxMeshOutputVertices :: Word32
- maxMeshOutputPrimitives :: Word32
- maxMeshOutputLayers :: Word32
- maxMeshMultiviewViewCount :: Word32
- meshOutputPerVertexGranularity :: Word32
- meshOutputPerPrimitiveGranularity :: Word32
- maxPreferredTaskWorkGroupInvocations :: Word32
- maxPreferredMeshWorkGroupInvocations :: Word32
- prefersLocalInvocationVertexOutput :: Bool
- prefersLocalInvocationPrimitiveOutput :: Bool
- prefersCompactVertexOutput :: Bool
- prefersCompactPrimitiveOutput :: Bool
- data DrawMeshTasksIndirectCommandEXT = DrawMeshTasksIndirectCommandEXT {}
- type EXT_MESH_SHADER_SPEC_VERSION = 1
- pattern EXT_MESH_SHADER_SPEC_VERSION :: forall a. Integral a => a
- type EXT_MESH_SHADER_EXTENSION_NAME = "VK_EXT_mesh_shader"
- pattern EXT_MESH_SHADER_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
- newtype IndirectCommandsTokenTypeNV where
- IndirectCommandsTokenTypeNV Int32
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_STATE_FLAGS_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_INDEX_BUFFER_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_VERTEX_BUFFER_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_INDEXED_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_TASKS_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_NV :: IndirectCommandsTokenTypeNV
Documentation
:: forall io. MonadIO io | |
=> CommandBuffer |
|
-> ("groupCountX" ::: Word32) |
|
-> ("groupCountY" ::: Word32) |
|
-> ("groupCountZ" ::: Word32) |
|
-> io () |
vkCmdDrawMeshTasksEXT - Draw mesh task work items
Description
When the command is executed, a global workgroup consisting of
groupCountX
× groupCountY
× groupCountZ
local workgroups is
assembled.
Valid Usage
- If a
Sampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
Sampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
ImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
ImageView
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
ImageView
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
- Any
ImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aImageViewType
and format that supports cubic filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned bygetPhysicalDeviceImageFormatProperties2
- Any
ImageView
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 aImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned bygetPhysicalDeviceImageFormatProperties2
- Any
Image
created with aImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
ImageView
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
ImageView
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
BufferView
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
BufferView
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 the
Pipeline
bound to the pipeline bind point used by this command, a descriptor set must have been bound to n at the same pipeline bind point, with aPipelineLayout
that is compatible for set n, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - If the
maintenance4
feature is not enabled, then for each push constant that is
statically used by the
Pipeline
bound to the pipeline bind point used by this command, a push constant value must have been set for the same pipeline bind point, with aPipelineLayout
that is compatible for push constants, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - Descriptors in each bound
descriptor set, specified via
cmdBindDescriptorSets
, must be valid if they are statically used by thePipeline
bound to the pipeline bind point used by this command - A valid pipeline must be bound to the pipeline bind point used by this command
- If the
Pipeline
object bound to the pipeline bind point used by this command requires any dynamic state, that state must have been set or inherited (if theVK_NV_inherited_viewport_scissor
extension is enabled) forcommandBuffer
, and done so after any previously bound pipeline with the corresponding state not specified as dynamic - There must not have been
any calls to dynamic state setting commands for any state not
specified as dynamic in the
Pipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyImage
with aImageView
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
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 the robustBufferAccess 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 any stage of
the
Pipeline
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 the robustBufferAccess 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
commandBuffer
is an unprotected command buffer and protectedNoFault is not supported, any resource accessed by thePipeline
object bound to the pipeline bind point used by this command must not be a protected resource - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
ImageView
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
BufferView
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
ImageView
with aFormat
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
ImageView
with aFormat
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
BufferView
with aFormat
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
BufferView
with aFormat
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,
Image
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,
Buffer
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 aImageView
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 aImageView
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 aImageView
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 anImageView
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 anImageView
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
. - Any shader invocation executed by this command must terminate
- The current render
pass must be
compatible
with the
renderPass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass index of the
current render pass must be equal to the
subpass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- Every input attachment used by the current subpass 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
Format
as the corresponding subpass definition be created with aImageView
that is an attachment in the currently boundFramebuffer
at an index that corresponds to a valid input attachment in the current subpass - 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 any recorded command in the current subpass will write to an image subresource as an attachment, this command must not read from the memory backing that image subresource in any other way than as an attachment
- If any recorded command in the current subpass will read from an image subresource used as an attachment 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 and stencil test is enabled,
all stencil ops
must be
STENCIL_OP_KEEP
- If the
draw is recorded in a render pass instance with multiview enabled,
the maximum instance index must be less than or equal to
PhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
- If the
bound graphics pipeline was created with
PipelineSampleLocationsStateCreateInfoEXT
::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 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 ofcmdSetViewportWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetScissorWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetViewportWithCount
must match thescissorCount
parameter ofcmdSetScissorWithCount
- 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 withPipelineViewportWScalingStateCreateInfoNV
::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 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 withPipelineViewportShadingRateImageStateCreateInfoNV
::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 bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aPipelineViewportSwizzleStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportSwizzleStateCreateInfoNV
::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 aPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call tocmdSetViewportWithCount
- 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 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 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 validLogicOp
value -
If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with
the
DYNAMIC_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 ofcmdSetViewportWithCount
must be1
- 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 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 the multisampledRenderToSingleSampled feature are enabled, thenPipelineMultisampleStateCreateInfo
::rasterizationSamples
must be the same as the current subpass color and/or depth/stencil attachments - 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 aPipelineRenderingCreateInfo
::viewMask
equal toRenderingInfo
::viewMask
- If the
current render pass instance was begun with
cmdBeginRendering
, the currently bound graphics pipeline must have been created with aPipelineRenderingCreateInfo
::colorAttachmentCount
equal toRenderingInfo
::colorAttachmentCount
- If the
current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::colorAttachmentCount
greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aFormat
equal to the corresponding element ofPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be greater than or equal to thePipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be less than or equal to themaxColorAttachments
member ofPhysicalDeviceLimits
- If the current
render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pDepthAttachment->imageView
- If the current
render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pStencilAttachment->imageView
- If the current render
pass instance was begun with
cmdBeginRendering
andRenderingFragmentShadingRateAttachmentInfoKHR
::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
andRenderingFragmentDensityMapAttachmentInfoEXT
::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
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
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 aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
- If the current
render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created with aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
-
If the currently bound pipeline was created without a
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline -
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
-
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
- If the current render
pass instance was begun with
cmdBeginRendering
, the currently bound pipeline must have been created with aGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
-
If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled. -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
. - 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 thePipelineMultisampleStateCreateInfo
::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 none of theVK_AMD_mixed_attachment_samples
extension,VK_NV_framebuffer_mixed_samples
extension, or the multisampledRenderToSingleSampled feature is 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_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 ofcmdSetColorBlendEnableEXT
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 ofcmdSetColorBlendEquationEXT
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 ofcmdSetColorWriteMaskEXT
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 ofcmdSetColorBlendAdvancedEXT
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 exceed advancedBlendMaxColorAttachments -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_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 thePipelineMultisampleStateCreateInfo
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 the
bound graphics pipeline was created with the
DYNAMIC_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 the
bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If the
bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If the
bound graphics pipeline state was created with the
DYNAMIC_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_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 aFormat
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 withPipelineViewportSwizzleStateCreateInfoNV
::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_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 the stippledRectangularLines 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 the stippledBresenhamLines 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 the stippledSmoothLines 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 the stippledRectangularLines feature must be enabled andPhysicalDeviceLimits
::strictLines
must be VK_TRUE -
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
PipelineShaderStageCreateInfo
::stage
member of an element ofGraphicsPipelineCreateInfo
::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 current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountX
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[0] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountY
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[1] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[2] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
, The product ofgroupCountX
,groupCountY
andgroupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupTotalCount
- If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountX
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[0] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountY
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[1] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[2] - If the current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
, The product ofgroupCountX
,groupCountY
andgroupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupTotalCount
- The current pipeline
bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshEXT
Execution
Model
Valid Usage (Implicit)
-
commandBuffer
must be a validCommandBuffer
handle
-
commandBuffer
must be in the recording state - The
CommandPool
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
CommandPool
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 |
See Also
cmdDrawMeshTasksIndirectEXT Source #
:: forall io. MonadIO io | |
=> CommandBuffer |
|
-> Buffer |
|
-> ("offset" ::: DeviceSize) |
|
-> ("drawCount" ::: Word32) |
|
-> ("stride" ::: Word32) |
|
-> io () |
vkCmdDrawMeshTasksIndirectEXT - Issue an indirect mesh tasks draw into a command buffer
Description
cmdDrawMeshTasksIndirectEXT
behaves similarly to cmdDrawMeshTasksEXT
except that the parameters are read by the device from a buffer during
execution. drawCount
draws are executed by the command, with
parameters taken from buffer
starting at offset
and increasing by
stride
bytes for each successive draw. The parameters of each draw are
encoded in an array of DrawMeshTasksIndirectCommandEXT
structures. If
drawCount
is less than or equal to one, stride
is ignored.
Valid Usage
- If a
Sampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
Sampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
ImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
ImageView
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
ImageView
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
- Any
ImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aImageViewType
and format that supports cubic filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned bygetPhysicalDeviceImageFormatProperties2
- Any
ImageView
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 aImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned bygetPhysicalDeviceImageFormatProperties2
- Any
Image
created with aImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
ImageView
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
ImageView
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
BufferView
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
BufferView
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 the
Pipeline
bound to the pipeline bind point used by this command, a descriptor set must have been bound to n at the same pipeline bind point, with aPipelineLayout
that is compatible for set n, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - If the
maintenance4
feature is not enabled, then for each push constant that is
statically used by the
Pipeline
bound to the pipeline bind point used by this command, a push constant value must have been set for the same pipeline bind point, with aPipelineLayout
that is compatible for push constants, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - Descriptors in each
bound descriptor set, specified via
cmdBindDescriptorSets
, must be valid if they are statically used by thePipeline
bound to the pipeline bind point used by this command - A valid pipeline must be bound to the pipeline bind point used by this command
- If the
Pipeline
object bound to the pipeline bind point used by this command requires any dynamic state, that state must have been set or inherited (if theVK_NV_inherited_viewport_scissor
extension is enabled) forcommandBuffer
, and done so after any previously bound pipeline with the corresponding state not specified as dynamic - There must not
have been any calls to dynamic state setting commands for any state
not specified as dynamic in the
Pipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyImage
with aImageView
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
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 the robustBufferAccess 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 any
stage of the
Pipeline
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 the robustBufferAccess 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
commandBuffer
is an unprotected command buffer and protectedNoFault is not supported, any resource accessed by thePipeline
object bound to the pipeline bind point used by this command must not be a protected resource - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
ImageView
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
BufferView
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
ImageView
with aFormat
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
ImageView
with aFormat
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
BufferView
with aFormat
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
BufferView
with aFormat
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,
Image
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,
Buffer
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 aImageView
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 aImageView
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 aImageView
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 anImageView
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 anImageView
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
. - Any shader invocation executed by this command must terminate
- The current
render pass must be
compatible
with the
renderPass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass index
of the current render pass must be equal to the
subpass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- Every input attachment used by the current subpass 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
Format
as the corresponding subpass definition be created with aImageView
that is an attachment in the currently boundFramebuffer
at an index that corresponds to a valid input attachment in the current subpass - 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 any recorded command in the current subpass will write to an image subresource as an attachment, this command must not read from the memory backing that image subresource in any other way than as an attachment
- If any recorded command in the current subpass will read from an image subresource used as an attachment 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 and stencil test is enabled,
all stencil ops
must be
STENCIL_OP_KEEP
-
If the draw is recorded in a render pass instance with multiview
enabled, the maximum instance index must be less than or equal to
PhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
- If
the bound graphics pipeline was created with
PipelineSampleLocationsStateCreateInfoEXT
::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 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 ofcmdSetViewportWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetScissorWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetViewportWithCount
must match thescissorCount
parameter ofcmdSetScissorWithCount
- 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 withPipelineViewportWScalingStateCreateInfoNV
::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
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 withPipelineViewportShadingRateImageStateCreateInfoNV
::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 bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aPipelineViewportSwizzleStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportSwizzleStateCreateInfoNV
::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 aPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call tocmdSetViewportWithCount
- 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 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 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 validLogicOp
value -
If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with
the
DYNAMIC_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 ofcmdSetViewportWithCount
must be1
- 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 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 the multisampledRenderToSingleSampled feature are enabled, thenPipelineMultisampleStateCreateInfo
::rasterizationSamples
must be the same as the current subpass color and/or depth/stencil attachments - 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 aPipelineRenderingCreateInfo
::viewMask
equal toRenderingInfo
::viewMask
- If
the current render pass instance was begun with
cmdBeginRendering
, the currently bound graphics pipeline must have been created with aPipelineRenderingCreateInfo
::colorAttachmentCount
equal toRenderingInfo
::colorAttachmentCount
- If
the current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::colorAttachmentCount
greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aFormat
equal to the corresponding element ofPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be greater than or equal to thePipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be less than or equal to themaxColorAttachments
member ofPhysicalDeviceLimits
- If the
current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pDepthAttachment->imageView
- If the
current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pStencilAttachment->imageView
- If the current
render pass instance was begun with
cmdBeginRendering
andRenderingFragmentShadingRateAttachmentInfoKHR
::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
andRenderingFragmentDensityMapAttachmentInfoEXT
::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
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
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 aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
- If the
current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created with aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
-
If the currently bound pipeline was created without a
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline -
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
-
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
- If the current
render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline must have been created with aGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
-
If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled. -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
. - 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 thePipelineMultisampleStateCreateInfo
::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 none of theVK_AMD_mixed_attachment_samples
extension,VK_NV_framebuffer_mixed_samples
extension, or the multisampledRenderToSingleSampled feature is 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_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 ofcmdSetColorBlendEnableEXT
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 ofcmdSetColorBlendEquationEXT
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 ofcmdSetColorWriteMaskEXT
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 ofcmdSetColorBlendAdvancedEXT
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 exceed advancedBlendMaxColorAttachments -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_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 thePipelineMultisampleStateCreateInfo
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
the bound graphics pipeline was created with the
DYNAMIC_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
the bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If
the bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
- If
the bound graphics pipeline state was created with the
DYNAMIC_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_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 aFormat
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 withPipelineViewportSwizzleStateCreateInfoNV
::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_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 the stippledRectangularLines 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 the stippledBresenhamLines 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 the stippledSmoothLines 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 the stippledRectangularLines feature must be enabled andPhysicalDeviceLimits
::strictLines
must be VK_TRUE -
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
PipelineShaderStageCreateInfo
::stage
member of an element ofGraphicsPipelineCreateInfo
::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
buffer
is non-sparse then it must be bound completely and contiguously to a singleDeviceMemory
object -
buffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit set -
offset
must be a multiple of4
-
commandBuffer
must not be a protected command buffer - If the
multiDrawIndirect
feature is not enabled,
drawCount
must be0
or1
-
drawCount
must be less than or equal toPhysicalDeviceLimits
::maxDrawIndirectCount
- If
drawCount
is greater than1
,stride
must be a multiple of4
and must be greater than or equal tosizeof
(DrawMeshTasksIndirectCommandEXT
) - If
drawCount
is equal to1
, (offset
+sizeof
(DrawMeshTasksIndirectCommandEXT
)) must be less than or equal to the size ofbuffer
- If
drawCount
is greater than1
, (stride
× (drawCount
- 1) +offset
+sizeof
(DrawMeshTasksIndirectCommandEXT
)) must be less than or equal to the size ofbuffer
- The current
pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshEXT
Execution
Model
Valid Usage (Implicit)
-
commandBuffer
must be a validCommandBuffer
handle
-
buffer
must be a validBuffer
handle -
commandBuffer
must be in the recording state - The
CommandPool
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 sameDevice
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized
- Host access to the
CommandPool
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 |
See Also
cmdDrawMeshTasksIndirectCountEXT Source #
:: forall io. MonadIO io | |
=> CommandBuffer |
|
-> Buffer |
|
-> ("offset" ::: DeviceSize) |
|
-> ("countBuffer" ::: Buffer) |
|
-> ("countBufferOffset" ::: DeviceSize) |
|
-> ("maxDrawCount" ::: Word32) |
|
-> ("stride" ::: Word32) |
|
-> io () |
vkCmdDrawMeshTasksIndirectCountEXT - Perform an indirect mesh tasks draw with the draw count sourced from a buffer
Description
cmdDrawMeshTasksIndirectCountEXT
behaves similarly to
cmdDrawMeshTasksIndirectEXT
except that the draw count is read by the
device from a buffer during execution. The command will read an unsigned
32-bit integer from countBuffer
located at countBufferOffset
and use
this as the draw count.
Valid Usage
- If a
Sampler
created withmagFilter
orminFilter
equal toFILTER_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
Sampler
created withmipmapMode
equal toSAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toFALSE
is used to sample aImageView
as a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
ImageView
is sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
- If a
ImageView
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
ImageView
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
- Any
ImageView
being sampled withFILTER_CUBIC_EXT
as a result of this command must have aImageViewType
and format that supports cubic filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubic
returned bygetPhysicalDeviceImageFormatProperties2
-
Any
ImageView
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 aImageViewType
and format that supports cubic filtering together with minmax filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT
::filterCubicMinmax
returned bygetPhysicalDeviceImageFormatProperties2
- Any
Image
created with aImageCreateInfo
::flags
containingIMAGE_CREATE_CORNER_SAMPLED_BIT_NV
sampled as a result of this command must only be sampled using aSamplerAddressMode
ofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
- For any
ImageView
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
ImageView
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
BufferView
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
BufferView
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 the
Pipeline
bound to the pipeline bind point used by this command, a descriptor set must have been bound to n at the same pipeline bind point, with aPipelineLayout
that is compatible for set n, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - If the
maintenance4
feature is not enabled, then for each push constant that is
statically used by the
Pipeline
bound to the pipeline bind point used by this command, a push constant value must have been set for the same pipeline bind point, with aPipelineLayout
that is compatible for push constants, with thePipelineLayout
used to create the currentPipeline
, as described in ??? - Descriptors in
each bound descriptor set, specified via
cmdBindDescriptorSets
, must be valid if they are statically used by thePipeline
bound to the pipeline bind point used by this command - A valid pipeline must be bound to the pipeline bind point used by this command
- If the
Pipeline
object bound to the pipeline bind point used by this command requires any dynamic state, that state must have been set or inherited (if theVK_NV_inherited_viewport_scissor
extension is enabled) forcommandBuffer
, and done so after any previously bound pipeline with the corresponding state not specified as dynamic - There must
not have been any calls to dynamic state setting commands for any
state not specified as dynamic in the
Pipeline
object bound to the pipeline bind point used by this command, since that pipeline was bound - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
object that uses unnormalized coordinates, that sampler must not be used to sample from anyImage
with aImageView
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
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
Pipeline
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 the robustBufferAccess 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
any stage of the
Pipeline
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 the robustBufferAccess 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
commandBuffer
is an unprotected command buffer and protectedNoFault is not supported, any resource accessed by thePipeline
object bound to the pipeline bind point used by this command must not be a protected resource - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*
orOpImageSparseSample*
instructions - If the
Pipeline
object bound to the pipeline bind point used by this command accesses aSampler
orImageView
object that enables sampler Y′CBCR conversion, that object must not use theConstOffset
andOffset
operands - If a
ImageView
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
BufferView
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
ImageView
with aFormat
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
ImageView
with aFormat
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
BufferView
with aFormat
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
BufferView
with aFormat
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,
Image
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,
Buffer
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 aImageView
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 aImageView
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 aImageView
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 anImageView
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 anImageView
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
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
,OpImageBlockMatchSSDQCOM
, orOpImageBlockMatchSADQCOM
uses aSampler
as a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM
. - Any shader invocation executed by this command must terminate
- The
current render pass must be
compatible
with the
renderPass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- The subpass
index of the current render pass must be equal to the
subpass
member of theGraphicsPipelineCreateInfo
structure specified when creating thePipeline
bound toPIPELINE_BIND_POINT_GRAPHICS
- Every input attachment used by the current subpass 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
Format
as the corresponding subpass definition be created with aImageView
that is an attachment in the currently boundFramebuffer
at an index that corresponds to a valid input attachment in the current subpass - 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 any recorded command in the current subpass will write to an image subresource as an attachment, this command must not read from the memory backing that image subresource in any other way than as an attachment
- If any recorded command in the current subpass will read from an image subresource used as an attachment 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 and stencil test is enabled,
all stencil ops
must be
STENCIL_OP_KEEP
-
If the draw is recorded in a render pass instance with multiview
enabled, the maximum instance index must be less than or equal to
PhysicalDeviceMultiviewProperties
::maxMultiviewInstanceIndex
-
If the bound graphics pipeline was created with
PipelineSampleLocationsStateCreateInfoEXT
::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 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 ofcmdSetViewportWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetScissorWithCount
must match thePipelineViewportStateCreateInfo
::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 ofcmdSetViewportWithCount
must match thescissorCount
parameter ofcmdSetScissorWithCount
- 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 withPipelineViewportWScalingStateCreateInfoNV
::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
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 withPipelineViewportShadingRateImageStateCreateInfoNV
::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 bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNT
dynamic state enabled and aPipelineViewportSwizzleStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportSwizzleStateCreateInfoNV
::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 aPipelineViewportExclusiveScissorStateCreateInfoNV
structure chained fromPipelineViewportStateCreateInfo
, then the bound graphics pipeline must have been created withPipelineViewportExclusiveScissorStateCreateInfoNV
::exclusiveScissorCount
greater or equal to theviewportCount
parameter in the last call tocmdSetViewportWithCount
- 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 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 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 validLogicOp
value -
If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with
the
DYNAMIC_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 ofcmdSetViewportWithCount
must be1
- 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 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 the multisampledRenderToSingleSampled feature are enabled, thenPipelineMultisampleStateCreateInfo
::rasterizationSamples
must be the same as the current subpass color and/or depth/stencil attachments - 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 aPipelineRenderingCreateInfo
::viewMask
equal toRenderingInfo
::viewMask
-
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound graphics pipeline must have been created with aPipelineRenderingCreateInfo
::colorAttachmentCount
equal toRenderingInfo
::colorAttachmentCount
-
If the current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::colorAttachmentCount
greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with aFormat
equal to the corresponding element ofPipelineRenderingCreateInfo
::pColorAttachmentFormats
used to create the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be greater than or equal to thePipelineColorBlendStateCreateInfo
::attachmentCount
of the currently bound graphics pipeline - 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, and theattachmentCount
parameter ofcmdSetColorWriteEnableEXT
must be less than or equal to themaxColorAttachments
member ofPhysicalDeviceLimits
- If
the current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::depthAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pDepthAttachment->imageView
-
If the current render pass instance was begun with
cmdBeginRendering
andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineRenderingCreateInfo
::stencilAttachmentFormat
used to create the currently bound graphics pipeline must be equal to theFormat
used to createRenderingInfo
::pStencilAttachment->imageView
- If the
current render pass instance was begun with
cmdBeginRendering
andRenderingFragmentShadingRateAttachmentInfoKHR
::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
andRenderingFragmentDensityMapAttachmentInfoEXT
::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
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the corresponding element of thepColorAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
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 aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
-
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created with aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value of thedepthStencilAttachmentSamples
member ofAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
-
If the currently bound pipeline was created without a
AttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, and the current render pass instance was begun withcmdBeginRendering
with aRenderingInfo
::colorAttachmentCount
parameter greater than0
, then each element of theRenderingInfo
::pColorAttachments
array with aimageView
not equal toNULL_HANDLE
must have been created with a sample count equal to the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline -
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pDepthAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pDepthAttachment->imageView
-
If the current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline was created without aAttachmentSampleCountInfoAMD
orAttachmentSampleCountInfoNV
structure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo
::pStencilAttachment->imageView
was notNULL_HANDLE
, the value ofPipelineMultisampleStateCreateInfo
::rasterizationSamples
used to create the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo
::pStencilAttachment->imageView
- If the
current render pass instance was begun with
cmdBeginRendering
, the currently bound pipeline must have been created with aGraphicsPipelineCreateInfo
::renderPass
equal toNULL_HANDLE
-
If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, rasterization discard must not be enabled. -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXT
query is active, the bound graphics pipeline must not have been created with a non-zero value inPipelineRasterizationStateStreamCreateInfoEXT
::rasterizationStream
. -
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 thePipelineMultisampleStateCreateInfo
::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 none of theVK_AMD_mixed_attachment_samples
extension,VK_NV_framebuffer_mixed_samples
extension, or the multisampledRenderToSingleSampled feature is 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_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 ofcmdSetColorBlendEnableEXT
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 ofcmdSetColorBlendEquationEXT
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 ofcmdSetColorWriteMaskEXT
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 ofcmdSetColorBlendAdvancedEXT
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 exceed advancedBlendMaxColorAttachments -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_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 thePipelineMultisampleStateCreateInfo
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 the bound graphics pipeline was created with the
DYNAMIC_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 the bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.width
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
-
If the bound graphics pipeline state was created with the
DYNAMIC_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 divideMultisamplePropertiesEXT
::sampleLocationGridSize.height
as returned bygetPhysicalDeviceMultisamplePropertiesEXT
with asamples
parameter equalingrasterizationSamples
-
If the bound graphics pipeline state was created with the
DYNAMIC_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_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 aFormat
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 withPipelineViewportSwizzleStateCreateInfoNV
::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_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 the stippledRectangularLines 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 the stippledBresenhamLines 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 the stippledSmoothLines 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 the stippledRectangularLines feature must be enabled andPhysicalDeviceLimits
::strictLines
must be VK_TRUE -
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
PipelineShaderStageCreateInfo
::stage
member of an element ofGraphicsPipelineCreateInfo
::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
buffer
is non-sparse then it must be bound completely and contiguously to a singleDeviceMemory
object -
buffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit set -
offset
must be a multiple of4
-
commandBuffer
must not be a protected command buffer - If
countBuffer
is non-sparse then it must be bound completely and contiguously to a singleDeviceMemory
object -
countBuffer
must have been created with theBUFFER_USAGE_INDIRECT_BUFFER_BIT
bit set -
countBufferOffset
must be a multiple of4
- The
count stored in
countBuffer
must be less than or equal toPhysicalDeviceLimits
::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 of4
and must be greater than or equal tosizeof
(DrawMeshTasksIndirectCommandEXT
) - If
maxDrawCount
is greater than or equal to1
, (stride
× (maxDrawCount
- 1) +offset
+sizeof
(DrawMeshTasksIndirectCommandEXT
)) must be less than or equal to the size ofbuffer
- If the
count stored in
countBuffer
is equal to1
, (offset
+sizeof
(DrawMeshTasksIndirectCommandEXT
)) must be less than or equal to the size ofbuffer
- If the
count stored in
countBuffer
is greater than1
, (stride
× (drawCount
- 1) +offset
+sizeof
(DrawMeshTasksIndirectCommandEXT
)) must be less than or equal to the size ofbuffer
- The current
pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
must contain a shader stage using theMeshEXT
Execution
Model
Valid Usage (Implicit)
-
commandBuffer
must be a validCommandBuffer
handle
-
buffer
must be a validBuffer
handle -
countBuffer
must be a validBuffer
handle -
commandBuffer
must be in the recording state - The
CommandPool
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 sameDevice
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized
- Host access to the
CommandPool
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 |
See Also
data PhysicalDeviceMeshShaderFeaturesEXT Source #
VkPhysicalDeviceMeshShaderFeaturesEXT - Structure describing mesh shading features that can be supported by an implementation
Description
If the PhysicalDeviceMeshShaderFeaturesEXT
structure is included in
the pNext
chain of the
PhysicalDeviceFeatures2
structure passed to
getPhysicalDeviceFeatures2
,
it is filled in to indicate whether each corresponding feature is
supported. PhysicalDeviceMeshShaderFeaturesEXT
can also be used in
the pNext
chain of DeviceCreateInfo
to
selectively enable these features.
The corresponding features of the
PhysicalDeviceMeshShaderFeaturesNV
structure must match those in PhysicalDeviceMeshShaderFeaturesEXT
.
Valid Usage
-
If
multiviewMeshShader
is enabled thenPhysicalDeviceMultiviewFeaturesKHR
::multiview
must also be enabled
-
If
primitiveFragmentShadingRateMeshShader
is enabled thenPhysicalDeviceFragmentShadingRateFeaturesKHR
::primitiveFragmentShadingRate
must also be enabled
Valid Usage (Implicit)
-
sType
must beSTRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_EXT
See Also
PhysicalDeviceMeshShaderFeaturesEXT | |
|
Instances
data PhysicalDeviceMeshShaderPropertiesEXT Source #
VkPhysicalDeviceMeshShaderPropertiesEXT - Structure describing mesh shading properties
Members
The members of the PhysicalDeviceMeshShaderPropertiesEXT
structure
describe the following implementation-dependent limits:
Description
If the PhysicalDeviceMeshShaderPropertiesEXT
structure is included in
the pNext
chain of
PhysicalDeviceProperties2
,
it is filled with the implementation-dependent limits.
Valid Usage (Implicit)
See Also
PhysicalDeviceMeshShaderPropertiesEXT | |
|
Instances
data DrawMeshTasksIndirectCommandEXT Source #
VkDrawMeshTasksIndirectCommandEXT - Structure specifying a mesh tasks draw indirect command
Description
The members of DrawMeshTasksIndirectCommandEXT
have the same meaning
as the similarly named parameters of cmdDrawMeshTasksEXT
.
Valid Usage
- [[VUID-{refpage}-TaskEXT-07322]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountX
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[0]
- [[VUID-{refpage}-TaskEXT-07323]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountY
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[1] - [[VUID-{refpage}-TaskEXT-07324]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
,groupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupCount
[2] - [[VUID-{refpage}-TaskEXT-07325]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
contains a shader using theTaskEXT
Execution
Model
, The product ofgroupCountX
,groupCountY
andgroupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxTaskWorkGroupTotalCount
- [[VUID-{refpage}-TaskEXT-07326]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountX
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[0] - [[VUID-{refpage}-TaskEXT-07327]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountY
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[1] - [[VUID-{refpage}-TaskEXT-07328]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
,groupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupCount
[2] - [[VUID-{refpage}-TaskEXT-07329]] If the current pipeline bound to
PIPELINE_BIND_POINT_GRAPHICS
does not contain a shader using theTaskEXT
Execution
Model
, The product ofgroupCountX
,groupCountY
andgroupCountZ
must be less than or equal toPhysicalDeviceMeshShaderPropertiesEXT
::maxMeshWorkGroupTotalCount
See Also
DrawMeshTasksIndirectCommandEXT | |
|
Instances
type EXT_MESH_SHADER_SPEC_VERSION = 1 Source #
pattern EXT_MESH_SHADER_SPEC_VERSION :: forall a. Integral a => a Source #
type EXT_MESH_SHADER_EXTENSION_NAME = "VK_EXT_mesh_shader" Source #
pattern EXT_MESH_SHADER_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #
newtype IndirectCommandsTokenTypeNV Source #
VkIndirectCommandsTokenTypeNV - Enum specifying token commands
Description
'
Supported indirect command tokens
See Also
VK_NV_device_generated_commands,
IndirectCommandsLayoutTokenNV