Skip to content

Commit

Permalink
Change log for May 28, 2023 Vulkan 1.3.251 spec update:
Browse files Browse the repository at this point in the history
Github Issues:

  * VUs for graphics pipelines have been reworked regarding state subsets,
    along with the sections describing those state subsets. VUs that
    previously ambiguously stated "`If the pipeline is _created with_ <state
    subset>...`" now instead state "`If the pipeline _requires_ <state
    subset>...`" Those VUs link to the state subset descriptions, which
    previously did not actually indicate anything about when they were
    required, which was instead left to the section on complete subsets. The
    subset sections now document their own independent requirements for when
    they are needed, so that the VUs explicitly point to relevant text.
    Additional VUs have also been added to mirror these updated sections,
    uncovering a handful of incorrect edge cases and clarifying them.
    Previous VUs that required a complete pipeline were now redundant, so
    have been removed. (public issue 1793).
  * Add missing code:SPV_EXT_opacity_micromap to XML (public pull request
    2131).
  * Fix typo in code:SPV_INTEL_shader_integer_functions2 XML (public pull
    request 2132).

Internal Issues

  * Use "`commands are called *in* a command buffer`" rather than "`*on* a
    command buffer`", and add this case to the style guide (internal issue
    3480).
  * Fix common draw dispatch VU 07753 for the
    slink:VkImageView::pname:format to match the code:OpTypeImage
    code:Sampled code:Type (internal issue 3481).
  * Create common draw and slink:VkGraphicsPipelineCreateInfo VUs for
    pname:alphaToCoverageEnable (internal merge request 5811).
  * Add elink:VkDynamicState entry for
    ename:VK_DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT (internal
    merge request 5894).
  * Use consistent wording for VUs referring to external memory handles
    (internal merge request 5895).
  * Remove redundant <<spirvenv-module-validation-standalone, Standalone
    SPIR-V Validation>> VU 04662 (internal merge request 5898).
  * Revert common draw VU 07620, which was accidentally removed by
    apiext:VK_EXT_shader_object (internal merge request 5899).
  * Allow slink:VkVideoDecodeInfoKhr::pname:pReferenceSlots to be `NULL` in
    its description (internal merge request 5900).
  * Fix slink:VkGraphicsPipelineCreateInfo pipeline topology VUs when
    pname:dynamicPrimitiveTopologyUnrestricted is set and the dynamic state
    is enabled (internal merge request 5916).

New Extensions

  * apiext:VK_EXT_dynamic_rendering_unused_attachments
  • Loading branch information
oddhack committed May 28, 2023
1 parent abefa12 commit 45b5ba6
Showing 27 changed files with 1,335 additions and 696 deletions.
53 changes: 53 additions & 0 deletions ChangeLog.adoc
Original file line number Diff line number Diff line change
@@ -14,6 +14,59 @@ appears frequently in the change log.

-----------------------------------------------------

Change log for May 28, 2023 Vulkan 1.3.251 spec update:

Github Issues:

* VUs for graphics pipelines have been reworked regarding state subsets,
along with the sections describing those state subsets. VUs that
previously ambiguously stated "`If the pipeline is _created with_ <state
subset>...`" now instead state "`If the pipeline _requires_ <state
subset>...`" Those VUs link to the state subset descriptions, which
previously did not actually indicate anything about when they were
required, which was instead left to the section on complete subsets. The
subset sections now document their own independent requirements for when
they are needed, so that the VUs explicitly point to relevant text.
Additional VUs have also been added to mirror these updated sections,
uncovering a handful of incorrect edge cases and clarifying them.
Previous VUs that required a complete pipeline were now redundant, so
have been removed. (public issue 1793).
* Add missing code:SPV_EXT_opacity_micromap to XML (public pull request
2131).
* Fix typo in code:SPV_INTEL_shader_integer_functions2 XML (public pull
request 2132).

Internal Issues

* Use "`commands are called *in* a command buffer`" rather than "`*on* a
command buffer`", and add this case to the style guide (internal issue
3480).
* Fix common draw dispatch VU 07753 for the
slink:VkImageView::pname:format to match the code:OpTypeImage
code:Sampled code:Type (internal issue 3481).
* Create common draw and slink:VkGraphicsPipelineCreateInfo VUs for
pname:alphaToCoverageEnable (internal merge request 5811).
* Add elink:VkDynamicState entry for
ename:VK_DYNAMIC_STATE_ATTACHMENT_FEEDBACK_LOOP_ENABLE_EXT (internal
merge request 5894).
* Use consistent wording for VUs referring to external memory handles
(internal merge request 5895).
* Remove redundant <<spirvenv-module-validation-standalone, Standalone
SPIR-V Validation>> VU 04662 (internal merge request 5898).
* Revert common draw VU 07620, which was accidentally removed by
apiext:VK_EXT_shader_object (internal merge request 5899).
* Allow slink:VkVideoDecodeInfoKhr::pname:pReferenceSlots to be `NULL` in
its description (internal merge request 5900).
* Fix slink:VkGraphicsPipelineCreateInfo pipeline topology VUs when
pname:dynamicPrimitiveTopologyUnrestricted is set and the dynamic state
is enabled (internal merge request 5916).

New Extensions

* apiext:VK_EXT_dynamic_rendering_unused_attachments

-----------------------------------------------------

Change log for May 4, 2023 Vulkan 1.3.250 spec update:

Github Issues:
4 changes: 2 additions & 2 deletions Makefile
Original file line number Diff line number Diff line change
@@ -105,7 +105,7 @@ VERBOSE =
# ADOCOPTS options for asciidoc->HTML5 output

NOTEOPTS = -a editing-notes -a implementation-guide
PATCHVERSION = 250
PATCHVERSION = 251

ifneq (,$(findstring VK_VERSION_1_3,$(VERSIONS)))
SPECMINOR = 3
@@ -385,7 +385,7 @@ check-contractions:
fi

# Look for typos and suggest fixes
CODESPELL = codespell --config config/CI/codespellrc -S '*.js' -S './antora*/*' -S 'ERRS*,*.pdf'
CODESPELL = codespell --config config/CI/codespellrc -S '*.js,*.pdf,*.html,ERRS*,./antora*/*'
check-spelling:
if ! $(CODESPELL) > /dev/null ; then \
echo "Found probable misspellings. Corrections can be added to config/CI/codespell-allowed:" ; \
40 changes: 40 additions & 0 deletions appendices/VK_EXT_dynamic_rendering_unused_attachments.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
// Copyright 2019-2023 The Khronos Group Inc.
//
// SPDX-License-Identifier: CC-BY-4.0

include::{generated}/meta/{refprefix}VK_EXT_dynamic_rendering_unused_attachments.adoc[]

=== Other Extension Metadata

*Last Modified Date*::
2023-05-22
*IP Status*::
No known IP claims.
*Contributors*::
- Daniel Story, Nintendo
- Hans-Kristian Arntzen, Valve
- Jan-Harald Fredriksen, Arm
- James Fitzpatrick, Imagination Technologies
- Pan Gao, Huawei Technologies
- Ricardo Garcia, Igalia
- Stu Smith, AMD

=== Description

This extension lifts some restrictions in the
`apiext:VK_KHR_dynamic_rendering` extension to allow render pass instances
and bound pipelines within those render pass instances to have an unused
attachment specified in one but not the other.
It also allows pipelines to use different formats in a render pass as long
the attachment is NULL.

include::{generated}/interfaces/VK_EXT_dynamic_rendering_unused_attachments.adoc[]

=== Issues

None.

=== Version History

* Revision 1, 2023-05-22 (Piers Daniell)
** Internal revisions
8 changes: 4 additions & 4 deletions appendices/VK_EXT_robustness2.adoc
Original file line number Diff line number Diff line change
@@ -39,10 +39,10 @@ include::{generated}/interfaces/VK_EXT_robustness2.adoc[]
=== Issues

1. Why do
slink:VkPhysicalDeviceRobustness2PropertiesEXT::pname:robustUniformBufferAccessSizeAlignment
and
slink:VkPhysicalDeviceRobustness2PropertiesEXT::pname:robustStorageBufferAccessSizeAlignment
exist?
slink:VkPhysicalDeviceRobustness2PropertiesEXT::pname:robustUniformBufferAccessSizeAlignment
and
slink:VkPhysicalDeviceRobustness2PropertiesEXT::pname:robustStorageBufferAccessSizeAlignment
exist?

*RESOLVED*: Some implementations cannot efficiently tightly bounds-check all
buffer accesses.
4 changes: 2 additions & 2 deletions appendices/VK_EXT_shader_tile_image.adoc
Original file line number Diff line number Diff line change
@@ -12,9 +12,9 @@ include::{generated}/meta/{refprefix}VK_EXT_shader_tile_image.adoc[]
No known IP claims.
*Interactions and External Dependencies*::
- This extension requires
{spirv}/EXT/SPV_EXT_shader_tile_image.html[`SPV_EXT_shader_tile_image`]
{spirv}/EXT/SPV_EXT_shader_tile_image.html[`SPV_EXT_shader_tile_image`]
- This extension provides API support for
https://raw.githubusercontent.com/KhronosGroup/GLSL/master/extensions/ext/GL_EXT_shader_tile_image.txt[`GL_EXT_shader_tile_image`]
https://raw.githubusercontent.com/KhronosGroup/GLSL/master/extensions/ext/GL_EXT_shader_tile_image.txt[`GL_EXT_shader_tile_image`]

*Contributors*::
- Sandeep Kakarlapudi, Arm
3 changes: 0 additions & 3 deletions appendices/spirvenv.adoc
Original file line number Diff line number Diff line change
@@ -274,9 +274,6 @@ or knowledge of runtime information, such as enabled features.
* [[VUID-{refpage}-Uniform-06925]]
Any variable in the code:Uniform {StorageClass} decorated as code:Block
must: not be stored to or modified
* [[VUID-{refpage}-Offset-04662]]
Any image operation must: use at most one of the code:Offset,
code:ConstOffset, and code:ConstOffsets image operands
* [[VUID-{refpage}-Offset-04663]]
Image operand code:Offset must: only be used with code:OpImage*Gather
instructions
Original file line number Diff line number Diff line change
@@ -8,7 +8,7 @@ The sname:VkSwapchainPresentModeInfoEXT structure is defined as:

include::{generated}/api/structs/VkSwapchainPresentModeInfoEXT.adoc[]

* pname:sType is the type of this structure
* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to a structure extending this
structure.
* pname:swapchainCount is the number of swapchains being presented to by
@@ -80,7 +80,7 @@ endif::VK_KHR_shared_presentable_image[]
slink:VkPresentInfoKHR::pname:swapchainCount
* [[VUID-VkSwapchainPresentModeInfoEXT-pPresentModes-07761]]
Each entry in pname:pPresentModes must be a presentation mode specified
in slink:VkSwapchainPresentModesCreateInfoEXT::pPresentModes when
in slink:VkSwapchainPresentModesCreateInfoEXT::pname:pPresentModes when
creating the entry's corresponding swapchain
****

2 changes: 1 addition & 1 deletion chapters/capabilities.adoc
Original file line number Diff line number Diff line change
@@ -1315,7 +1315,7 @@ or the equivalent
include::{generated}/api/structs/VkExternalSemaphorePropertiesKHR.adoc[]
endif::VK_KHR_external_semaphore_capabilities[]

* pname:sType is the type of this structure
* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to a structure extending this
structure.
* pname:exportFromImportedHandleTypes is a bitmask of
4 changes: 2 additions & 2 deletions chapters/cmdbuffers.adoc
Original file line number Diff line number Diff line change
@@ -1048,7 +1048,7 @@ or the equivalent
include::{generated}/api/structs/VkCommandBufferInheritanceRenderingInfoKHR.adoc[]
endif::VK_KHR_dynamic_rendering[]

* pname:sType is the type of this structure
* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to a structure extending this
structure
* pname:flags is a bitmask of elink:VkRenderingFlagBits used by the render
@@ -1163,7 +1163,7 @@ ifdef::VK_NV_framebuffer_mixed_samples[]
include::{generated}/api/structs/VkAttachmentSampleCountInfoNV.adoc[]
endif::VK_NV_framebuffer_mixed_samples[]

* pname:sType is the type of this structure
* pname:sType is the type of this structure.
* pname:pNext is `NULL` or a pointer to a structure extending this
structure
* pname:colorAttachmentCount is the number of color attachments specified
Loading

0 comments on commit 45b5ba6

Please sign in to comment.