mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-25 12:35:11 +00:00
59750fe4c7
* Update release number to 121.
Github Issues:
* Add missing `structextends` attribute in `vk.xml` for
slink:VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR (public
issue 1018).
* Change attributes of flink:vkCmdCopyAccelerationStructureNV,
flink:vkCmdWriteAccelerationStructuresPropertiesNV,
flink:vkCmdBuildAccelerationStructureNV, and flink:vkCmdTraceRaysNV to
require that these commands execute outside renderpasses (public issue
1021).
* Add an issue to the `<<VK_EXT_buffer_device_address>>` appendix
discussing the introduction of new names and aliasing by equivalent old
names (public pull request 1024).
Internal Issues:
* Protect the `VK_KHR_sampler_mirror_clamp_to_edge` extension with
asciidoctor conditionals, and remove it from the core-only specification
builds, where it had previously been force-included in the Makefile. It
is now treated like any other extension (internal issue 1776).
* Edit some asciidoctor anchor names starting with `features-features-` to
just start with `features-`, since the old chapters was split into 3
pieces. There are still some mild naming inconsistencies with anchors
which may be addressed in the future (internal issue 1792).
* Add `KHR` alias for the non-suffixed extension token
ename:VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE, for compatibility
with naming rules for extensions (internal issue 1796).
* Clarify requirements for external memory in NOTEs for
sname:VkExternalMemoryBufferCreateInfo, and valid usage statements for
flink:vkBindBufferMemory, slink:VkBindBufferMemoryInfo,
flink:vkBindImageMemory, and slink:VkBindImageMemoryInfo (internal merge
request 3301).
* Make extension version numbers in `vk.xml` and extension appendices
consistent. In a few cases, we could not recover history at this
granularity, and left the summary of a version's change undefined
(internal merge request 3323).
* Fix invocation of `CodeInlineMacro` in the Ruby extension backing the
`code:` macro, which was delegating to the wrong base class (internal
merge request 3331).
* Modify `reg.py` to do a better job of recognizing equivalent <enum>
definitions.
* Add a `sortorder` attribute to XML feature and extension tags.
New Extensions
* `<<VK_AMD_device_coherent_memory>>`
103 lines
3.8 KiB
Plaintext
103 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
|
|
* Revision 2, 2017-10-02 (Jeff Bolz)
|
|
- ???
|