mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-12 06:54:14 +00:00
26f0bdbf1e
* Update release number to 72.
Github Issues:
* Restructure the repository to put the specification `Makefile` and
associated spec source material at the top level, `vk.xml` and
associated scripts material in `xml/`, and generated include and source
files in `include/vulkan/` and `src/ext_loader/`, respectively (public
issue 436).
* Add missing bullet point markup to flink:vkCmdCopyImage valid usage
statement, so it gets a VUID assigned (public issue 627).
* Fix broken links in a couple of extension appendices (public pull
request 665).
* Add the \<platform> tag to the index in section 4.1 of the registry
schema documentation, and add the protect= attribute of \<extension>
tags to the comments in `registry.rnc` (public issues 673, 678).
* Add missing valid usage statements for sparse image interactions to
flink:VkImageCreateInfo (public pull request 675).
* Fix improper usage and grammar of "`can: not`" (public pull request
681).
* Remove duplicate spec language and NOTE on present layout between the
flink:vkAcquireNextImageKHR and flink:vkAcquireNextImage2KHR commands
(public pull request 685).
* Fix some typos and markup issues (public pull request 689; public issues
642, 667, 687).
* Fix typo etext:VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_FENCE_FD_BIT ->
ename:VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_SYNC_FD_BIT in the
<<external-semaphore-handle-types-compatibility, External semaphore
handle types compatibility>> table (public pull request 691).
Internal Issues:
* Remove the need for the "`noautovalidity`" attribute on extension
structures in `vk.xml`. It is now implied by the "`structextends`"
attribute instead (internal issue 942).
* Replace uses of "`currently bound`" with "`bound`", since "`currently`"
is redundant and distracting, and add a corresponding rule to the style
guide (internal issue 993).
* Fixed subtle issues with the last updates to flink:vkAcquireNextImageKHR
language that had resulted in ambiguities (internal issue 1178).
* Make it clear that only one query of a given type is allowed at a time
by reordering valid usage statements for flink:vkCmdBeginQuery and
flink:vkCmdEndQuery, and removing redundant ones (internal issue 1213).
* Swapped OL1 and OL3 in `tessparamUL.svg` to match previous version, and
fixed where "`(no edge)`" appears (internal issue 1215).
Other Issues:
* Fixed a minor problem with the valid usage statement extraction script,
and corresponding markup in the spec source.
New Extensions:
* `VK_AMD_shader_core_properties`
* `VK_EXT_descriptor_indexing`
* `VK_NV_shader_subgroup_partitioned`
101 lines
3.8 KiB
Plaintext
101 lines
3.8 KiB
Plaintext
include::meta/VK_EXT_descriptor_indexing.txt[]
|
|
|
|
*Status*::
|
|
Complete
|
|
*Last Modified Data*::
|
|
2017-10-02
|
|
*Contributors*::
|
|
- Jeff Bolz, NVIDIA
|
|
- Daniel Rakos, AMD
|
|
- Slawomir Grajewski, Intel
|
|
- Tobias Hector, Imagination Technologies
|
|
|
|
This extension adds several small features which together enable
|
|
applications to create large descriptor sets containing substantially all of
|
|
their resources, and selecting amongst those resources with dynamic
|
|
(non-uniform) indexes in the shader.
|
|
There are feature enables and SPIR-V capabilities for non-uniform descriptor
|
|
indexing in the shader, and non-uniform indexing in the shader requires use
|
|
of a new code:NonUniformEXT decoration defined in the
|
|
+SPV_EXT_descriptor_indexing+ SPIR-V extension.
|
|
There are descriptor set layout binding creation flags enabling several
|
|
features:
|
|
|
|
* Descriptors can be updated after they are bound to a command buffer,
|
|
such that the execution of the command buffer reflects the most recent
|
|
update to the descriptors.
|
|
* Descriptors that are not used by any pending command buffers can be
|
|
updated, which enables writing new descriptors for frame N+1 while frame
|
|
N is executing.
|
|
* Relax the requirement that all descriptors in a binding that is
|
|
"statically used" must be valid, such that descriptors that are not
|
|
accessed by a submission need not be valid and can be updated while that
|
|
submission is executing.
|
|
* The final binding in a descriptor set layout can have a variable size
|
|
(and unsized arrays of resources are allowed in the
|
|
+GL_EXT_nonuniform_qualifier+ and +SPV_EXT_descriptor_indexing+
|
|
extensions).
|
|
|
|
Note that it is valid for multiple descriptor arrays in a shader to use the
|
|
same set and binding number, as long as they are all compatible with the
|
|
descriptor type in the pipeline layout.
|
|
This means a single array binding in the descriptor set can serve multiple
|
|
texture dimensionalities, or an array of buffer descriptors can be used with
|
|
multiple different block layouts.
|
|
|
|
There are new descriptor set layout and descriptor pool creation flags that
|
|
are required to opt in to the update-after-bind functionality, and there are
|
|
separate pname:maxPerStage* and pname:maxDescriptorSet* limits that apply to
|
|
these descriptor set layouts which may: be much higher than the pre-existing
|
|
limits.
|
|
The old limits only count descriptors in non-updateAfterBind descriptor set
|
|
layouts, and the new limits count descriptors in all descriptor set layouts
|
|
in the pipeline layout.
|
|
|
|
=== New Object Types
|
|
|
|
None.
|
|
|
|
=== New Enum Constants
|
|
|
|
* Extending elink:VkStructureType:
|
|
** ename:VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_BINDING_FLAGS_CREATE_INFO_EXT
|
|
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_INDEXING_FEATURES_EXT
|
|
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_INDEXING_PROPERTIES_EXT
|
|
** ename:VK_STRUCTURE_TYPE_DESCRIPTOR_SET_VARIABLE_DESCRIPTOR_COUNT_ALLOCATE_INFO_EXT
|
|
** ename:VK_STRUCTURE_TYPE_DESCRIPTOR_SET_VARIABLE_DESCRIPTOR_COUNT_LAYOUT_SUPPORT_EXT
|
|
|
|
* Extending elink:VkDescriptorPoolCreateFlagBits:
|
|
** ename:VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT_EXT
|
|
|
|
* Extending elink:VkDescriptorSetLayoutCreateFlagBits:
|
|
** ename:VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT_EXT
|
|
|
|
* Extending elink:VkResult:
|
|
** ename:VK_ERROR_FRAGMENTATION_EXT
|
|
|
|
=== New Enums
|
|
|
|
* elink:VkDescriptorBindingFlagBitsEXT
|
|
|
|
=== New Structures
|
|
|
|
* slink:VkDescriptorSetLayoutBindingFlagsCreateInfoEXT
|
|
* slink:VkPhysicalDeviceDescriptorIndexingFeaturesEXT
|
|
* slink:VkPhysicalDeviceDescriptorIndexingPropertiesEXT
|
|
* slink:VkDescriptorSetVariableDescriptorCountAllocateInfoEXT
|
|
* slink:VkDescriptorSetVariableDescriptorCountLayoutSupportEXT
|
|
|
|
=== New Functions
|
|
|
|
None.
|
|
|
|
=== Issues
|
|
|
|
None.
|
|
|
|
=== Version History
|
|
|
|
* Revision 1, 2017-07-26 (Jeff Bolz)
|
|
- Internal revisions
|