2019-10-06 12:42:12 -07:00
|
|
|
include::{generated}/meta/VK_NV_mesh_shader.txt[]
|
2018-09-15 18:35:16 -07:00
|
|
|
|
|
|
|
|
*Last Modified Date*::
|
|
|
|
|
2018-07-19
|
|
|
|
|
|
|
|
|
|
*Contributors*::
|
|
|
|
|
- Pat Brown, NVIDIA
|
|
|
|
|
- Jeff Bolz, NVIDIA
|
|
|
|
|
- Daniel Koch, NVIDIA
|
|
|
|
|
- Piers Daniell, NVIDIA
|
|
|
|
|
- Pierre Boudier, NVIDIA
|
|
|
|
|
|
|
|
|
|
This extension provides a new mechanism allowing applications to generate
|
|
|
|
|
collections of geometric primitives via programmable mesh shading.
|
|
|
|
|
It is an alternative to the existing programmable primitive shading
|
|
|
|
|
pipeline, which relied on generating input primitives by a fixed function
|
|
|
|
|
assembler as well as fixed function vertex fetch.
|
|
|
|
|
|
|
|
|
|
There are new programmable shader types -- the task and mesh shader -- to
|
|
|
|
|
generate these collections to be processed by fixed-function primitive
|
|
|
|
|
assembly and rasterization logic.
|
|
|
|
|
When the task and mesh shaders are dispatched, they replace the standard
|
|
|
|
|
programmable vertex processing pipeline, including vertex array attribute
|
|
|
|
|
fetching, vertex shader processing, tessellation, and the geometry shader
|
|
|
|
|
processing.
|
|
|
|
|
|
|
|
|
|
This extension also adds support for the following SPIR-V extension in
|
|
|
|
|
Vulkan:
|
Change log for August 17, 2019 Vulkan 1.1.120 spec update:
* Update release number to 120.
Github Issues:
* Add slink:VkAccelerationStructureTypeNV explicitly to extension XML for
`<<VK_NV_ray_tracing>>` (public issue 848).
* Add missing valid usage statements for feature flags in
slink:VkCommandBufferInheritanceInfo (public pull request 1017).
Internal Issues:
* Clarify behavior of non-premultiplied destination colors for
`<<VK_EXT_blend_operation_advanced>>` prior to the definition of
slink:VkBlendOverlapEXT (internal issue 1766).
* Fix the confusing phrasing "`no other queue must: be (doing something)`"
for flink:vkQueuePresentKHR, flink:vkQueueSubmit, and
flink:vkQueueBindSparse (internal issue 1774).
* Add `<<VK_EXT_validation_features>>` flag to enable best practices
checks, which will soon be available in the validation layer (internal
issue 1779).
* Specify allowed characters for VUID tag name components in the style
guide (internal issue 1788).
* Update links to SPIR-V extension specifications, and parameterize their
markup in case the URLs change in the future (internal issue 1797).
* Fix an off-by-one error in the valid usage statement for
slink:VkPipelineExecutableInfoKHR (internal merge request 3303).
* Clean up markup indentation not matching the style guide (internal merge
request 3314).
* Minor script updates to allow refpage aliases, generate a dynamic TOC
for refpages, generate Apache rewrite rules for aliases, open external
links from refpages in a new window, and synchronize with the OpenCL
scripts. This will shortly enable a paned navigation setup for refpages,
similar to the OpenCL 2.2 refpages (internal merge request 3322).
* Script updates to add tests to the checker, refactor and reformat code,
generate better text for some valid usage statements, use more Pythonic
idioms, and synchronize with the OpenXR scripts (internal merge request
3239).
* Script updates and minor fixes in spec language to not raise checker
errors for refpage markup of pages not existing in the API, such as
VKAPI_NO_STDINT_H. Remove corresponding suppression of some
check_spec_links.py tests from .gitlab-ci.yml and 'allchecks' target
(internal merge request 3315).
2019-08-17 15:33:21 -07:00
|
|
|
|
|
|
|
|
* {spirv}/NV/SPV_NV_mesh_shader.html[`SPV_NV_mesh_shader`]
|
2018-09-15 18:35:16 -07:00
|
|
|
|
|
|
|
|
=== New Object Types
|
|
|
|
|
|
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
=== New Enum Constants
|
|
|
|
|
|
|
|
|
|
* Extending elink:VkStructureType:
|
|
|
|
|
|
|
|
|
|
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_NV
|
|
|
|
|
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_NV
|
|
|
|
|
|
|
|
|
|
* Extending elink:VkShaderStageFlagBits
|
|
|
|
|
|
|
|
|
|
** ename:VK_SHADER_STAGE_TASK_BIT_NV
|
|
|
|
|
** ename:VK_SHADER_STAGE_MESH_BIT_NV
|
|
|
|
|
|
|
|
|
|
* Extending elink:VkPipelineStageFlagBits
|
|
|
|
|
|
|
|
|
|
** ename:VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV
|
|
|
|
|
** ename:VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV
|
|
|
|
|
|
|
|
|
|
=== New Enums
|
|
|
|
|
|
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
=== New Structures
|
|
|
|
|
|
|
|
|
|
* slink:VkPhysicalDeviceMeshShaderFeaturesNV
|
|
|
|
|
* slink:VkPhysicalDeviceMeshShaderPropertiesNV
|
|
|
|
|
* slink:VkDrawMeshTasksIndirectCommandNV
|
|
|
|
|
|
|
|
|
|
=== New Functions
|
|
|
|
|
|
|
|
|
|
* flink:vkCmdDrawMeshTasksNV
|
|
|
|
|
* flink:vkCmdDrawMeshTasksIndirectNV
|
|
|
|
|
* flink:vkCmdDrawMeshTasksIndirectCountNV
|
|
|
|
|
|
|
|
|
|
=== New or Modified Built-In Variables
|
|
|
|
|
|
|
|
|
|
* <<interfaces-builtin-variables-taskcount,TaskCountNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-primitivecount,PrimitiveCountNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-primitiveindices,PrimitiveIndicesNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-clipdistancepv,ClipDistancePerViewNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-culldistancepv,CullDistancePerViewNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-layerpv,LayerPerViewNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-meshviewcount,MeshViewCountNV>>
|
|
|
|
|
* <<interfaces-builtin-variables-meshviewindices,MeshViewIndicesNV>>
|
|
|
|
|
* (modified)code:Position
|
|
|
|
|
* (modified)code:PointSize
|
|
|
|
|
* (modified)code:ClipDistance
|
|
|
|
|
* (modified)code:CullDistance
|
|
|
|
|
* (modified)code:PrimitiveId
|
|
|
|
|
* (modified)code:Layer
|
|
|
|
|
* (modified)code:ViewportIndex
|
|
|
|
|
* (modified)code:WorkgroupSize
|
|
|
|
|
* (modified)code:WorkgroupId
|
|
|
|
|
* (modified)code:LocalInvocationId
|
|
|
|
|
* (modified)code:GlobalInvocationId
|
|
|
|
|
* (modified)code:LocalInvocationIndex
|
|
|
|
|
* (modified)code:DrawIndex
|
|
|
|
|
* (modified)code:ViewportMaskNV
|
|
|
|
|
* (modified)code:PositionPerViewNV
|
|
|
|
|
* (modified)code:ViewportMaskPerViewNV
|
|
|
|
|
|
|
|
|
|
=== New SPIR-V Capability
|
|
|
|
|
|
|
|
|
|
* <<spirvenv-capabilities-table-meshshading,MeshShadingNV>>
|
|
|
|
|
|
|
|
|
|
=== Issues
|
|
|
|
|
|
|
|
|
|
. How to name this extension?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: VK_NV_mesh_shader
|
|
|
|
|
|
|
|
|
|
Other options considered:
|
|
|
|
|
|
|
|
|
|
* VK_NV_mesh_shading
|
|
|
|
|
* VK_NV_programmable_mesh_shading
|
|
|
|
|
* VK_NV_primitive_group_shading
|
|
|
|
|
* VK_NV_grouped_drawing
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
. Do we need a new VkPrimitiveTopology?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: NO, we skip the InputAssembler stage
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
. Should we allow Instancing?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: NO, there is no fixed function input, other than the IDs.
|
|
|
|
|
However, allow offsetting with a "first" value.
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
. Should we use existing vkCmdDraw or introduce new functions?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: Introduce new functions.
|
|
|
|
|
|
|
|
|
|
New functions make it easier to separate from "programmable primitive
|
|
|
|
|
shading" chapter, less "dual use" language about existing functions having
|
|
|
|
|
alternative behavior.
|
|
|
|
|
The text around the existing "draws" is heavily based around emitting
|
|
|
|
|
vertices.
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
. If new functions, how to name?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: CmdDrawMeshTasks*
|
|
|
|
|
|
|
|
|
|
Other options considered:
|
|
|
|
|
|
|
|
|
|
* CmdDrawMeshed
|
|
|
|
|
* CmdDrawTasked
|
|
|
|
|
* CmdDrawGrouped
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
. Should VK_SHADER_STAGE_ALL_GRAPHICS be updated to include the new stages?
|
|
|
|
|
+
|
|
|
|
|
--
|
|
|
|
|
RESOLVED: No.
|
|
|
|
|
If an application were to be recompiled with headers that include additional
|
|
|
|
|
shader stage bits in VK_SHADER_STAGE_ALL_GRAPHICS, then the previously valid
|
|
|
|
|
application would no longer be valid on implementations that don't support
|
|
|
|
|
mesh or task shaders.
|
|
|
|
|
This means the change would not be backwards compatible.
|
|
|
|
|
It's too bad VkShaderStageFlagBits doesn't have a dedicated "all supported
|
|
|
|
|
graphics stages" bit like VK_PIPELINE_STAGE_ALL_GRAPHICS_BIT, which would
|
|
|
|
|
have avoided this problem.
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
=== Version History
|
|
|
|
|
|
|
|
|
|
* Revision 1, 2018-07-19 (Christoph Kubisch, Daniel Koch)
|
|
|
|
|
- Internal revisions
|