| Safe Haskell | Safe-Inferred |
|---|---|
| Language | Haskell2010 |
Vulkan.Extensions.VK_NV_device_generated_commands
Description
Name
VK_NV_device_generated_commands - device extension
VK_NV_device_generated_commands
- Name String
VK_NV_device_generated_commands
- Extension Type
- Device extension
- Registered Extension Number
- 278
- Revision
- 3
- Ratification Status
- Not ratified
- Extension and Version Dependencies
- Version 1.1 and VK_KHR_buffer_device_address
- Contact
Other Extension Metadata
- Last Modified Date
- 2020-02-20
- Interactions and External Dependencies
- This extension requires Vulkan 1.1
- This extension requires
VK_EXT_buffer_device_addressorVK_KHR_buffer_device_addressor Vulkan 1.2 for the ability to bind vertex and index buffers on the device. - This extension interacts with
VK_NV_mesh_shader. If the latter extension is not supported, remove the command token to initiate mesh tasks drawing in this extension.
- Contributors
- Christoph Kubisch, NVIDIA
- Pierre Boudier, NVIDIA
- Jeff Bolz, NVIDIA
- Eric Werness, NVIDIA
- Yuriy O’Donnell, Epic Games
- Baldur Karlsson, Valve
- Mathias Schott, NVIDIA
- Tyson Smith, NVIDIA
- Ingo Esser, NVIDIA
Description
This extension allows the device to generate a number of critical graphics commands for command buffers.
When rendering a large number of objects, the device can be leveraged to implement a number of critical functions, like updating matrices, or implementing occlusion culling, frustum culling, front to back sorting, etc. Implementing those on the device does not require any special extension, since an application is free to define its own data structures, and just process them using shaders.
However, if the application desires to quickly kick off the rendering of the final stream of objects, then unextended Vulkan forces the application to read back the processed stream and issue graphics command from the host. For very large scenes, the synchronization overhead and cost to generate the command buffer can become the bottleneck. This extension allows an application to generate a device side stream of state changes and commands, and convert it efficiently into a command buffer without having to read it back to the host.
Furthermore, it allows incremental changes to such command buffers by manipulating only partial sections of a command stream — for example pipeline bindings. Unextended Vulkan requires re-creation of entire command buffers in such a scenario, or updates synchronized on the host.
The intended usage for this extension is for the application to:
- create
Bufferobjects and retrieve physical addresses from them viagetBufferDeviceAddressEXT - create a graphics pipeline using
GraphicsPipelineShaderGroupsCreateInfoNVfor the ability to change shaders on the device. - create a
IndirectCommandsLayoutNV, which lists theIndirectCommandsTokenTypeNVit wants to dynamically execute as an atomic command sequence. This step likely involves some internal device code compilation, since the intent is for the GPU to generate the command buffer in the pipeline. - fill the input stream buffers with the data for each of the inputs it needs. Each input is an array that will be filled with token-dependent data.
- set up a preprocess
Bufferthat uses memory according to the information retrieved viagetGeneratedCommandsMemoryRequirementsNV. - optionally preprocess the generated content using
cmdPreprocessGeneratedCommandsNV, for example on an asynchronous compute queue, or for the purpose of re-using the data in multiple executions. - call
cmdExecuteGeneratedCommandsNVto create and execute the actual device commands for all sequences based on the inputs provided.
For each draw in a sequence, the following can be specified:
- a different shader group
- a number of vertex buffer bindings
- a different index buffer, with an optional dynamic offset and index type
- a number of different push constants
- a flag that encodes the primitive winding
While the GPU can be faster than a CPU to generate the commands, it will not happen asynchronously to the device, therefore the primary use case is generating “less” total work (occlusion culling, classification to use specialized shaders, etc.).
New Object Types
New Commands
cmdExecuteGeneratedCommandsNVcmdPreprocessGeneratedCommandsNVcreateIndirectCommandsLayoutNVdestroyIndirectCommandsLayoutNVgetGeneratedCommandsMemoryRequirementsNV
New Structures
BindShaderGroupIndirectCommandNVBindVertexBufferIndirectCommandNVGeneratedCommandsInfoNVGeneratedCommandsMemoryRequirementsInfoNVGraphicsShaderGroupCreateInfoNVIndirectCommandsLayoutCreateInfoNVIndirectCommandsLayoutTokenNVIndirectCommandsStreamNVSetStateFlagsIndirectCommandNVExtending
GraphicsPipelineCreateInfo:Extending
PhysicalDeviceFeatures2,DeviceCreateInfo:Extending
PhysicalDeviceProperties2:
New Enums
New Bitmasks
New Enum Constants
NV_DEVICE_GENERATED_COMMANDS_SPEC_VERSIONExtending
AccessFlagBits:Extending
ObjectType:Extending
PipelineCreateFlagBits:Extending
PipelineStageFlagBits:Extending
StructureType:STRUCTURE_TYPE_GENERATED_COMMANDS_INFO_NVSTRUCTURE_TYPE_GENERATED_COMMANDS_MEMORY_REQUIREMENTS_INFO_NVSTRUCTURE_TYPE_GRAPHICS_PIPELINE_SHADER_GROUPS_CREATE_INFO_NVSTRUCTURE_TYPE_GRAPHICS_SHADER_GROUP_CREATE_INFO_NVSTRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_CREATE_INFO_NVSTRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_TOKEN_NVSTRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_FEATURES_NVSTRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_PROPERTIES_NV
Issues
1) How to name this extension ?
VK_NV_device_generated_commands
As usual, one of the hardest issues ;)
Alternatives: VK_gpu_commands, VK_execute_commands,
VK_device_commands, VK_device_execute_commands, VK_device_execute,
VK_device_created_commands, VK_device_recorded_commands,
VK_device_generated_commands VK_indirect_generated_commands
2) Should we use a serial stateful token stream or stateless sequence descriptions?
Similarly to Pipeline, fixed layouts have the
most likelihood to be cross-vendor adoptable. They also benefit from
being processable in parallel. This is a different design choice
compared to the serial command stream generated through
GL_NV_command_list.
3) How to name a sequence description?
VkIndirectCommandsLayout as in the NVX extension predecessor.
Alternative: VkGeneratedCommandsLayout
4) Do we want to provide indirectCommands inputs with layout or at
indirectCommands time?
Separate layout from data as Vulkan does. Provide full flexibility for
indirectCommands.
5) Should the input be provided as SoA or AoS?
Both ways are desirable. AoS can provide portability to other APIs and easier to setup, while SoA allows to update individual inputs in a cache-efficient manner, when others remain static.
6) How do we make developers aware of the memory requirements of implementation-dependent data used for the generated commands?
Make the API explicit and introduce a preprocess
Buffer. Developers have to allocate it using
getGeneratedCommandsMemoryRequirementsNV.
In the NVX version the requirements were hidden implicitly as part of
the command buffer reservation process, however as the memory
requirements can be substantial, we want to give developers the ability
to budget the memory themselves. By lowering the maxSequencesCount the
memory consumption can be reduced. Furthermore reuse of the memory is
possible, for example for doing explicit preprocessing and execution in
a ping-pong fashion.
The actual buffer size is implementation-dependent and may be zero, i.e. not always required.
When making use of Graphics Shader Groups, the programs should behave similar with regards to vertex inputs, clipping and culling outputs of the geometry stage, as well as sample shading behavior in fragment shaders, to reduce the amount of the worst-case memory approximation.
7) Should we allow additional per-sequence dynamic state changes?
Yes
Introduced a lightweight indirect state flag IndirectStateFlagBitsNV.
So far only switching front face winding state is exposed. Especially in
CAD/DCC mirrored transforms that require such changes are common, and
similar flexibility is given in the ray tracing instance description.
The flag could be extended further, for example to switch between primitive-lists or -strips, or make other state modifications.
Furthermore, as new tokens can be added easily, future extension could
add the ability to change any
DynamicState.
8) How do we allow re-using already “generated” indirectCommands?
Expose a preprocessBuffer to reuse implementation-dependencyFlags
data. Set the isPreprocessed to true in
cmdExecuteGeneratedCommandsNV.
9) Under which conditions is cmdExecuteGeneratedCommandsNV legal?
It behaves like a regular draw call command.
10) Is cmdPreprocessGeneratedCommandsNV copying the input data or
referencing it?
There are multiple implementations possible:
- one could have some emulation code that parses the inputs, and generates an output command buffer, therefore copying the inputs.
- one could just reference the inputs, and have the processing done in pipe at execution time.
If the data is mandated to be copied, then it puts a penalty on implementation that could process the inputs directly in pipe. If the data is “referenced”, then it allows both types of implementation.
The inputs are “referenced”, and must not be modified after the call
to cmdExecuteGeneratedCommandsNV has completed.
11) Which buffer usage flags are required for the buffers referenced by
GeneratedCommandsInfoNV ?
Reuse existing
BUFFER_USAGE_INDIRECT_BUFFER_BIT
GeneratedCommandsInfoNV::preprocessBufferGeneratedCommandsInfoNV::sequencesCountBufferGeneratedCommandsInfoNV::sequencesIndexBufferIndirectCommandsStreamNV::buffer
12) In which pipeline stage does the device generated command expansion happen?
cmdPreprocessGeneratedCommandsNV is treated as if it occurs in a
separate logical pipeline from either graphics or compute, and that
pipeline only includes
PIPELINE_STAGE_TOP_OF_PIPE_BIT,
a new stage
PIPELINE_STAGE_COMMAND_PREPROCESS_BIT_NV,
and
PIPELINE_STAGE_BOTTOM_OF_PIPE_BIT.
This new stage has two corresponding new access types,
ACCESS_COMMAND_PREPROCESS_READ_BIT_NV
and
ACCESS_COMMAND_PREPROCESS_WRITE_BIT_NV,
used to synchronize reading the buffer inputs and writing the preprocess
memory output.
The generated output written in the preprocess buffer memory by
cmdExecuteGeneratedCommandsNV is considered to be consumed by the
PIPELINE_STAGE_DRAW_INDIRECT_BIT
pipeline stage.
Thus, to synchronize from writing the input buffers to preprocessing via
cmdPreprocessGeneratedCommandsNV, use:
dstStageMask=PIPELINE_STAGE_COMMAND_PREPROCESS_BIT_NVdstAccessMask=ACCESS_COMMAND_PREPROCESS_READ_BIT_NV
To synchronize from cmdPreprocessGeneratedCommandsNV to executing the
generated commands by cmdExecuteGeneratedCommandsNV, use:
srcStageMask=PIPELINE_STAGE_COMMAND_PREPROCESS_BIT_NVsrcAccessMask=ACCESS_COMMAND_PREPROCESS_WRITE_BIT_NVdstStageMask=PIPELINE_STAGE_DRAW_INDIRECT_BITdstAccessMask=ACCESS_INDIRECT_COMMAND_READ_BIT
When cmdExecuteGeneratedCommandsNV is used with a isPreprocessed of
FALSE, the generated commands are
implicitly preprocessed, therefore one only needs to synchronize the
inputs via:
dstStageMask=PIPELINE_STAGE_DRAW_INDIRECT_BITdstAccessMask=ACCESS_INDIRECT_COMMAND_READ_BIT
13) What if most token data is “static”, but we frequently want to render a subsection?
Added “sequencesIndexBuffer”. This allows to easier sort and filter what should actually be executed.
14) What are the changes compared to the previous NVX extension?
- Compute dispatch support was removed (was never implemented in drivers). There are different approaches how dispatching from the device should work, hence we defer this to a future extension.
- The
ObjectTableNVXwas replaced by using physical buffer addresses and introducing Shader Groups for the graphics pipeline. - Less state changes are possible overall, but the important operations are still there (reduces complexity of implementation).
- The API was redesigned so all inputs must be passed at both preprocessing and execution time (this was implicit in NVX, now it is explicit)
- The reservation of intermediate command space is now mandatory and explicit through a preprocess buffer.
- The
IndirectStateFlagBitsNVwere introduced
15) When porting from other APIs, their indirect buffers may use different enums, for example for index buffer types. How to solve this?
Added “pIndexTypeValues” to map custom uint32_t values to
corresponding IndexType.
16) Do we need more shader group state overrides?
The NVX version allowed all PSO states to be different, however as the goal is not to replace all state setup, but focus on highly-frequent state changes for drawing lots of objects, we reduced the amount of state overrides. Especially VkPipelineLayout as well as VkRenderPass configuration should be left static, the rest is still open for discussion.
The current focus is just to allow VertexInput changes as well as shaders, while all shader groups use the same shader stages.
Too much flexibility will increase the test coverage requirement as well. However, further extensions could allow more dynamic state as well.
17) Do we need more detailed physical device feature queries/enables?
An EXT version would need detailed implementor feedback to come up with a good set of features. Please contact us if you are interested, we are happy to make more features optional, or add further restrictions to reduce the minimum feature set of an EXT.
18) Is there an interaction with VK_KHR_pipeline_library planned?
Yes, a future version of this extension will detail the interaction, once VK_KHR_pipeline_library is no longer provisional.
Example Code
Open-Source samples illustrating the usage of the extension can be found at the following location (may not yet exist at time of writing):
https://github.com/nvpro-samples/vk_device_generated_cmds
Version History
Revision 1, 2020-02-20 (Christoph Kubisch)
- Initial version
Revision 2, 2020-03-09 (Christoph Kubisch)
- Remove VK_EXT_debug_report interactions
Revision 3, 2020-03-09 (Christoph Kubisch)
- Fix naming VkPhysicalDeviceGenerated to VkPhysicalDeviceDeviceGenerated
See Also
BindIndexBufferIndirectCommandNV, BindShaderGroupIndirectCommandNV,
BindVertexBufferIndirectCommandNV, GeneratedCommandsInfoNV,
GeneratedCommandsMemoryRequirementsInfoNV,
GraphicsPipelineShaderGroupsCreateInfoNV,
GraphicsShaderGroupCreateInfoNV, IndirectCommandsLayoutCreateInfoNV,
IndirectCommandsLayoutNV,
IndirectCommandsLayoutTokenNV,
IndirectCommandsLayoutUsageFlagBitsNV,
IndirectCommandsLayoutUsageFlagsNV, IndirectCommandsStreamNV,
IndirectCommandsTokenTypeNV, IndirectStateFlagBitsNV,
IndirectStateFlagsNV,
PhysicalDeviceDeviceGeneratedCommandsFeaturesNV,
PhysicalDeviceDeviceGeneratedCommandsPropertiesNV,
SetStateFlagsIndirectCommandNV, cmdBindPipelineShaderGroupNV,
cmdExecuteGeneratedCommandsNV, cmdPreprocessGeneratedCommandsNV,
createIndirectCommandsLayoutNV, destroyIndirectCommandsLayoutNV,
getGeneratedCommandsMemoryRequirementsNV
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
- cmdExecuteGeneratedCommandsNV :: forall io. MonadIO io => CommandBuffer -> ("isPreprocessed" ::: Bool) -> GeneratedCommandsInfoNV -> io ()
- cmdPreprocessGeneratedCommandsNV :: forall io. MonadIO io => CommandBuffer -> GeneratedCommandsInfoNV -> io ()
- cmdBindPipelineShaderGroupNV :: forall io. MonadIO io => CommandBuffer -> PipelineBindPoint -> Pipeline -> ("groupIndex" ::: Word32) -> io ()
- getGeneratedCommandsMemoryRequirementsNV :: forall a io. (Extendss MemoryRequirements2 a, PokeChain a, PeekChain a, MonadIO io) => Device -> GeneratedCommandsMemoryRequirementsInfoNV -> io (MemoryRequirements2 a)
- createIndirectCommandsLayoutNV :: forall io. MonadIO io => Device -> IndirectCommandsLayoutCreateInfoNV -> ("allocator" ::: Maybe AllocationCallbacks) -> io IndirectCommandsLayoutNV
- withIndirectCommandsLayoutNV :: forall io r. MonadIO io => Device -> IndirectCommandsLayoutCreateInfoNV -> Maybe AllocationCallbacks -> (io IndirectCommandsLayoutNV -> (IndirectCommandsLayoutNV -> io ()) -> r) -> r
- destroyIndirectCommandsLayoutNV :: forall io. MonadIO io => Device -> IndirectCommandsLayoutNV -> ("allocator" ::: Maybe AllocationCallbacks) -> io ()
- data PhysicalDeviceDeviceGeneratedCommandsFeaturesNV = PhysicalDeviceDeviceGeneratedCommandsFeaturesNV {}
- data PhysicalDeviceDeviceGeneratedCommandsPropertiesNV = PhysicalDeviceDeviceGeneratedCommandsPropertiesNV {
- maxGraphicsShaderGroupCount :: Word32
- maxIndirectSequenceCount :: Word32
- maxIndirectCommandsTokenCount :: Word32
- maxIndirectCommandsStreamCount :: Word32
- maxIndirectCommandsTokenOffset :: Word32
- maxIndirectCommandsStreamStride :: Word32
- minSequencesCountBufferOffsetAlignment :: Word32
- minSequencesIndexBufferOffsetAlignment :: Word32
- minIndirectCommandsBufferOffsetAlignment :: Word32
- data GraphicsShaderGroupCreateInfoNV = GraphicsShaderGroupCreateInfoNV {}
- data GraphicsPipelineShaderGroupsCreateInfoNV = GraphicsPipelineShaderGroupsCreateInfoNV {}
- data BindShaderGroupIndirectCommandNV = BindShaderGroupIndirectCommandNV {
- groupIndex :: Word32
- data BindIndexBufferIndirectCommandNV = BindIndexBufferIndirectCommandNV {}
- data BindVertexBufferIndirectCommandNV = BindVertexBufferIndirectCommandNV {
- bufferAddress :: DeviceAddress
- size :: Word32
- stride :: Word32
- data SetStateFlagsIndirectCommandNV = SetStateFlagsIndirectCommandNV {}
- data IndirectCommandsStreamNV = IndirectCommandsStreamNV {
- buffer :: Buffer
- offset :: DeviceSize
- data IndirectCommandsLayoutTokenNV = IndirectCommandsLayoutTokenNV {
- tokenType :: IndirectCommandsTokenTypeNV
- stream :: Word32
- offset :: Word32
- vertexBindingUnit :: Word32
- vertexDynamicStride :: Bool
- pushconstantPipelineLayout :: PipelineLayout
- pushconstantShaderStageFlags :: ShaderStageFlags
- pushconstantOffset :: Word32
- pushconstantSize :: Word32
- indirectStateFlags :: IndirectStateFlagsNV
- indexTypes :: Vector IndexType
- indexTypeValues :: Vector Word32
- data IndirectCommandsLayoutCreateInfoNV = IndirectCommandsLayoutCreateInfoNV {}
- data GeneratedCommandsInfoNV = GeneratedCommandsInfoNV {
- pipelineBindPoint :: PipelineBindPoint
- pipeline :: Pipeline
- indirectCommandsLayout :: IndirectCommandsLayoutNV
- streams :: Vector IndirectCommandsStreamNV
- sequencesCount :: Word32
- preprocessBuffer :: Buffer
- preprocessOffset :: DeviceSize
- preprocessSize :: DeviceSize
- sequencesCountBuffer :: Buffer
- sequencesCountOffset :: DeviceSize
- sequencesIndexBuffer :: Buffer
- sequencesIndexOffset :: DeviceSize
- data GeneratedCommandsMemoryRequirementsInfoNV = GeneratedCommandsMemoryRequirementsInfoNV {}
- type IndirectCommandsLayoutUsageFlagsNV = IndirectCommandsLayoutUsageFlagBitsNV
- newtype IndirectCommandsLayoutUsageFlagBitsNV where
- IndirectCommandsLayoutUsageFlagBitsNV Flags
- pattern INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV
- pattern INDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV
- pattern INDIRECT_COMMANDS_LAYOUT_USAGE_UNORDERED_SEQUENCES_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV
- type IndirectStateFlagsNV = IndirectStateFlagBitsNV
- newtype IndirectStateFlagBitsNV where
- 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_DISPATCH_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV :: IndirectCommandsTokenTypeNV
- pattern INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_NV :: IndirectCommandsTokenTypeNV
- type NV_DEVICE_GENERATED_COMMANDS_SPEC_VERSION = 3
- pattern NV_DEVICE_GENERATED_COMMANDS_SPEC_VERSION :: forall a. Integral a => a
- type NV_DEVICE_GENERATED_COMMANDS_EXTENSION_NAME = "VK_NV_device_generated_commands"
- pattern NV_DEVICE_GENERATED_COMMANDS_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
- newtype IndirectCommandsLayoutNV = IndirectCommandsLayoutNV Word64
Documentation
cmdExecuteGeneratedCommandsNV Source #
Arguments
| :: forall io. MonadIO io | |
| => CommandBuffer |
|
| -> ("isPreprocessed" ::: Bool) |
|
| -> GeneratedCommandsInfoNV |
|
| -> io () |
vkCmdExecuteGeneratedCommandsNV - Generate and execute commands on the device
Description
If the INDIRECT_COMMANDS_LAYOUT_USAGE_UNORDERED_SEQUENCES_BIT_NV flag
was used to create the
GeneratedCommandsInfoNV::indirectCommandsLayout then the order of
execution of individual draws through this command may execute in any
order, and may not necessarily be in the same order as specified in
GeneratedCommandsInfoNV::pStreams.
The order of execution of individual dispatches through this command
may execute in any order and may not necessarily be in the same
order as specified in GeneratedCommandsInfoNV::pStreams.
Valid Usage
- If a
Samplercreated withmagFilterorminFilterequal toFILTER_LINEARandcompareEnableequal toFALSEis used to sample aImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
- If a
Samplercreated withmipmapModeequal toSAMPLER_MIPMAP_MODE_LINEARandcompareEnableequal toFALSEis used to sample aImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT - If a
ImageViewis sampled with depth comparison, the image view’s format features must containFORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT - If a
ImageViewis accessed using atomic operations as a result of this command, then the image view’s format features must containFORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT - If a
DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFERdescriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containFORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT - If a
ImageViewis sampled withFILTER_CUBIC_EXTas a result of this command, then the image view’s format features must containFORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT - If the
VK_EXT_filter_cubic
extension is not enabled and any
ImageViewis sampled withFILTER_CUBIC_EXTas a result of this command, it must not have aImageViewTypeofIMAGE_VIEW_TYPE_3D,IMAGE_VIEW_TYPE_CUBE, orIMAGE_VIEW_TYPE_CUBE_ARRAY - Any
ImageViewbeing sampled withFILTER_CUBIC_EXTas a result of this command must have aImageViewTypeand format that supports cubic filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT::filterCubicreturned bygetPhysicalDeviceImageFormatProperties2 - Any
ImageViewbeing sampled withFILTER_CUBIC_EXTwith a reduction mode of eitherSAMPLER_REDUCTION_MODE_MINorSAMPLER_REDUCTION_MODE_MAXas a result of this command must have aImageViewTypeand format that supports cubic filtering together with minmax filtering, as specified byFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmaxreturned bygetPhysicalDeviceImageFormatProperties2 - If the
cubicRangeClamp
feature is not enabled, then any
ImageViewbeing sampled withFILTER_CUBIC_EXTas a result of this command must not have aSamplerReductionModeCreateInfo::reductionModeequal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM - Any
ImageViewbeing sampled with aSamplerReductionModeCreateInfo::reductionModeequal toSAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOMas a result of this command must sample withFILTER_CUBIC_EXT -
If the
selectableCubicWeights
feature is not enabled, then any
ImageViewbeing sampled withFILTER_CUBIC_EXTas a result of this command must haveSamplerCubicWeightsCreateInfoQCOM::cubicWeightsequal toCUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM - Any
Imagecreated with aImageCreateInfo::flagscontainingIMAGE_CREATE_CORNER_SAMPLED_BIT_NVsampled as a result of this command must only be sampled using aSamplerAddressModeofSAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE - For any
ImageViewbeing written as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT - For any
ImageViewbeing read as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT - For any
BufferViewbeing written as a storage texel buffer where the image format field of theOpTypeImageisUnknown, the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT - Any
BufferViewbeing read as a storage texel buffer where the image format field of theOpTypeImageisUnknownthen the view’s buffer features must containFORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT - For each set n
that is statically used by
a bound shader,
a descriptor set must have been bound to n at the same pipeline
bind point, with a
PipelineLayoutthat is compatible for set n, with thePipelineLayoutorDescriptorSetLayoutarray that was used to create the currentPipelineorShaderEXT, as described in ??? - For each push
constant that is statically used by
a bound shader,
a push constant value must have been set for the same pipeline
bind point, with a
PipelineLayoutthat is compatible for push constants, with thePipelineLayoutorDescriptorSetLayoutandPushConstantRangearrays used to create the currentPipelineorShaderEXT, as described in ??? - If the
maintenance4
feature is not enabled, then for each push constant that is
statically used by
a bound shader,
a push constant value must have been set for the same pipeline
bind point, with a
PipelineLayoutthat is compatible for push constants, with thePipelineLayoutorDescriptorSetLayoutandPushConstantRangearrays used to create the currentPipelineorShaderEXT, as described in ??? - Descriptors in
each bound descriptor set, specified via
cmdBindDescriptorSets, must be valid if they are statically used by thePipelinebound to the pipeline bind point used by this command and the boundPipelinewas not created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT - If the descriptors
used by the
Pipelinebound to the pipeline bind point were specified viacmdBindDescriptorSets, the boundPipelinemust have been created withoutPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT - Descriptors in
bound descriptor buffers, specified via
cmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by thePipelinebound to the pipeline bind point used by this command and the boundPipelinewas created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT - Descriptors in
bound descriptor buffers, specified via
cmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by anyShaderEXTbound to a stage corresponding to the pipeline bind point used by this command - If the descriptors
used by the
Pipelinebound to the pipeline bind point were specified viacmdSetDescriptorBufferOffsetsEXT, the boundPipelinemust have been created withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT - If a descriptor is
dynamically used with a
Pipelinecreated withPIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident - If a descriptor is
dynamically used with a
ShaderEXTcreated with aDescriptorSetLayoutthat was created withDESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident - If the shaderObject feature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command
- If the
shaderObject
is enabled, either a valid pipeline must be bound to the pipeline
bind point used by this command, or a valid combination of valid and
NULL_HANDLEshader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command - If a pipeline is
bound to the pipeline bind point used by this command, there must
not have been any calls to dynamic state setting commands for any
state not specified as dynamic in the
Pipelineobject bound to the pipeline bind point used by this command, since that pipeline was bound - If the
Pipelineobject bound to the pipeline bind point used by this command or anyShaderEXTbound to a stage corresponding to the pipeline bind point used by this command accesses aSamplerobject that uses unnormalized coordinates, that sampler must not be used to sample from anyImagewith aImageViewof the typeIMAGE_VIEW_TYPE_3D,IMAGE_VIEW_TYPE_CUBE,IMAGE_VIEW_TYPE_1D_ARRAY,IMAGE_VIEW_TYPE_2D_ARRAYorIMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage - If the
Pipelineobject bound to the pipeline bind point used by this command or anyShaderEXTbound to a stage corresponding to the pipeline bind point used by this command accesses aSamplerobject that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions withImplicitLod,DreforProjin their name, in any shader stage - If the
Pipelineobject bound to the pipeline bind point used by this command or anyShaderEXTbound to a stage corresponding to the pipeline bind point used by this command accesses aSamplerobject 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
Pipelineobject 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_EXTorPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforuniformBuffers, 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 the
robustBufferAccess
feature is not enabled, and any
ShaderEXTbound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If any
stage of the
Pipelineobject 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_EXTorPIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforstorageBuffers, 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 the
robustBufferAccess
feature is not enabled, and any
ShaderEXTbound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point - If
commandBufferis an unprotected command buffer and protectedNoFault is not supported, any resource accessed by bound shaders must not be a protected resource - If
a bound shader
accesses a
SamplerorImageViewobject that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*orOpImageSparseSample*instructions - If
a bound shader
accesses a
SamplerorImageViewobject that enables sampler Y′CBCR conversion, that object must not use theConstOffsetandOffsetoperands - If a
ImageViewis accessed as a result of this command, then the image view’sviewTypemust match theDimoperand of theOpTypeImageas described in ??? - If a
ImageViewis accessed as a result of this command, then the numeric type of the image view’sformatand theSampledTypeoperand of theOpTypeImagemust match - If a
ImageViewcreated with a format other thanFORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the image view’s format - If a
ImageViewcreated with the formatFORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have four components - If a
BufferViewis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the buffer view’s format - If a
ImageViewwith aFormatthat has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 - If a
ImageViewwith aFormatthat has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 - If a
BufferViewwith aFormatthat has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 - If a
BufferViewwith aFormatthat has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
If the
sparseImageInt64Atomics
feature is not enabled,
Imageobjects created with theIMAGE_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
If the
sparseImageInt64Atomics
feature is not enabled,
Bufferobjects created with theBUFFER_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
If
OpImageWeightedSampleQCOMis used to sample aImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM -
If
OpImageWeightedSampleQCOMuses aImageViewas 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
OpImageBoxFilterQCOMis used to sample aImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM -
If
OpImageBlockMatchSSDQCOMis used to read from anImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
If
OpImageBlockMatchSADQCOMis used to read from anImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
If
OpImageBlockMatchSADQCOMor OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
If
OpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses aSampleras a result of this command, then the sampler must have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
If any command other than
OpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses aSampleras a result of this command, then the sampler must not have been created withSAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
If a
OpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from anImageViewas a result of this command, then the image view’s format features must containFORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
If a
OpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from anImageViewas a result of this command, then the image view’s format must be a single-component format. -
If a
OpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMread from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation - Any shader invocation executed by this command must terminate
- The current
render pass must be
compatible
with the
renderPassmember of theGraphicsPipelineCreateInfostructure specified when creating thePipelinebound toPIPELINE_BIND_POINT_GRAPHICS - The subpass
index of the current render pass must be equal to the
subpassmember of theGraphicsPipelineCreateInfostructure specified when creating thePipelinebound toPIPELINE_BIND_POINT_GRAPHICS - If any shader statically accesses an input attachment, a valid descriptor must be bound to the pipeline via a descriptor set
- If any
shader executed by this pipeline accesses an
OpTypeImagevariable with aDimoperand ofSubpassData, it must be decorated with anInputAttachmentIndexthat corresponds to a valid input attachment in the current subpass - Input attachment
views accessed in a subpass must be created with the same
Formatas the corresponding subpass definition, and be created with aImageViewthat is compatible with the attachment referenced by the subpass'pInputAttachments[InputAttachmentIndex] in the currently boundFramebufferas specified by Fragment Input Attachment Compatibility - Memory backing image subresources used as attachments in the current render pass must not be written in any way other than as an attachment by this command
If a color attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXTimage layout, and either:- the
PIPELINE_CREATE_COLOR_ATTACHMENT_FEEDBACK_LOOP_BIT_EXTis set on the currently bound pipeline or the last call to
cmdSetAttachmentFeedbackLoopEnableEXTincludedIMAGE_ASPECT_COLOR_BITand- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXTit must not be accessed in any way other than as an attachment by this command
- the
If a depth attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXTimage layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXTis set on the currently bound pipeline or the last call to
cmdSetAttachmentFeedbackLoopEnableEXTincludedIMAGE_ASPECT_DEPTH_BITand- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXTit must not be accessed in any way other than as an attachment by this command
- the
If a stencil attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it is not in the
IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXTimage layout, and either:- the
PIPELINE_CREATE_DEPTH_STENCIL_ATTACHMENT_FEEDBACK_LOOP_BIT_EXTis set on the currently bound pipeline or the last call to
cmdSetAttachmentFeedbackLoopEnableEXTincludedIMAGE_ASPECT_STENCIL_BITand- there is no currently bound graphics pipeline or
- the currently bound graphics pipeline was created with
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXTit must not be accessed in any way other than as an attachment by this command
- the
- If an attachment is written by any prior command in this subpass or by the load, store, or resolve operations for this subpass, it must not be accessed in any way other than as an attachment, storage image, or sampled image by this command
- If any previously recorded command in the current subpass accessed an image subresource used as an attachment in this subpass in any way other than as an attachment, this command must not write to that image subresource as an attachment
- If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, depth writes must be disabled
- If the current
render pass instance uses a depth/stencil attachment with a
read-only layout for the stencil aspect, both front and back
writeMaskare not zero, and stencil test is enabled, all stencil ops must beSTENCIL_OP_KEEP - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORTdynamic state enabled thencmdSetViewportmust 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_SCISSORdynamic state enabled thencmdSetScissormust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_LINE_WIDTHdynamic state enabled thencmdSetLineWidthmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPolygonModeEXTin the current command buffer setpolygonModetoPOLYGON_MODE_LINE,cmdSetLineWidthmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPrimitiveTopologyin the current command buffer setprimitiveTopologyto any line topology,cmdSetLineWidthmust have been called in the current command buffer prior to this drawing command - If a shader object
that outputs line primitives is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BITorSHADER_STAGE_GEOMETRY_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE,cmdSetLineWidthmust 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_BIASdynamic state enabled thencmdSetDepthBiasorcmdSetDepthBias2EXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetDepthBiasEnablein the current command buffer setdepthBiasEnabletoTRUE,cmdSetDepthBiasorcmdSetDepthBias2EXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_BLEND_CONSTANTSdynamic state enabled thencmdSetBlendConstantsmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetColorBlendEnableEXTin the current command buffer set any element ofpColorBlendEnablestoTRUE, and the most recent call tocmdSetColorBlendEquationEXTin the current command buffer set the same element ofpColorBlendEquationsto aColorBlendEquationEXTstructure with anyBlendFactormember with a value ofBLEND_FACTOR_CONSTANT_COLOR,BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR,BLEND_FACTOR_CONSTANT_ALPHA, orBLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA,cmdSetBlendConstantsmust 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_BOUNDSdynamic state enabled, and if the currentdepthBoundsTestEnablestate isTRUE, thencmdSetDepthBoundsmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetDepthBoundsTestEnablein the current command buffer setdepthBoundsTestEnabletoTRUE, thencmdSetDepthBoundsmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_COMPARE_MASKdynamic state enabled, and if the currentstencilTestEnablestate isTRUE, thencmdSetStencilCompareMaskmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetStencilTestEnablein the current command buffer setstencilTestEnabletoTRUE,cmdSetStencilCompareMaskmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_WRITE_MASKdynamic state enabled, and if the currentstencilTestEnablestate isTRUE, thencmdSetStencilWriteMaskmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetStencilTestEnablein the current command buffer setstencilTestEnabletoTRUE,cmdSetStencilWriteMaskmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_REFERENCEdynamic state enabled, and if the currentstencilTestEnablestate isTRUE, thencmdSetStencilReferencemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetStencilTestEnablein the current command buffer setstencilTestEnabletoTRUE,cmdSetStencilReferencemust have been called in the current command buffer prior to this drawing command -
If the draw is recorded in a render pass instance with multiview
enabled, the maximum instance index must be less than or equal to
PhysicalDeviceMultiviewProperties::maxMultiviewInstanceIndex -
If the bound graphics pipeline was created with
PipelineSampleLocationsStateCreateInfoEXT::sampleLocationsEnableset toTRUEand the current subpass has a depth/stencil attachment, then that attachment must have been created with theIMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXTbit set - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTdynamic state enabled thencmdSetSampleLocationsEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetSampleLocationsEnableEXTin the current command buffer setsampleLocationsEnabletoTRUE, thencmdSetSampleLocationsEXTmust have been called in the current command buffer prior to this drawing command -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate enabled, then thesampleLocationsPerPixelmember ofpSampleLocationsInfoin the last call tocmdSetSampleLocationsEXTmust equal therasterizationSamplesmember of thePipelineMultisampleStateCreateInfostructure the bound graphics pipeline has been created with - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_CULL_MODEdynamic state enabled thencmdSetCullModemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetCullModemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_FRONT_FACEdynamic state enabled thencmdSetFrontFacemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetFrontFacemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_TEST_ENABLEdynamic state enabled thencmdSetDepthTestEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetDepthTestEnablemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_WRITE_ENABLEdynamic state enabled thencmdSetDepthWriteEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetDepthWriteEnablemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_COMPARE_OPdynamic state enabled thencmdSetDepthCompareOpmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetDepthTestEnablein the current command buffer setdepthTestEnabletoTRUE, thencmdSetDepthCompareOpmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLEdynamic state enabled thencmdSetDepthBoundsTestEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the
depthBounds
feature is enabled, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, then thecmdSetDepthBoundsTestEnablemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_TEST_ENABLEdynamic state enabled thencmdSetStencilTestEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetStencilTestEnablemust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_STENCIL_OPdynamic state enabled thencmdSetStencilOpmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetStencilTestEnablein the current command buffer setstencilTestEnabletoTRUE, thencmdSetStencilOpmust 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_COUNTdynamic state enabled, but not theDYNAMIC_STATE_SCISSOR_WITH_COUNTdynamic state enabled, thencmdSetViewportWithCountmust have been called in the current command buffer prior to this drawing command, and theviewportCountparameter ofcmdSetViewportWithCountmust match thePipelineViewportStateCreateInfo::scissorCountof the pipeline - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_SCISSOR_WITH_COUNTdynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled, thencmdSetScissorWithCountmust have been called in the current command buffer prior to this drawing command, and thescissorCountparameter ofcmdSetScissorWithCountmust match thePipelineViewportStateCreateInfo::viewportCountof the pipeline - If the
bound graphics pipeline state was created with both the
DYNAMIC_STATE_SCISSOR_WITH_COUNTandDYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic states enabled then bothcmdSetViewportWithCountandcmdSetScissorWithCountmust have been called in the current command buffer prior to this drawing command, and theviewportCountparameter ofcmdSetViewportWithCountmust match thescissorCountparameter ofcmdSetScissorWithCount - If a shader object
is bound to any graphics stage, then both
cmdSetViewportWithCountandcmdSetScissorWithCountmust have been called in the current command buffer prior to this drawing command, and theviewportCountparameter ofcmdSetViewportWithCountmust match thescissorCountparameter ofcmdSetScissorWithCount - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_W_SCALING_NVdynamic state enabled, then the bound graphics pipeline must have been created withPipelineViewportWScalingStateCreateInfoNV::viewportCountgreater or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTandDYNAMIC_STATE_VIEWPORT_W_SCALING_NVdynamic states enabled then theviewportCountparameter in the last call tocmdSetViewportWScalingNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
VK_NV_clip_space_w_scalingextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetViewportWScalingEnableNVin the current command buffer setviewportWScalingEnabletoTRUE, thencmdSetViewportWScalingNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scalingextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetViewportWScalingEnableNVin the current command buffer setviewportWScalingEnabletoTRUE, then theviewportCountparameter in the last call tocmdSetViewportWScalingNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NVdynamic state enabled, then the bound graphics pipeline must have been created withPipelineViewportShadingRateImageStateCreateInfoNV::viewportCountgreater or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTandDYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NVdynamic states enabled then theviewportCountparameter in the last call tocmdSetViewportShadingRatePaletteNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetCoarseSampleOrderNVmust have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetShadingRateImageEnableNVin the current command buffer setshadingRateImageEnabletoTRUE, thencmdSetViewportShadingRatePaletteNVmust have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetShadingRateImageEnableNVin the current command buffer setshadingRateImageEnabletoTRUE, then theviewportCountparameter in the last call tocmdSetViewportShadingRatePaletteNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled and aPipelineViewportSwizzleStateCreateInfoNVstructure chained fromPipelineViewportStateCreateInfo, then the bound graphics pipeline must have been created withPipelineViewportSwizzleStateCreateInfoNV::viewportCountgreater or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled and aPipelineViewportExclusiveScissorStateCreateInfoNVstructure chained fromPipelineViewportStateCreateInfo, then the bound graphics pipeline must have been created withPipelineViewportExclusiveScissorStateCreateInfoNV::exclusiveScissorCountgreater or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_ENABLE_NVdynamic state enabled thencmdSetExclusiveScissorEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NVdynamic state enabled thencmdSetExclusiveScissorNVmust have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics
stage, then
cmdSetExclusiveScissorEnableNVmust have been called in the current command buffer prior to this drawing command - If the
exclusiveScissor
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetExclusiveScissorEnableNVin the current command buffer set any element ofpExclusiveScissorEnablestoTRUE, thencmdSetExclusiveScissorNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLEdynamic state enabled thencmdSetRasterizerDiscardEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, then
cmdSetRasterizerDiscardEnablemust 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_ENABLEdynamic state enabled thencmdSetDepthBiasEnablemust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetDepthBiasEnablemust 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_EXTdynamic state enabled thencmdSetLogicOpEXTmust have been called in the current command buffer prior to this drawing command and thelogicOpmust be a validLogicOpvalue - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetLogicOpEnableEXTsetlogicOpEnabletoTRUE, thencmdSetLogicOpEXTmust have been called in the current command buffer prior to this drawing command and thelogicOpmust be a validLogicOpvalue -
If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, the bound graphics pipeline was created with
the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTdynamic state enabled, and any of the shader stages of the bound graphics pipeline write to thePrimitiveShadingRateKHRbuilt-in, thencmdSetViewportWithCountmust have been called in the current command buffer prior to this drawing command, and theviewportCountparameter ofcmdSetViewportWithCountmust be1 -
If the
primitiveFragmentShadingRateWithMultipleViewports
limit is not supported, and any shader object bound to a graphics
stage writes to the
PrimitiveShadingRateKHRbuilt-in, thencmdSetViewportWithCountmust have been called in the current command buffer prior to this drawing command, and theviewportCountparameter ofcmdSetViewportWithCountmust 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 theblendEnablemember of the corresponding element of thepAttachmentsmember ofpColorBlendStatemust beFALSE - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, then for each color attachment in the render pass, if the corresponding image view’s format features do not containFORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT, then the corresponding member ofpColorBlendEnablesin the most recent call tocmdSetColorBlendEnableEXTin the current command buffer that affected that attachment index must have beenFALSE -
If rasterization is not disabled in the bound graphics pipeline, and
none of the
VK_AMD_mixed_attachment_samplesextension, theVK_NV_framebuffer_mixed_samplesextension, or the multisampledRenderToSingleSampled feature is enabled, thenrasterizationSamplesfor the currently bound graphics pipeline must be the same as the current subpass color and/or depth/stencil attachments - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and none of theVK_AMD_mixed_attachment_samplesextension, theVK_NV_framebuffer_mixed_samplesextension, or the multisampledRenderToSingleSampled feature is enabled, then the most recent call tocmdSetRasterizationSamplesEXTin the current command buffer must have setrasterizationSamplesto be the same as the number of samples for the current render pass color and/or depth/stencil attachments - If a shader object
is bound to any graphics stage, the current render pass instance
must have been begun with
cmdBeginRendering - If the
current render pass instance was begun with
cmdBeginRendering, theimageViewmember ofpDepthAttachmentis notNULL_HANDLE, and thelayoutmember ofpDepthAttachmentisIMAGE_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, theimageViewmember ofpStencilAttachmentis notNULL_HANDLE, and thelayoutmember ofpStencilAttachmentisIMAGE_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, theimageViewmember ofpDepthAttachmentis notNULL_HANDLE, and thelayoutmember ofpDepthAttachmentisIMAGE_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, theimageViewmember ofpStencilAttachmentis notNULL_HANDLE, and thelayoutmember ofpStencilAttachmentisIMAGE_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, theimageViewmember ofpDepthAttachmentis notNULL_HANDLE, and thelayoutmember ofpDepthAttachmentisIMAGE_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, theimageViewmember ofpStencilAttachmentis notNULL_HANDLE, and thelayoutmember ofpStencilAttachmentisIMAGE_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::viewMaskequal toRenderingInfo::viewMask - If
the current render pass instance was begun with
cmdBeginRendering, the currently bound graphics pipeline must have been created with aPipelineRenderingCreateInfo::colorAttachmentCountequal toRenderingInfo::colorAttachmentCount -
If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was
begun with
cmdBeginRenderingandRenderingInfo::colorAttachmentCountgreater than0, then each element of theRenderingInfo::pColorAttachmentsarray with aimageViewnot equal toNULL_HANDLEmust have been created with aFormatequal to the corresponding element ofPipelineRenderingCreateInfo::pColorAttachmentFormatsused to create the currently bound graphics pipeline -
If the
dynamicRenderingUnusedAttachments
feature is enabled, and the current render pass instance was begun
with
cmdBeginRenderingandRenderingInfo::colorAttachmentCountgreater than0, then each element of theRenderingInfo::pColorAttachmentsarray with aimageViewnot equal toNULL_HANDLEmust have been created with aFormatequal to the corresponding element ofPipelineRenderingCreateInfo::pColorAttachmentFormatsused to create the currently bound graphics pipeline, or the corresponding element ofPipelineRenderingCreateInfo::pColorAttachmentFormats, if it exists, must beFORMAT_UNDEFINED -
If the
dynamicRenderingUnusedAttachments
feature is not enabled, and the current render pass instance was
begun with
cmdBeginRenderingandRenderingInfo::colorAttachmentCountgreater than0, then each element of theRenderingInfo::pColorAttachmentsarray with aimageViewequal toNULL_HANDLEmust have the corresponding element ofPipelineRenderingCreateInfo::pColorAttachmentFormatsused to create the currently bound pipeline equal toFORMAT_UNDEFINED - If
the current render pass instance was begun with
cmdBeginRendering, with aRenderingInfo::colorAttachmentCountequal to1, there is no shader object bound to any graphics stage, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID, each element of theRenderingInfo::pColorAttachmentsarray with aresolveImageViewnot equal toNULL_HANDLEmust have been created with an image created with aExternalFormatANDROID::externalFormatvalue equal to theExternalFormatANDROID::externalFormatvalue used to create the currently bound graphics pipeline - If there is no
shader object bound to any graphics stage, the current render pass
instance was begun with
cmdBeginRenderingand aRenderingInfo::colorAttachmentCountequal to1, and a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID, each element of theRenderingInfo::pColorAttachmentsarray with aimageViewnot equal toNULL_HANDLEmust have been created with an image created with aExternalFormatANDROID::externalFormatvalue equal to theExternalFormatANDROID::externalFormatvalue used to create the currently bound graphics pipeline - If the current
render pass instance was begun with
cmdBeginRendering, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroExternalFormatANDROID::externalFormatvalue and with theDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXTdynamic state enabled, thencmdSetColorBlendEnableEXTmust have set the blend enable toFALSEprior to this drawing command - If the current
render pass instance was begun with
cmdBeginRendering, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroExternalFormatANDROID::externalFormatvalue and with theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTdynamic state enabled, thencmdSetRasterizationSamplesEXTmust have setrasterizationSamplestoSAMPLE_COUNT_1_BITprior to this drawing command - If there is a
shader object bound to any graphics stage, and the current render
pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROIDresolve mode, thencmdSetColorBlendEnableEXTmust have set blend enable toFALSEprior to this drawing command - If
there is a shader object bound to any graphics stage, and the
current render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROIDresolve mode, thencmdSetRasterizationSamplesEXTmust have setrasterizationSamplestoSAMPLE_COUNT_1_BITprior to this drawing command - If the current
render pass instance was begun with
cmdBeginRendering, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroExternalFormatANDROID::externalFormatvalue and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHRdynamic state enabled, thencmdSetFragmentShadingRateKHRmust have setpFragmentSize->widthto1prior to this drawing command - If the current
render pass instance was begun with
cmdBeginRendering, there is no shader object bound to any graphics stage, and the currently bound graphics pipeline was created with a non-zeroExternalFormatANDROID::externalFormatvalue and with theDYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHRdynamic state enabled, thencmdSetFragmentShadingRateKHRmust have setpFragmentSize->heightto1prior to this drawing command - If there
is a shader object bound to any graphics stage, and the current
render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROIDresolve mode, thencmdSetFragmentShadingRateKHRmust have setpFragmentSize->widthto1prior to this drawing command - If there
is a shader object bound to any graphics stage, and the current
render pass includes a color attachment that uses the
RESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROIDresolve mode, thencmdSetFragmentShadingRateKHRmust have setpFragmentSize->heightto1prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXTdynamic state enabled thencmdSetColorWriteEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to
the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorWriteEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXTdynamic state enabled then theattachmentCountparameter ofcmdSetColorWriteEnableEXTmust be greater than or equal to thePipelineColorBlendStateCreateInfo::attachmentCountof the currently bound graphics pipeline - If the
colorWriteEnable
feature is enabled on the device, and a shader object is bound to
the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, then theattachmentCountparameter of most recent call tocmdSetColorWriteEnableEXTin the current command buffer must be greater than or equal to the number of color attachments in the current render pass instance - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_EXTdynamic state enabled thencmdSetDiscardRectangleEXTmust have been called in the current command buffer prior to this drawing command for each discard rectangle inPipelineDiscardRectangleStateCreateInfoEXT::discardRectangleCount - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_ENABLE_EXTdynamic state enabled thencmdSetDiscardRectangleEnableEXTmust have been called in the current command buffer prior to this drawing command -
If the
VK_EXT_discard_rectanglesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetDiscardRectangleEnableEXTin the current command buffer setdiscardRectangleEnabletoTRUE, thencmdSetDiscardRectangleEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectanglesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetDiscardRectangleEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DISCARD_RECTANGLE_MODE_EXTdynamic state enabled thencmdSetDiscardRectangleModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_discard_rectanglesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetDiscardRectangleEnableEXTin the current command buffer setdiscardRectangleEnabletoTRUE, thencmdSetDiscardRectangleModeEXTmust have been called in the current command buffer prior to this drawing command -
If the current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is not enabled, andRenderingInfo::pDepthAttachment->imageViewwasNULL_HANDLE, the value ofPipelineRenderingCreateInfo::depthAttachmentFormatused to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED -
If current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is not enabled, andRenderingInfo::pDepthAttachment->imageViewwas notNULL_HANDLE, the value ofPipelineRenderingCreateInfo::depthAttachmentFormatused to create the currently bound graphics pipeline must be equal to theFormatused to createRenderingInfo::pDepthAttachment->imageView -
If the current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is enabled,RenderingInfo::pDepthAttachment->imageViewwas notNULL_HANDLE, and the value ofPipelineRenderingCreateInfo::depthAttachmentFormatused to create the currently bound graphics pipeline was not equal to theFormatused to createRenderingInfo::pDepthAttachment->imageView, the value of the format must beFORMAT_UNDEFINED -
If the current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is not enabled, andRenderingInfo::pStencilAttachment->imageViewwasNULL_HANDLE, the value ofPipelineRenderingCreateInfo::stencilAttachmentFormatused to create the currently bound graphics pipeline must be equal toFORMAT_UNDEFINED -
If current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is not enabled, andRenderingInfo::pStencilAttachment->imageViewwas notNULL_HANDLE, the value ofPipelineRenderingCreateInfo::stencilAttachmentFormatused to create the currently bound graphics pipeline must be equal to theFormatused to createRenderingInfo::pStencilAttachment->imageView -
If the current render pass instance was begun with
cmdBeginRendering, the dynamicRenderingUnusedAttachments feature is enabled,RenderingInfo::pStencilAttachment->imageViewwas notNULL_HANDLE, and the value ofPipelineRenderingCreateInfo::stencilAttachmentFormatused to create the currently bound graphics pipeline was not equal to theFormatused to createRenderingInfo::pStencilAttachment->imageView, the value of the format must beFORMAT_UNDEFINED - If the
current render pass instance was begun with
cmdBeginRenderingandRenderingFragmentShadingRateAttachmentInfoKHR::imageViewwas 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
cmdBeginRenderingandRenderingFragmentDensityMapAttachmentInfoEXT::imageViewwas 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
AttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, and the current render pass instance was begun withcmdBeginRenderingwith aRenderingInfo::colorAttachmentCountparameter greater than0, then each element of theRenderingInfo::pColorAttachmentsarray with aimageViewnot equal toNULL_HANDLEmust have been created with a sample count equal to the corresponding element of thepColorAttachmentSamplesmember ofAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVused to create the currently bound graphics pipeline - If the
current render pass instance was begun with
cmdBeginRendering, the currently bound pipeline was created with aAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, andRenderingInfo::pDepthAttachment->imageViewwas notNULL_HANDLE, the value of thedepthStencilAttachmentSamplesmember ofAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVused 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 aAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, andRenderingInfo::pStencilAttachment->imageViewwas notNULL_HANDLE, the value of thedepthStencilAttachmentSamplesmember ofAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVused 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
AttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, and the multisampledRenderToSingleSampled feature is not enabled, and the current render pass instance was begun withcmdBeginRenderingwith aRenderingInfo::colorAttachmentCountparameter greater than0, then each element of theRenderingInfo::pColorAttachmentsarray with aimageViewnot equal toNULL_HANDLEmust have been created with a sample count equal to the value ofrasterizationSamplesfor the currently bound graphics pipeline -
If the current render pass instance was begun with
cmdBeginRendering, the currently bound pipeline was created without aAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo::pDepthAttachment->imageViewwas notNULL_HANDLE, the value ofrasterizationSamplesfor 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 aAttachmentSampleCountInfoAMDorAttachmentSampleCountInfoNVstructure, and the multisampledRenderToSingleSampled feature is not enabled, andRenderingInfo::pStencilAttachment->imageViewwas notNULL_HANDLE, the value ofrasterizationSamplesfor the currently bound graphics pipeline must be equal to the sample count used to createRenderingInfo::pStencilAttachment->imageView - If this command
has been called inside a render pass instance started with
cmdBeginRendering, and thepNextchain ofRenderingInfoincludes aMultisampledRenderToSingleSampledInfoEXTstructure withmultisampledRenderToSingleSampledEnableequal toTRUE, then the value ofrasterizationSamplesfor the currently bound graphics pipeline must be equal toMultisampledRenderToSingleSampledInfoEXT::rasterizationSamples - If the
current render pass instance was begun with
cmdBeginRendering, the currently bound pipeline must have been created with aGraphicsPipelineCreateInfo::renderPassequal toNULL_HANDLE - If
the current render pass instance was begun with
cmdBeginRendering, there is a graphics pipeline bound with a fragment shader that statically writes to a color attachment, the color write mask is not zero, color writes are enabled, and the corresponding element of theRenderingInfo::pColorAttachments->imageViewwas notNULL_HANDLE, then the corresponding element ofPipelineRenderingCreateInfo::pColorAttachmentFormatsused to create the pipeline must not beFORMAT_UNDEFINED - If the
current render pass instance was begun with
cmdBeginRendering, there is a graphics pipeline bound, depth test is enabled, depth write is enabled, and theRenderingInfo::pDepthAttachment->imageViewwas notNULL_HANDLE, then thePipelineRenderingCreateInfo::depthAttachmentFormatused to create the pipeline must not beFORMAT_UNDEFINED - If
the current render pass instance was begun with
cmdBeginRendering, there is a graphics pipeline bound, stencil test is enabled and theRenderingInfo::pStencilAttachment->imageViewwas notNULL_HANDLE, then thePipelineRenderingCreateInfo::stencilAttachmentFormatused to create the pipeline must not beFORMAT_UNDEFINED -
If the
primitivesGeneratedQueryWithRasterizerDiscard
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXTquery is active, rasterization discard must not be enabled -
If the
primitivesGeneratedQueryWithNonZeroStreams
feature is not enabled and the
QUERY_TYPE_PRIMITIVES_GENERATED_EXTquery 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_TESSELLATION_DOMAIN_ORIGIN_EXTdynamic state enabled thencmdSetTessellationDomainOriginEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLAMP_ENABLE_EXTdynamic state enabled thencmdSetDepthClampEnableEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to the
SHADER_STAGE_TESSELLATION_EVALUATION_BITstage, thencmdSetTessellationDomainOriginEXTmust have been called in the current command buffer prior to this drawing command - If the
depthClamp
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetDepthClampEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_POLYGON_MODE_EXTdynamic state enabled thencmdSetPolygonModeEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetPolygonModeEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTdynamic state enabled thencmdSetRasterizationSamplesEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetRasterizationSamplesEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXTdynamic state enabled thencmdSetSampleMaskEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetSampleMaskEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXTdynamic state enabled thencmdSetAlphaToCoverageEnableEXTmust have been called in the current command buffer prior to this drawing command -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_COVERAGE_ENABLE_EXTdynamic state enabled, andalphaToCoverageEnablewasTRUEin the last call tocmdSetAlphaToCoverageEnableEXT, then the Fragment Output Interface must contain a variable for the alphaComponentword inLocation0 atIndex0 - If a shader object
is bound to any graphics stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetAlphaToCoverageEnableEXTmust have been called in the current command buffer prior to this drawing command -
If a shader object is bound to any graphics stage, and the most
recent call to
cmdSetAlphaToCoverageEnableEXTin the current command buffer setalphaToCoverageEnabletoTRUE, then the Fragment Output Interface must contain a variable for the alphaComponentword inLocation0 atIndex0 - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_ALPHA_TO_ONE_ENABLE_EXTdynamic state enabled thencmdSetAlphaToOneEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
alphaToOne
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetAlphaToOneEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_LOGIC_OP_ENABLE_EXTdynamic state enabled thencmdSetLogicOpEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
logicOp
feature is enabled, and a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetLogicOpEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXTdynamic state enabled thencmdSetColorBlendEnableEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorBlendEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXTdynamic state enabled thencmdSetColorBlendEquationEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetColorBlendEnableEXTfor any attachment set that attachment’s value inpColorBlendEnablestoTRUE, thencmdSetColorBlendEquationEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_WRITE_MASK_EXTdynamic state enabled thencmdSetColorWriteMaskEXTmust have been called in the current command buffer prior to this drawing command - If a shader object
is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorWriteMaskEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_STREAM_EXTdynamic state enabled thencmdSetRasterizationStreamEXTmust have been called in the current command buffer prior to this drawing command - If the
geometryStreams
feature is enabled, and a shader object is bound to the
SHADER_STAGE_GEOMETRY_BITstage, thencmdSetRasterizationStreamEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXTdynamic state enabled thencmdSetConservativeRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterizationextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetConservativeRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_EXTRA_PRIMITIVE_OVERESTIMATION_SIZE_EXTdynamic state enabled thencmdSetExtraPrimitiveOverestimationSizeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_conservative_rasterizationextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetConservativeRasterizationModeEXTin the current command buffer setconservativeRasterizationModetoCONSERVATIVE_RASTERIZATION_MODE_OVERESTIMATE_EXT, thencmdSetExtraPrimitiveOverestimationSizeEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_ENABLE_EXTdynamic state enabled thencmdSetDepthClipEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
depthClipEnable
feature is enabled, and a shader object is bound to any graphics
stage, then
cmdSetDepthClipEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTdynamic state enabled thencmdSetSampleLocationsEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_sample_locationsextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetSampleLocationsEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXTdynamic state enabled thencmdSetColorBlendAdvancedEXTmust have been called in the current command buffer prior to this drawing command -
If the
VK_EXT_blend_operation_advancedextension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, then at least one ofcmdSetColorBlendEquationEXTandcmdSetColorBlendAdvancedEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_PROVOKING_VERTEX_MODE_EXTdynamic state enabled thencmdSetProvokingVertexModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_provoking_vertexextension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetProvokingVertexModeEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXTdynamic state enabled thencmdSetLineRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPolygonModeEXTin the current command buffer setpolygonModetoPOLYGON_MODE_LINE, thencmdSetLineRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPrimitiveTopologyin the current command buffer setprimitiveTopologyto any line topology, thencmdSetLineRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BITorSHADER_STAGE_GEOMETRY_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetLineRasterizationModeEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXTdynamic state enabled thencmdSetLineStippleEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPolygonModeEXTin the current command buffer setpolygonModetoPOLYGON_MODE_LINE, thencmdSetLineStippleEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object is bound to theSHADER_STAGE_VERTEX_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetPrimitiveTopologyin the current command buffer setprimitiveTopologyto any line topology, thencmdSetLineStippleEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object that outputs line primitives is bound to theSHADER_STAGE_TESSELLATION_EVALUATION_BITorSHADER_STAGE_GEOMETRY_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetLineStippleEnableEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_EXTdynamic state enabled thencmdSetLineStippleEXTmust have been called in the current command buffer prior to this drawing command - If the
VK_EXT_line_rasterizationextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetLineStippleEnableEXTin the current command buffer setstippledLineEnabletoTRUE, thencmdSetLineStippleEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_DEPTH_CLIP_NEGATIVE_ONE_TO_ONE_EXTdynamic state enabled thencmdSetDepthClipNegativeOneToOneEXTmust have been called in the current command buffer prior to this drawing command - If the
depthClipControl
feature is enabled, and a shader object is bound to any graphics
stage, then
cmdSetDepthClipNegativeOneToOneEXTmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_W_SCALING_ENABLE_NVdynamic state enabled thencmdSetViewportWScalingEnableNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_clip_space_w_scalingextension is enabled, and a shader object is bound to any graphics stage, thencmdSetViewportWScalingEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_SWIZZLE_NVdynamic state enabled thencmdSetViewportSwizzleNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_viewport_swizzleextension is enabled, and a shader object is bound to any graphics stage, thencmdSetViewportSwizzleNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NVdynamic state enabled thencmdSetCoverageToColorEnableNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_colorextension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetCoverageToColorEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_TO_COLOR_LOCATION_NVdynamic state enabled thencmdSetCoverageToColorLocationNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_fragment_coverage_to_colorextension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetCoverageToColorEnableNVin the current command buffer setcoverageToColorEnabletoTRUE, thencmdSetCoverageToColorLocationNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_MODE_NVdynamic state enabled thencmdSetCoverageModulationModeNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samplesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetCoverageModulationModeNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NVdynamic state enabled thencmdSetCoverageModulationTableEnableNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samplesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetCoverageModulationModeNVin the current command buffer set coverageModulationMode to any value other thanCOVERAGE_MODULATION_MODE_NONE_NV, thencmdSetCoverageModulationTableEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_NVdynamic state enabled thencmdSetCoverageModulationTableNVmust have been called in the current command buffer prior to this drawing command - If the
VK_NV_framebuffer_mixed_samplesextension is enabled, and a shader object is bound to any graphics stage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the most recent call tocmdSetCoverageModulationTableEnableNVin the current command buffer setcoverageModulationTableEnabletoTRUE, thencmdSetCoverageModulationTableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SHADING_RATE_IMAGE_ENABLE_NVdynamic state enabled thencmdSetShadingRateImageEnableNVmust have been called in the current command buffer prior to this drawing command -
If the
pipelineFragmentShadingRate
feature is enabled, and a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer set rasterizerDiscardEnable toFALSE, thencmdSetFragmentShadingRateKHRmust have been called in the current command buffer prior to this drawing command - If the
shadingRateImage
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetShadingRateImageEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_REPRESENTATIVE_FRAGMENT_TEST_ENABLE_NVdynamic state enabled thencmdSetRepresentativeFragmentTestEnableNVmust have been called in the current command buffer prior to this drawing command - If the
representativeFragmentTest
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetRepresentativeFragmentTestEnableNVmust have been called in the current command buffer prior to this drawing command - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_REDUCTION_MODE_NVdynamic state enabled thencmdSetCoverageReductionModeNVmust have been called in the current command buffer prior to this drawing command - If the
coverageReductionMode
feature is enabled, and a shader object is bound to any graphics
stage, and the most recent call to
cmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetCoverageReductionModeNVmust have been called in the current command buffer prior to this drawing command - If
the bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXTstate enabled and the last call tocmdSetColorBlendEnableEXTsetpColorBlendEnablesfor 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_EXTstate enabled, and the current subpass does not use any color and/or depth/stencil attachments, then therasterizationSamplesin the last call tocmdSetRasterizationSamplesEXTmust follow the rules for a zero-attachment subpass - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXTstate enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate disabled, then thesamplesparameter in the last call tocmdSetSampleMaskEXTmust be greater or equal to thePipelineMultisampleStateCreateInfo::rasterizationSamplesparameter used to create the bound graphics pipeline - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_MASK_EXTstate andDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstates enabled, then thesamplesparameter in the last call tocmdSetSampleMaskEXTmust be greater or equal to therasterizationSamplesparameter in the last call tocmdSetRasterizationSamplesEXT - If
the bound graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, and neither theVK_AMD_mixed_attachment_samplesnor theVK_NV_framebuffer_mixed_samplesextensions are enabled, then therasterizationSamplesin the last call tocmdSetRasterizationSamplesEXTmust be the same as the current subpass color and/or depth/stencil attachments - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, or a shader object is bound to any graphics stage, and the current render pass instance includes aMultisampledRenderToSingleSampledInfoEXTstructure withmultisampledRenderToSingleSampledEnableequal toTRUE, then therasterizationSamplesin the last call tocmdSetRasterizationSamplesEXTmust be the same as therasterizationSamplesmember of that structure - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXTdynamic state enabled thencmdSetColorBlendEnableEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorBlendEnableEXTcalls must specify an enable for all active color attachments in the current subpass -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorBlendEnableEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorBlendEnableEXTcalls 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_EXTdynamic state enabled thencmdSetColorBlendEquationEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorBlendEquationEXTcalls must specify the blend equations for all active color attachments in the current subpass where blending is enabled -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorBlendEquationEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorBlendEquationEXTcalls 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_EXTdynamic state enabled thencmdSetColorWriteMaskEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorWriteMaskEXTcalls must specify the color write mask for all active color attachments in the current subpass -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetColorWriteMaskEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorWriteMaskEXTcalls 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_EXTdynamic state enabled thencmdSetColorBlendAdvancedEXTmust have been called in the current command buffer prior to this drawing command, and the attachments specified by thefirstAttachmentandattachmentCountparameters ofcmdSetColorBlendAdvancedEXTcalls 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_EXTandDYNAMIC_STATE_COLOR_BLEND_ENABLE_EXTdynamic states enabled and the last calls tocmdSetColorBlendEnableEXTandcmdSetColorBlendAdvancedEXThave 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_EXTquery is active, and the bound graphics pipeline was created withDYNAMIC_STATE_RASTERIZATION_STREAM_EXTstate enabled, the last call tocmdSetRasterizationStreamEXTmust have set therasterizationStreamto zero -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate disabled, then thesampleLocationsPerPixelmember ofpSampleLocationsInfoin the last call tocmdSetSampleLocationsEXTmust equal therasterizationSamplesmember of thePipelineMultisampleStateCreateInfostructure the bound graphics pipeline has been created with -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate enabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, then thesampleLocationsPerPixelmember ofpSampleLocationsInfoin the last call tocmdSetSampleLocationsEXTmust equal therasterizationSamplesparameter of the last call tocmdSetRasterizationSamplesEXT -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, or the bound graphics pipeline was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, andsampleLocationsEnablewasTRUEin 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_EXTbit set -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, and ifsampleLocationsEnablewasTRUEin the last call tocmdSetSampleLocationsEnableEXT, then thesampleLocationsInfo.sampleLocationGridSize.widthin the last call tocmdSetSampleLocationsEXTmust evenly divideMultisamplePropertiesEXT::sampleLocationGridSize.widthas returned bygetPhysicalDeviceMultisamplePropertiesEXTwith asamplesparameter equalingrasterizationSamples -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate enabled and theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, and ifsampleLocationsEnablewasTRUEin the last call tocmdSetSampleLocationsEnableEXT, then thesampleLocationsInfo.sampleLocationGridSize.heightin the last call tocmdSetSampleLocationsEXTmust evenly divideMultisamplePropertiesEXT::sampleLocationGridSize.heightas returned bygetPhysicalDeviceMultisamplePropertiesEXTwith asamplesparameter equalingrasterizationSamples -
If a shader object is bound to the
SHADER_STAGE_FRAGMENT_BITstage, or the bound graphics pipeline state was created with theDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, and ifsampleLocationsEnablewasTRUEin the last call tocmdSetSampleLocationsEnableEXT, the fragment shader code must not statically use the extended instructionInterpolateAtSample -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, thesampleLocationsEnablemember of aPipelineSampleLocationsStateCreateInfoEXT::sampleLocationsEnablein the bound graphics pipeline isTRUEorDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, then,sampleLocationsInfo.sampleLocationGridSize.widthmust evenly divideMultisamplePropertiesEXT::sampleLocationGridSize.widthas returned bygetPhysicalDeviceMultisamplePropertiesEXTwith asamplesparameter equaling the value ofrasterizationSamplesin the last call tocmdSetRasterizationSamplesEXT -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, thesampleLocationsEnablemember of aPipelineSampleLocationsStateCreateInfoEXT::sampleLocationsEnablein the bound graphics pipeline isTRUEorDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, then,sampleLocationsInfo.sampleLocationGridSize.heightmust evenly divideMultisamplePropertiesEXT::sampleLocationGridSize.heightas returned bygetPhysicalDeviceMultisamplePropertiesEXTwith asamplesparameter equaling the value ofrasterizationSamplesin the last call tocmdSetRasterizationSamplesEXT -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_SAMPLE_LOCATIONS_EXTstate disabled and theDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstate enabled, thesampleLocationsEnablemember of aPipelineSampleLocationsStateCreateInfoEXT::sampleLocationsEnablein the bound graphics pipeline isTRUEorDYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXTstate enabled, then,sampleLocationsInfo.sampleLocationsPerPixelmust equalrasterizationSamplesin the last call tocmdSetRasterizationSamplesEXT -
If a shader object is bound to any graphics stage or the bound
graphics pipeline state was created with the
DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NVstate enabled, and the last call tocmdSetCoverageModulationTableEnableNVsetcoverageModulationTableEnabletoTRUE, then thecoverageModulationTableCountparameter in the last call tocmdSetCoverageModulationTableNVmust equal the currentrasterizationSamplesdivided by the number of color samples in the current subpass - If
the
VK_NV_framebuffer_mixed_samplesextension 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 currentrasterizationSamplesmust 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_NVstate enabled and the last call tocmdSetCoverageToColorEnableNVset thecoverageToColorEnabletoTRUE, then the current subpass must have a color attachment at the location selected by the last call tocmdSetCoverageToColorLocationNVcoverageToColorLocation, with aFormatofFORMAT_R8_UINT,FORMAT_R8_SINT,FORMAT_R16_UINT,FORMAT_R16_SINT,FORMAT_R32_UINT, orFORMAT_R32_SINT -
If the
VK_NV_fragment_coverage_to_colorextension is enabled, and a shader object is bound to theSHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, and the last call tocmdSetCoverageToColorEnableNVset thecoverageToColorEnabletoTRUE, then the current subpass must have a color attachment at the location selected by the last call tocmdSetCoverageToColorLocationNVcoverageToColorLocation, with aFormatofFORMAT_R8_UINT,FORMAT_R8_SINT,FORMAT_R16_UINT,FORMAT_R16_SINT,FORMAT_R32_UINT, orFORMAT_R32_SINT -
If this
VK_NV_coverage_reduction_modeextension is enabled, the bound graphics pipeline state was created with theDYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NVandDYNAMIC_STATE_RASTERIZATION_SAMPLES_EXTstates 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_COUNTdynamic state enabled, but not theDYNAMIC_STATE_VIEWPORT_SWIZZLE_NVdynamic state enabled, then the bound graphics pipeline must have been created withPipelineViewportSwizzleStateCreateInfoNV::viewportCountgreater or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
bound graphics pipeline state was created with the
DYNAMIC_STATE_VIEWPORT_WITH_COUNTandDYNAMIC_STATE_VIEWPORT_SWIZZLE_NVdynamic states enabled then theviewportCountparameter in the last call tocmdSetViewportSwizzleNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If the
VK_NV_viewport_swizzleextension is enabled, and a shader object is bound to any graphics stage, then theviewportCountparameter in the last call tocmdSetViewportSwizzleNVmust be greater than or equal to theviewportCountparameter in the last call tocmdSetViewportWithCount - If
the
VK_NV_framebuffer_mixed_samplesextension is enabled, and if the current subpass has any color attachments andrasterizationSamplesof the last call tocmdSetRasterizationSamplesEXTis greater than the number of color samples, then the pipelinesampleShadingEnablemust beFALSE - If
the bound graphics pipeline state was created with the
DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXTorDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXTdynamic states enabled, and if the currentstippledLineEnablestate isTRUEand the currentlineRasterizationModestate 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_EXTorDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXTdynamic states enabled, and if the currentstippledLineEnablestate isTRUEand the currentlineRasterizationModestate 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_EXTorDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXTdynamic states enabled, and if the currentstippledLineEnablestate isTRUEand the currentlineRasterizationModestate 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_EXTorDYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXTdynamic states enabled, and if the currentstippledLineEnablestate isTRUEand the currentlineRasterizationModestate isLINE_RASTERIZATION_MODE_DEFAULT_EXT, then the stippledRectangularLines feature must be enabled andPhysicalDeviceLimits::strictLinesmust beTRUE -
If the bound graphics pipeline state was created with the
DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXTdynamic 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 theconservativeRasterizationModeset by the last call tocmdSetConservativeRasterizationModeEXTmust beCONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT - If the currently
bound pipeline was created with the
PipelineShaderStageCreateInfo::stagemember of an element ofGraphicsPipelineCreateInfo::pStagesset toSHADER_STAGE_VERTEX_BIT,SHADER_STAGE_TESSELLATION_CONTROL_BIT,SHADER_STAGE_TESSELLATION_EVALUATION_BITorSHADER_STAGE_GEOMETRY_BIT, then Mesh Shader Queries must not be active - If the bound
graphics pipeline state was created with the
DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXTdynamic statecmdSetAttachmentFeedbackLoopEnableEXTmust have been called in the current command buffer prior to this drawing command - If dynamic state
was inherited from
CommandBufferInheritanceViewportScissorInfoNV, it must be set in the current command buffer prior to this drawing command - If there is no
bound graphics pipeline,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_VERTEX_BIT - If there is no
bound graphics pipeline, and the
tessellationShader
feature is enabled,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_TESSELLATION_CONTROL_BIT - If there is no
bound graphics pipeline, and the
tessellationShader
feature is enabled,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_TESSELLATION_EVALUATION_BIT - If there is no
bound graphics pipeline, and the
geometryShader
feature is enabled,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_GEOMETRY_BIT - If there is no
bound graphics pipeline,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_FRAGMENT_BIT - If there is no
bound graphics pipeline, and the
taskShader
feature is enabled,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_TASK_BIT_EXT - If there is no
bound graphics pipeline, and the
meshShader
feature is enabled,
cmdBindShadersEXTmust have been called in the current command buffer withpStageswith an element ofSHADER_STAGE_MESH_BIT_EXT - If there is no
bound graphics pipeline, and at least one of the
taskShader
and
meshShader
features is enabled, one of the
SHADER_STAGE_VERTEX_BITorSHADER_STAGE_MESH_BIT_EXTstages must have a validShaderEXTbound, and the other must have noShaderEXTbound - If there is no
bound graphics pipeline, and both the
taskShader
and
meshShader
features are enabled, and a valid
ShaderEXTis bound the to theSHADER_STAGE_MESH_BIT_EXTstage, and thatShaderEXTwas created without theSHADER_CREATE_NO_TASK_SHADER_BIT_EXTflag, a validShaderEXTmust be bound to theSHADER_STAGE_TASK_BIT_EXTstage - If there is no
bound graphics pipeline, and both the
taskShader
and
meshShader
features are enabled, and a valid
ShaderEXTis bound the to theSHADER_STAGE_MESH_BIT_EXTstage, and thatShaderEXTwas created with theSHADER_CREATE_NO_TASK_SHADER_BIT_EXTflag, there must be noShaderEXTbound to theSHADER_STAGE_TASK_BIT_EXTstage - If there is no
bound graphics pipeline, and a valid
ShaderEXTis bound to theSHADER_STAGE_VERTEX_BITstage, there must be noShaderEXTbound to either theSHADER_STAGE_TASK_BIT_EXTstage or theSHADER_STAGE_MESH_BIT_EXTstage - If any graphics
shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXTflag, then all shaders created with theSHADER_CREATE_LINK_STAGE_BIT_EXTflag in the samecreateShadersEXTcall must also be bound - If any graphics
shader is bound which was created with the
SHADER_CREATE_LINK_STAGE_BIT_EXTflag, any stages in between stages whose shaders which did not create a shader with theSHADER_CREATE_LINK_STAGE_BIT_EXTflag as part of the samecreateShadersEXTcall must not have anyShaderEXTbound - All bound graphics shader objects must have been created with identical or identically defined push constant ranges
- All bound graphics shader objects must have been created with identical or identically defined arrays of descriptor set layouts
- If
the current render pass instance was begun with
cmdBeginRenderingand aRenderingInfo::colorAttachmentCountequal to1, a color attachment with a resolve mode ofRESOLVE_MODE_EXTERNAL_FORMAT_DOWNSAMPLE_ANDROID, and a fragment shader is bound, it must not declare theDepthReplacingorStencilRefReplacingEXTexecution modes - If the
attachmentFeedbackLoopDynamicState
feature is enabled on the device, and a shader object is bound to
the
SHADER_STAGE_FRAGMENT_BITstage, and the most recent call tocmdSetRasterizerDiscardEnablein the current command buffer setrasterizerDiscardEnabletoFALSE, thencmdSetAttachmentFeedbackLoopEnableEXTmust have been called in the current command buffer prior to this drawing command - If the
bound graphics pipeline state includes a fragment shader stage, was
created with
DYNAMIC_STATE_DEPTH_WRITE_ENABLEset inPipelineDynamicStateCreateInfo::pDynamicStates, and the fragment shader declares theEarlyFragmentTestsexecution mode and usesOpDepthAttachmentReadEXT, thedepthWriteEnableparameter in the last call tocmdSetDepthWriteEnablemust beFALSE - If the
bound graphics pipeline state includes a fragment shader stage, was
created with
DYNAMIC_STATE_STENCIL_WRITE_MASKset inPipelineDynamicStateCreateInfo::pDynamicStates, and the fragment shader declares theEarlyFragmentTestsexecution mode and usesOpStencilAttachmentReadEXT, thewriteMaskparameter in the last call tocmdSetStencilWriteMaskmust be0 - If a shader object
is bound to any graphics stage or the currently bound graphics
pipeline was created with
DYNAMIC_STATE_COLOR_WRITE_MASK_EXT, and the format of any color attachment isFORMAT_E5B9G9R9_UFLOAT_PACK32, the corresponding element of thepColorWriteMasksparameter ofcmdSetColorWriteMaskEXTmust either include all ofCOLOR_COMPONENT_R_BIT,COLOR_COMPONENT_G_BIT, andCOLOR_COMPONENT_B_BIT, or none of them -
If
blending
is enabled for any attachment where either the source or destination
blend factors for that attachment
use the secondary color input,
the maximum value of
Locationfor any output attachment statically used in theFragmentExecutionModelexecuted by this command must be less than maxFragmentDualSrcAttachments - All vertex input
bindings accessed via vertex input variables declared in the vertex
shader entry point’s interface must have either valid or
NULL_HANDLEbuffers bound - If the
nullDescriptor
feature is not enabled, all vertex input bindings accessed via
vertex input variables declared in the vertex shader entry point’s
interface must not be
NULL_HANDLE - For a given vertex buffer binding, any attribute data fetched must be entirely contained within the corresponding vertex buffer binding, as described in ???
- If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_PRIMITIVE_TOPOLOGYdynamic state enabled thencmdSetPrimitiveTopologymust 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_PRIMITIVE_TOPOLOGYdynamic state enabled and the dynamicPrimitiveTopologyUnrestricted isFALSE, then theprimitiveTopologyparameter ofcmdSetPrimitiveTopologymust be of the same topology class as the pipelinePipelineInputAssemblyStateCreateInfo::topologystate - If the bound
graphics pipeline was created with both the
DYNAMIC_STATE_VERTEX_INPUT_EXTandDYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXTdynamic states enabled, thencmdSetVertexInputEXTmust have been called in the current command buffer prior to this draw command - If the bound
graphics pipeline was created with the
DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXTdynamic state enabled, but not theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled, thencmdBindVertexBuffers2EXTmust have been called in the current command buffer prior to this draw command, and thepStridesparameter ofcmdBindVertexBuffers2EXTmust not beNULL - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled thencmdSetVertexInputEXTmust have been called in the current command buffer prior to this draw command - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled then all variables with theInputstorage class decorated withLocationin theVertexExecutionModelOpEntryPointmust contain a location inVertexInputAttributeDescription2EXT::location - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled then the numeric type associated with allInputvariables of the correspondingLocationin theVertexExecutionModelOpEntryPointmust be the same asVertexInputAttributeDescription2EXT::format - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled andVertexInputAttributeDescription2EXT::formathas a 64-bit component, then the scalar width associated with allInputvariables of the correspondingLocationin theVertexExecutionModelOpEntryPointmust be 64-bit - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled and the scalar width associated with aLocationdecoratedInputvariable in theVertexExecutionModelOpEntryPointis 64-bit, then the correspondingVertexInputAttributeDescription2EXT::formatmust have a 64-bit component - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_VERTEX_INPUT_EXTdynamic state enabled andVertexInputAttributeDescription2EXT::formathas a 64-bit component, then allInputvariables at the correspondingLocationin theVertexExecutionModelOpEntryPointmust not use components that are not present in the format - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage and the most recent call tocmdSetPrimitiveTopologyin the current command buffer setprimitiveTopologytoPRIMITIVE_TOPOLOGY_PATCH_LIST, or the bound graphics pipeline state was created with theDYNAMIC_STATE_PATCH_CONTROL_POINTS_EXTdynamic state enabled thencmdSetPatchControlPointsEXTmust have been called in the current command buffer prior to this drawing command - If there is a
shader object bound to the
SHADER_STAGE_VERTEX_BITstage or the bound graphics pipeline state was created with theDYNAMIC_STATE_PRIMITIVE_RESTART_ENABLEdynamic state enabled thencmdSetPrimitiveRestartEnablemust have been called in the current command buffer prior to this drawing command - The bound
graphics pipeline must not have been created with the
PipelineShaderStageCreateInfo::stagemember of an element ofGraphicsPipelineCreateInfo::pStagesset toSHADER_STAGE_TASK_BIT_EXTorSHADER_STAGE_MESH_BIT_EXT - There must be no
shader object bound to either of the
SHADER_STAGE_TASK_BIT_EXTorSHADER_STAGE_MESH_BIT_EXTstages -
commandBuffermust not be a protected command buffer - If
isPreprocessedisTRUEthencmdPreprocessGeneratedCommandsNVmust have already been executed on the device, using the samepGeneratedCommandsInfocontent as well as the content of the input buffers it references (all exceptGeneratedCommandsInfoNV::preprocessBuffer). FurthermorepGeneratedCommandsInfo`sindirectCommandsLayoutmust have been created with theINDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NVbit set -
GeneratedCommandsInfoNV::pipelinemust match the current bound pipeline atGeneratedCommandsInfoNV::pipelineBindPoint - Transform feedback must not be active
- The ::deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
commandBuffermust be a validCommandBufferhandle
-
pGeneratedCommandsInfomust be a valid pointer to a validGeneratedCommandsInfoNVstructure -
commandBuffermust be in the recording state - The
CommandPoolthatcommandBufferwas allocated from must support graphics, or compute 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
commandBuffermust be externally synchronized
- Host access to the
CommandPoolthatcommandBufferwas 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 Compute | Action Indirection |
See Also
VK_NV_device_generated_commands,
Bool32,
CommandBuffer, GeneratedCommandsInfoNV
cmdPreprocessGeneratedCommandsNV Source #
Arguments
| :: forall io. MonadIO io | |
| => CommandBuffer |
|
| -> GeneratedCommandsInfoNV |
|
| -> io () |
vkCmdPreprocessGeneratedCommandsNV - Performs preprocessing for generated commands
Valid Usage
-
pGeneratedCommandsInfo`sindirectCommandsLayoutmust have been created with theINDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NVbit set - The ::deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
commandBuffermust be a validCommandBufferhandle
-
pGeneratedCommandsInfomust be a valid pointer to a validGeneratedCommandsInfoNVstructure -
commandBuffermust be in the recording state - The
CommandPoolthatcommandBufferwas allocated from must support graphics, or compute operations - This command must only be called outside of a render pass instance
- This command must only be called outside of a video coding scope
Host Synchronization
- Host access to
commandBuffermust be externally synchronized
- Host access to the
CommandPoolthatcommandBufferwas allocated from must be externally synchronized
Command Properties
'
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
| Primary Secondary | Outside | Outside | Graphics Compute | Action |
See Also
VK_NV_device_generated_commands,
CommandBuffer, GeneratedCommandsInfoNV
cmdBindPipelineShaderGroupNV Source #
Arguments
| :: forall io. MonadIO io | |
| => CommandBuffer |
|
| -> PipelineBindPoint |
|
| -> Pipeline |
|
| -> ("groupIndex" ::: Word32) |
|
| -> io () |
vkCmdBindPipelineShaderGroupNV - Bind a pipeline object
Valid Usage
-
groupIndexmust be0or less than the effectiveGraphicsPipelineShaderGroupsCreateInfoNV::groupCountincluding the referenced pipelines
- The
pipelineBindPointmust bePIPELINE_BIND_POINT_GRAPHICS - The same
restrictions as
cmdBindPipelineapply as if the bound pipeline was created only with the Shader Group from thegroupIndexinformation - The deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
commandBuffermust be a validCommandBufferhandle
-
pipelineBindPointmust be a validPipelineBindPointvalue -
pipelinemust be a validPipelinehandle -
commandBuffermust be in the recording state - The
CommandPoolthatcommandBufferwas allocated from must support graphics, or compute operations - This command must only be called outside of a video coding scope
- Both of
commandBuffer, andpipelinemust have been created, allocated, or retrieved from the sameDevice
Host Synchronization
- Host access to
commandBuffermust be externally synchronized
- Host access to the
CommandPoolthatcommandBufferwas allocated from must be externally synchronized
Command Properties
'
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
| Primary Secondary | Both | Outside | Graphics Compute | State |
See Also
VK_NV_device_generated_commands,
CommandBuffer, Pipeline,
PipelineBindPoint
getGeneratedCommandsMemoryRequirementsNV Source #
Arguments
| :: forall a io. (Extendss MemoryRequirements2 a, PokeChain a, PeekChain a, MonadIO io) | |
| => Device |
|
| -> GeneratedCommandsMemoryRequirementsInfoNV |
|
| -> io (MemoryRequirements2 a) |
vkGetGeneratedCommandsMemoryRequirementsNV - Retrieve the buffer allocation requirements for generated commands
Valid Usage
- The ::deviceGeneratedCommands feature must be enabled
- If
pInfo::pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, then the ::deviceGeneratedCompute feature must be enabled
Valid Usage (Implicit)
-
devicemust be a validDevicehandle
-
pInfomust be a valid pointer to a validGeneratedCommandsMemoryRequirementsInfoNVstructure -
pMemoryRequirementsmust be a valid pointer to aMemoryRequirements2structure
See Also
VK_NV_device_generated_commands,
Device,
GeneratedCommandsMemoryRequirementsInfoNV,
MemoryRequirements2
createIndirectCommandsLayoutNV Source #
Arguments
| :: forall io. MonadIO io | |
| => Device |
|
| -> IndirectCommandsLayoutCreateInfoNV |
|
| -> ("allocator" ::: Maybe AllocationCallbacks) |
|
| -> io IndirectCommandsLayoutNV |
vkCreateIndirectCommandsLayoutNV - Create an indirect command layout object
Valid Usage
- The ::deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
devicemust be a validDevicehandle
-
pCreateInfomust be a valid pointer to a validIndirectCommandsLayoutCreateInfoNVstructure - If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validAllocationCallbacksstructure -
pIndirectCommandsLayoutmust be a valid pointer to aIndirectCommandsLayoutNVhandle
Return Codes
See Also
VK_NV_device_generated_commands,
AllocationCallbacks,
Device, IndirectCommandsLayoutCreateInfoNV,
IndirectCommandsLayoutNV
withIndirectCommandsLayoutNV :: forall io r. MonadIO io => Device -> IndirectCommandsLayoutCreateInfoNV -> Maybe AllocationCallbacks -> (io IndirectCommandsLayoutNV -> (IndirectCommandsLayoutNV -> io ()) -> r) -> r Source #
A convenience wrapper to make a compatible pair of calls to
createIndirectCommandsLayoutNV and destroyIndirectCommandsLayoutNV
To ensure that destroyIndirectCommandsLayoutNV is always called: pass
bracket (or the allocate function from your
favourite resource management library) as the last argument.
To just extract the pair pass (,) as the last argument.
destroyIndirectCommandsLayoutNV Source #
Arguments
| :: forall io. MonadIO io | |
| => Device |
|
| -> IndirectCommandsLayoutNV |
|
| -> ("allocator" ::: Maybe AllocationCallbacks) |
|
| -> io () |
vkDestroyIndirectCommandsLayoutNV - Destroy an indirect commands layout
Valid Usage
-
If
AllocationCallbackswere provided whenindirectCommandsLayoutwas created, a compatible set of callbacks must be provided here -
If no
AllocationCallbackswere provided whenindirectCommandsLayoutwas created,pAllocatormust beNULL - The ::deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
devicemust be a validDevicehandle
-
If
indirectCommandsLayoutis notNULL_HANDLE,indirectCommandsLayoutmust be a validIndirectCommandsLayoutNVhandle - If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validAllocationCallbacksstructure -
If
indirectCommandsLayoutis a valid handle, it must have been created, allocated, or retrieved fromdevice
Host Synchronization
- Host access to
indirectCommandsLayoutmust be externally synchronized
See Also
VK_NV_device_generated_commands,
AllocationCallbacks,
Device,
IndirectCommandsLayoutNV
data PhysicalDeviceDeviceGeneratedCommandsFeaturesNV Source #
VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV - Structure describing the device-generated commands features that can be supported by an implementation
Members
This structure describes the following feature:
Description
If the PhysicalDeviceDeviceGeneratedCommandsFeaturesNV 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. PhysicalDeviceDeviceGeneratedCommandsFeaturesNV can also
be used in the pNext chain of DeviceCreateInfo
to selectively enable these features.
Valid Usage (Implicit)
See Also
Constructors
| PhysicalDeviceDeviceGeneratedCommandsFeaturesNV | |
Fields
| |
Instances
data PhysicalDeviceDeviceGeneratedCommandsPropertiesNV Source #
VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV - Structure describing push descriptor limits that can be supported by an implementation
Description
If the PhysicalDeviceDeviceGeneratedCommandsPropertiesNV structure is
included in the pNext chain of the
PhysicalDeviceProperties2
structure passed to
getPhysicalDeviceProperties2,
it is filled in with each corresponding implementation-dependent
property.
Valid Usage (Implicit)
See Also
Constructors
| PhysicalDeviceDeviceGeneratedCommandsPropertiesNV | |
Fields
| |
Instances
data GraphicsShaderGroupCreateInfoNV Source #
VkGraphicsShaderGroupCreateInfoNV - Structure specifying override parameters for each shader group
Valid Usage
- For
stageCount, the same restrictions as inGraphicsPipelineCreateInfo::stageCountapply
- For
pStages, the same restrictions as inGraphicsPipelineCreateInfo::pStagesapply - For
pVertexInputState, the same restrictions as inGraphicsPipelineCreateInfo::pVertexInputStateapply -
For
pTessellationState, the same restrictions as inGraphicsPipelineCreateInfo::pTessellationStateapply
Valid Usage (Implicit)
-
sTypemust beSTRUCTURE_TYPE_GRAPHICS_SHADER_GROUP_CREATE_INFO_NV
-
pNextmust beNULL -
pStagesmust be a valid pointer to an array ofstageCountvalidPipelineShaderStageCreateInfostructures -
stageCountmust be greater than0
See Also
VK_NV_device_generated_commands,
GraphicsPipelineShaderGroupsCreateInfoNV,
PipelineShaderStageCreateInfo,
PipelineTessellationStateCreateInfo,
PipelineVertexInputStateCreateInfo,
StructureType
Constructors
| GraphicsShaderGroupCreateInfoNV | |
Fields
| |
Instances
| Show GraphicsShaderGroupCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods showsPrec :: Int -> GraphicsShaderGroupCreateInfoNV -> ShowS # | |
| FromCStruct GraphicsShaderGroupCreateInfoNV Source # | |
| ToCStruct GraphicsShaderGroupCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods withCStruct :: GraphicsShaderGroupCreateInfoNV -> (Ptr GraphicsShaderGroupCreateInfoNV -> IO b) -> IO b Source # pokeCStruct :: Ptr GraphicsShaderGroupCreateInfoNV -> GraphicsShaderGroupCreateInfoNV -> IO b -> IO b Source # withZeroCStruct :: (Ptr GraphicsShaderGroupCreateInfoNV -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr GraphicsShaderGroupCreateInfoNV -> IO b -> IO b Source # cStructSize :: Int Source # | |
| Zero GraphicsShaderGroupCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods | |
data GraphicsPipelineShaderGroupsCreateInfoNV Source #
VkGraphicsPipelineShaderGroupsCreateInfoNV - Structure specifying parameters of a newly created multi shader group pipeline
Description
When referencing shader groups by index, groups defined in the
referenced pipelines are treated as if they were defined as additional
entries in pGroups. They are appended in the order they appear in the
pPipelines array and in the pGroups array when those pipelines were
defined.
The application must maintain the lifetime of all such referenced pipelines based on the pipelines that make use of them.
Valid Usage
-
groupCountmust be at least1and as maximumPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxGraphicsShaderGroupCount
-
The sum of
groupCountincluding those groups added from referencedpPipelinesmust also be as maximumPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxGraphicsShaderGroupCount - The
state of the first element of
pGroupsmust match its equivalent within the parent’sGraphicsPipelineCreateInfo - Each
element of
pGroupsmust in combination with the rest of the pipeline state yield a valid state configuration - All
elements of
pGroupsmust use the same shader stage combinations unless any mesh shader stage is used, then either combination of task and mesh or just mesh shader is valid - Mesh
and regular primitive shading stages cannot be mixed across
pGroups -
Each element of
pPipelinesmust have been created with identical state to the pipeline currently created except the state that can be overridden byGraphicsShaderGroupCreateInfoNV - The deviceGeneratedCommands feature must be enabled
Valid Usage (Implicit)
-
If
groupCountis not0,pGroupsmust be a valid pointer to an array ofgroupCountvalidGraphicsShaderGroupCreateInfoNVstructures -
If
pipelineCountis not0,pPipelinesmust be a valid pointer to an array ofpipelineCountvalidPipelinehandles
See Also
VK_NV_device_generated_commands,
GraphicsShaderGroupCreateInfoNV, Pipeline,
StructureType
Constructors
| GraphicsPipelineShaderGroupsCreateInfoNV | |
Fields
| |
Instances
data BindShaderGroupIndirectCommandNV Source #
VkBindShaderGroupIndirectCommandNV - Structure specifying input data for a single shader group command token
Valid Usage
- The current
bound graphics pipeline, as well as the pipelines it may reference,
must have been created with
PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV
- The
indexmust be within range of the accessible shader groups of the current bound graphics pipeline. SeecmdBindPipelineShaderGroupNVfor further details
See Also
Constructors
| BindShaderGroupIndirectCommandNV | |
Fields
| |
Instances
data BindIndexBufferIndirectCommandNV Source #
VkBindIndexBufferIndirectCommandNV - Structure specifying input data for a single index buffer command token
Valid Usage
- The buffer’s
usage flag from which the address was acquired must have the
BUFFER_USAGE_INDEX_BUFFER_BITbit set
- The
bufferAddressmust be aligned to theindexTypeused - Each element of
the buffer from which the address was acquired and that is
non-sparse must be bound completely and contiguously to a single
DeviceMemoryobject
Valid Usage (Implicit)
-
indexTypemust be a validIndexTypevalue
See Also
Constructors
| BindIndexBufferIndirectCommandNV | |
Fields
| |
Instances
data BindVertexBufferIndirectCommandNV Source #
VkBindVertexBufferIndirectCommandNV - Structure specifying input data for a single vertex buffer command token
Valid Usage
- The buffer’s
usage flag from which the address was acquired must have the
BUFFER_USAGE_VERTEX_BUFFER_BITbit set
- Each element
of the buffer from which the address was acquired and that is
non-sparse must be bound completely and contiguously to a single
DeviceMemoryobject
See Also
Constructors
| BindVertexBufferIndirectCommandNV | |
Fields
| |
Instances
data SetStateFlagsIndirectCommandNV Source #
VkSetStateFlagsIndirectCommandNV - Structure specifying input data for a single state flag command token
See Also
Constructors
| SetStateFlagsIndirectCommandNV | |
Fields
| |
Instances
data IndirectCommandsStreamNV Source #
VkIndirectCommandsStreamNV - Structure specifying input streams for generated command tokens
Valid Usage
- The
buffer’s usage flag must have theBUFFER_USAGE_INDIRECT_BUFFER_BITbit set
- The
offsetmust be aligned toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minIndirectCommandsBufferOffsetAlignment - If
bufferis non-sparse then it must be bound completely and contiguously to a singleDeviceMemoryobject
Valid Usage (Implicit)
-
buffermust be a validBufferhandle
See Also
VK_NV_device_generated_commands,
Buffer,
DeviceSize, GeneratedCommandsInfoNV
Constructors
| IndirectCommandsStreamNV | |
Fields
| |
Instances
data IndirectCommandsLayoutTokenNV Source #
VkIndirectCommandsLayoutTokenNV - Struct specifying the details of an indirect command layout token
Valid Usage
-
streammust be smaller thanIndirectCommandsLayoutCreateInfoNV::streamCount
-
offsetmust be less than or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectCommandsTokenOffset -
offsetmust be aligned to the scalar alignment oftokenTypeorminIndirectCommandsBufferOffsetAlignment, whichever is lower - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_VERTEX_BUFFER_NV,vertexBindingUnitmust stay within device supported limits for the appropriate commands - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV,pushconstantPipelineLayoutmust be valid - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV,pushconstantOffsetmust be a multiple of4 - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV,pushconstantSizemust be a multiple of4 - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV,pushconstantOffsetmust be less thanPhysicalDeviceLimits::maxPushConstantsSize - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV,pushconstantSizemust be less than or equal toPhysicalDeviceLimits::maxPushConstantsSizeminuspushconstantOffset - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV, for each byte in the range specified bypushconstantOffsetandpushconstantSizeand for each shader stage inpushconstantShaderStageFlags, there must be a push constant range inpushconstantPipelineLayoutthat includes that byte and that stage - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV, for each byte in the range specified bypushconstantOffsetandpushconstantSizeand for each push constant range that overlaps that byte,pushconstantShaderStageFlagsmust include all stages in that push constant range’sPushConstantRange::stageFlags - If
tokenTypeisINDIRECT_COMMANDS_TOKEN_TYPE_STATE_FLAGS_NV,indirectStateFlagsmust not be0
Valid Usage (Implicit)
-
sTypemust beSTRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_TOKEN_NV
-
pNextmust beNULL -
tokenTypemust be a validIndirectCommandsTokenTypeNVvalue -
If
pushconstantPipelineLayoutis notNULL_HANDLE,pushconstantPipelineLayoutmust be a validPipelineLayouthandle -
pushconstantShaderStageFlagsmust be a valid combination ofShaderStageFlagBitsvalues -
indirectStateFlagsmust be a valid combination ofIndirectStateFlagBitsNVvalues - If
indexTypeCountis not0,pIndexTypesmust be a valid pointer to an array ofindexTypeCountvalidIndexTypevalues - If
indexTypeCountis not0,pIndexTypeValuesmust be a valid pointer to an array ofindexTypeCountuint32_tvalues
See Also
VK_NV_device_generated_commands,
Bool32,
IndexType,
IndirectCommandsLayoutCreateInfoNV, IndirectCommandsTokenTypeNV,
IndirectStateFlagsNV, PipelineLayout,
ShaderStageFlags,
StructureType
Constructors
| IndirectCommandsLayoutTokenNV | |
Fields
| |
Instances
| Show IndirectCommandsLayoutTokenNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods showsPrec :: Int -> IndirectCommandsLayoutTokenNV -> ShowS # show :: IndirectCommandsLayoutTokenNV -> String # showList :: [IndirectCommandsLayoutTokenNV] -> ShowS # | |
| FromCStruct IndirectCommandsLayoutTokenNV Source # | |
| ToCStruct IndirectCommandsLayoutTokenNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods withCStruct :: IndirectCommandsLayoutTokenNV -> (Ptr IndirectCommandsLayoutTokenNV -> IO b) -> IO b Source # pokeCStruct :: Ptr IndirectCommandsLayoutTokenNV -> IndirectCommandsLayoutTokenNV -> IO b -> IO b Source # withZeroCStruct :: (Ptr IndirectCommandsLayoutTokenNV -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr IndirectCommandsLayoutTokenNV -> IO b -> IO b Source # cStructSize :: Int Source # | |
| Zero IndirectCommandsLayoutTokenNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods | |
data IndirectCommandsLayoutCreateInfoNV Source #
VkIndirectCommandsLayoutCreateInfoNV - Structure specifying the parameters of a newly created indirect commands layout object
Description
The following code illustrates some of the flags:
void cmdProcessAllSequences(cmd, pipeline, indirectCommandsLayout, pIndirectCommandsTokens, sequencesCount, indexbuffer, indexbufferOffset)
{
for (s = 0; s < sequencesCount; s++)
{
sUsed = s;
if (indirectCommandsLayout.flags & VK_INDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NV) {
sUsed = indexbuffer.load_uint32( sUsed * sizeof(uint32_t) + indexbufferOffset);
}
if (indirectCommandsLayout.flags & VK_INDIRECT_COMMANDS_LAYOUT_USAGE_UNORDERED_SEQUENCES_BIT_NV) {
sUsed = incoherent_implementation_dependent_permutation[ sUsed ];
}
cmdProcessSequence( cmd, pipeline, indirectCommandsLayout, pIndirectCommandsTokens, sUsed );
}
}When tokens are consumed, an offset is computed based on token offset
and stream stride. The resulting offset is required to be aligned. The
alignment for a specific token is equal to the scalar alignment of the
data type as defined in
Alignment Requirements,
or
PhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minIndirectCommandsBufferOffsetAlignment,
whichever is lower.
Note
A minIndirectCommandsBufferOffsetAlignment of 4 allows
DeviceAddress to be packed as uvec2
with scalar layout instead of uint64_t with 8 byte alignment. This
enables direct compatibility with D3D12 command signature layouts.
Valid Usage
-
The
pipelineBindPointmust bePIPELINE_BIND_POINT_GRAPHICSorPIPELINE_BIND_POINT_COMPUTE
-
tokenCountmust be greater than0and less than or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectCommandsTokenCount - If
pTokenscontains an entry ofINDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NVit must be the first element of the array and there must be only a single element of such token type - If
pTokenscontains an entry ofINDIRECT_COMMANDS_TOKEN_TYPE_STATE_FLAGS_NVthere must be only a single element of such token type - All state
tokens in
pTokensmust occur before any work provoking tokens (INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_NV,INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_INDEXED_NV,INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_TASKS_NV,INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_NV,INDIRECT_COMMANDS_TOKEN_TYPE_DISPATCH_NV) - The
content of
pTokensmust include one single work provoking token that is compatible with thepipelineBindPoint -
streamCountmust be greater than0and less or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectCommandsStreamCount -
each element of
pStreamStridesmust be greater than `0`and less than or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectCommandsStreamStride. Furthermore the alignment of each token input must be ensured -
If
pipelineBindPointisPIPELINE_BIND_POINT_COMPUTEthen the ::deviceGeneratedCompute feature must be enabled -
If
pipelineBindPointisPIPELINE_BIND_POINT_COMPUTEthen the state tokens inpTokensmust only includeINDIRECT_COMMANDS_TOKEN_TYPE_DISPATCH_NV,INDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV, orINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV -
If
pipelineBindPointisPIPELINE_BIND_POINT_COMPUTEandpTokensincludesINDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV, then the ::deviceGeneratedComputePipelines feature must be enabled
Valid Usage (Implicit)
-
sTypemust beSTRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_CREATE_INFO_NV
-
pNextmust beNULL -
flagsmust be a valid combination ofIndirectCommandsLayoutUsageFlagBitsNVvalues -
pipelineBindPointmust be a validPipelineBindPointvalue -
pTokensmust be a valid pointer to an array oftokenCountvalidIndirectCommandsLayoutTokenNVstructures -
pStreamStridesmust be a valid pointer to an array ofstreamCountuint32_tvalues -
tokenCountmust be greater than0 -
streamCountmust be greater than0
See Also
VK_NV_device_generated_commands,
IndirectCommandsLayoutTokenNV, IndirectCommandsLayoutUsageFlagsNV,
PipelineBindPoint,
StructureType,
createIndirectCommandsLayoutNV
Constructors
| IndirectCommandsLayoutCreateInfoNV | |
Fields
| |
Instances
| Show IndirectCommandsLayoutCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods showsPrec :: Int -> IndirectCommandsLayoutCreateInfoNV -> ShowS # | |
| FromCStruct IndirectCommandsLayoutCreateInfoNV Source # | |
| ToCStruct IndirectCommandsLayoutCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods withCStruct :: IndirectCommandsLayoutCreateInfoNV -> (Ptr IndirectCommandsLayoutCreateInfoNV -> IO b) -> IO b Source # pokeCStruct :: Ptr IndirectCommandsLayoutCreateInfoNV -> IndirectCommandsLayoutCreateInfoNV -> IO b -> IO b Source # withZeroCStruct :: (Ptr IndirectCommandsLayoutCreateInfoNV -> IO b) -> IO b Source # pokeZeroCStruct :: Ptr IndirectCommandsLayoutCreateInfoNV -> IO b -> IO b Source # cStructSize :: Int Source # | |
| Zero IndirectCommandsLayoutCreateInfoNV Source # | |
Defined in Vulkan.Extensions.VK_NV_device_generated_commands Methods | |
data GeneratedCommandsInfoNV Source #
VkGeneratedCommandsInfoNV - Structure specifying parameters for the generation of commands
Valid Usage
- If the
indirectCommandsLayoutuses a token ofINDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV, then thepipelinemust have been created with multiple shader groups - If the
indirectCommandsLayoutuses a token ofINDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV, then thepipelinemust have been created withPIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NVset inGraphicsPipelineCreateInfo::flags - If the
indirectCommandsLayoutuses a token ofINDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV, then thepipeline`sPipelineLayoutmust match theIndirectCommandsLayoutTokenNV::pushconstantPipelineLayout -
streamCountmust match theindirectCommandsLayout’sstreamCount - If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, then thepipelinemust have been created with the flagPIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV - If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, then thepipelinemust have been created with aComputePipelineIndirectBufferInfoNVstructure specifying a valid address where its metadata will be saved - If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, thencmdUpdatePipelineIndirectBufferNVmust have been called on that pipeline to save its metadata to a device address - If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, and ifINDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NVis used, thenpipelinemust beNULL_HANDLE -
sequencesCountmust be less or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectSequenceCountandGeneratedCommandsMemoryRequirementsInfoNV::maxSequencesCountthat was used to determine thepreprocessSize -
preprocessBuffermust have theBUFFER_USAGE_INDIRECT_BUFFER_BITbit set in its usage flag -
preprocessOffsetmust be aligned toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minIndirectCommandsBufferOffsetAlignment - If
preprocessBufferis non-sparse then it must be bound completely and contiguously to a singleDeviceMemoryobject -
preprocessSizemust be at least equal to the memory requirement`s size returned bygetGeneratedCommandsMemoryRequirementsNVusing the matching inputs (indirectCommandsLayout, …) as within this structure -
sequencesCountBuffercan be set if the actual used count of sequences is sourced from the provided buffer. In that case thesequencesCountserves as upper bound - If
sequencesCountBufferis notNULL_HANDLE, its usage flag must have theBUFFER_USAGE_INDIRECT_BUFFER_BITbit set - If
sequencesCountBufferis notNULL_HANDLE,sequencesCountOffsetmust be aligned toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minSequencesCountBufferOffsetAlignment - If
sequencesCountBufferis notNULL_HANDLEand is non-sparse then it must be bound completely and contiguously to a singleDeviceMemoryobject - If
indirectCommandsLayout’sINDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NVis set,sequencesIndexBuffermust be set otherwise it must beNULL_HANDLE - If
sequencesIndexBufferis notNULL_HANDLE, its usage flag must have theBUFFER_USAGE_INDIRECT_BUFFER_BITbit set - If
sequencesIndexBufferis notNULL_HANDLE,sequencesIndexOffsetmust be aligned toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minSequencesIndexBufferOffsetAlignment - If
sequencesIndexBufferis notNULL_HANDLEand is non-sparse then it must be bound completely and contiguously to a singleDeviceMemoryobject - If the
indirectCommandsLayoutuses a token ofINDIRECT_COMMANDS_TOKEN_TYPE_DRAW_TASKS_NV, then thepipelinemust contain a shader stage using theMeshNVExecutionModel - If the
indirectCommandsLayoutuses a token ofINDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_NV, then thepipelinemust contain a shader stage using theMeshEXTExecutionModel
Valid Usage (Implicit)
-
sTypemust beSTRUCTURE_TYPE_GENERATED_COMMANDS_INFO_NV
-
pNextmust beNULL -
pipelineBindPointmust be a validPipelineBindPointvalue -
pipelinemust be a validPipelinehandle -
indirectCommandsLayoutmust be a validIndirectCommandsLayoutNVhandle -
pStreamsmust be a valid pointer to an array ofstreamCountvalidIndirectCommandsStreamNVstructures -
preprocessBuffermust be a validBufferhandle - If
sequencesCountBufferis notNULL_HANDLE,sequencesCountBuffermust be a validBufferhandle - If
sequencesIndexBufferis notNULL_HANDLE,sequencesIndexBuffermust be a validBufferhandle -
streamCountmust be greater than0 - Each of
indirectCommandsLayout,pipeline,preprocessBuffer,sequencesCountBuffer, andsequencesIndexBufferthat are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the sameDevice
See Also
VK_NV_device_generated_commands,
Buffer,
DeviceSize,
IndirectCommandsLayoutNV,
IndirectCommandsStreamNV, Pipeline,
PipelineBindPoint,
StructureType,
cmdExecuteGeneratedCommandsNV, cmdPreprocessGeneratedCommandsNV
Constructors
| GeneratedCommandsInfoNV | |
Fields
| |
Instances
data GeneratedCommandsMemoryRequirementsInfoNV Source #
VkGeneratedCommandsMemoryRequirementsInfoNV - Structure specifying parameters for the reservation of preprocess buffer space
Valid Usage
-
maxSequencesCountmust be less or equal toPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectSequenceCount
-
If
pipelineBindPointis of typePIPELINE_BIND_POINT_GRAPHICS, thenpipelinemust be a validPipelinehandle -
If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, and theindirectCommandsLayoutwas not created with aINDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NVtoken, then thepipelinemust be a validPipelinehandle -
If
pipelineBindPointis of typePIPELINE_BIND_POINT_COMPUTE, and theindirectCommandsLayoutcontains aINDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NVtoken, then thepipelinemust beNULL
Valid Usage (Implicit)
-
pNextmust beNULL -
pipelineBindPointmust be a validPipelineBindPointvalue -
If
pipelineis notNULL_HANDLE,pipelinemust be a validPipelinehandle -
indirectCommandsLayoutmust be a validIndirectCommandsLayoutNVhandle - Both
of
indirectCommandsLayout, andpipelinethat are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the sameDevice
See Also
VK_NV_device_generated_commands,
IndirectCommandsLayoutNV,
Pipeline,
PipelineBindPoint,
StructureType,
getGeneratedCommandsMemoryRequirementsNV
Constructors
| GeneratedCommandsMemoryRequirementsInfoNV | |
Fields
| |
Instances
newtype IndirectCommandsLayoutUsageFlagBitsNV Source #
VkIndirectCommandsLayoutUsageFlagBitsNV - Bitmask specifying allowed usage of an indirect commands layout
See Also
VK_NV_device_generated_commands,
IndirectCommandsLayoutUsageFlagsNV
Constructors
| IndirectCommandsLayoutUsageFlagBitsNV Flags |
Bundled Patterns
| pattern INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV |
|
| pattern INDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV |
|
| pattern INDIRECT_COMMANDS_LAYOUT_USAGE_UNORDERED_SEQUENCES_BIT_NV :: IndirectCommandsLayoutUsageFlagBitsNV |
|
Instances
newtype IndirectStateFlagBitsNV Source #
VkIndirectStateFlagBitsNV - Bitmask specifying state that can be altered on the device
See Also
Constructors
| IndirectStateFlagBitsNV Flags |
Bundled Patterns
| pattern INDIRECT_STATE_FLAG_FRONTFACE_BIT_NV :: IndirectStateFlagBitsNV |
|
Instances
newtype IndirectCommandsTokenTypeNV Source #
VkIndirectCommandsTokenTypeNV - Enum specifying token commands
Description
'
Supported indirect command tokens
See Also
VK_NV_device_generated_commands,
IndirectCommandsLayoutTokenNV
Constructors
| IndirectCommandsTokenTypeNV Int32 |
Bundled Patterns
Instances
pattern NV_DEVICE_GENERATED_COMMANDS_SPEC_VERSION :: forall a. Integral a => a Source #
type NV_DEVICE_GENERATED_COMMANDS_EXTENSION_NAME = "VK_NV_device_generated_commands" Source #
pattern NV_DEVICE_GENERATED_COMMANDS_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #
newtype IndirectCommandsLayoutNV Source #
VkIndirectCommandsLayoutNV - Opaque handle to an indirect commands layout object
See Also
VK_NV_device_generated_commands,
GeneratedCommandsInfoNV,
GeneratedCommandsMemoryRequirementsInfoNV,
createIndirectCommandsLayoutNV,
destroyIndirectCommandsLayoutNV
Constructors
| IndirectCommandsLayoutNV Word64 |