mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-20 01:58:06 +00:00
f1a7c4b4f3
* Update release number to 98.
Public Issues:
* Fix missing markup in flink:vkDestroyPipelineLayout valid usage
statement (pull request 882).
* Add missing contributors for `<<VK_EXT_buffer_device_address>>` (public
pull request 891).
Internal Issues:
* Detect nested bullet points in valid usage blocks and warn about them
during VUID assignment (internal issue 1382).
* Update the style guide to document the process for reserving new bits in
bitmask types (internal issue 1411).
* Clarify for slink:VkApplicationInfo::pname:apiVersion and in the
<<fundamentals-validusage-versions, Valid Usage for Newer Core
Versions>> section when it is valid for an application to use a certain
version of Vulkan API functionality (for an instance and for a
device/physical device); and when the validation layers must generate an
error (internal issue 1412).
* Add optional <<memory-model-availability-visibility, transitive
availability/visibility operations to the memory model, including a new
pname:vulkanMemoryModelAvailabilityVisibilityChains feature for
slink:VkPhysicalDeviceVulkanMemoryModelFeaturesKHR (internal issue
1460).
* Add the code:StorageBuffer storage class to those in the
<<interfaces-resources-descset, Descriptor Set Interface>> (internal
issue 1480).
* Add missing `returnedonly` tags for a number of returned extension
structures that can be passed in pname:pNext chains (internal issue
1515).
* Clean up and rearrange some spec language for
slink:VkRenderPassCreateInfo and slink:VkAttachmentReference.txt
(internal issue 1522).
* Correctly round the code:OpVectorTimesScalar and
code:OpMatrixTimesScalar SPIR-V operations in the <<Precision of core
SPIR-V Instructions>> table (internal merge request 2996).
* Work around cases in flink:vkCmdBeginTransformFeedbackEXT,
flink:vkCmdEndTransformFeedbackEXT, and
slink:VkPipelineCoverageModulationStateCreateInfoNV where an array
parameter is `optional` but the length is not in `vk.xml`. This is an
interim fix using `noautovalidity` + handcoded VU replacing those that
should be autogenerated (internal issue 2944 and
https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/480).
* Remove redundant capability validation of the code:float16 and code:int8
SPIR-V capabilities from the <<spirvenv-capabilities, Capabilities>>
section, since they are already covered in the preceding table.
* Update check_spec_links script, including validation for reference page
open blocks. Fix errors identified by the script.
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
|