Change log for January 17, 2025 Vulkan 1.4.305 spec update:

Github Issues * Clarify dynamic array layer access in common draw dispatch VU 09600 and the <<resources-image-layouts, Image Layouts>> introduction (public issue 2474). * Remove Ash CI in both Github and Gitlab (public PR 2479). Internal Issues * Consolidate common draw discard rectangle VUs and clarify behavior (internal issue 3400). * Clarify the maxMemoryAllocationSize limit (internal issue 4119). * Restrict vkCmdExecuteCommands VU 09376 to secondary command buffers (internal issue 4126). * Fix AV1 decode frameHeaderOffset typo in vkCmdDecodeVideoKHR VU 09251 (internal MR 7043). * Add more detail about VkAccelerationStructureCreateInfoKHR::deviceAddress (internal MR 7067). * Clarify ambiguities related to <<decode-av1-picture-info, AV1 decode parameters>> FeatureEnabled, FeatureData, loop_filter_ref_deltas, and loop_filter_mode_deltas (internal MR 7070). * Remove common buffer memory barrier and image memory barrier VUs already converted by VUIDs 10387 and 10388 (internal MR 7075). * Remove redundant VkShaderCreateInfoEXT VUs 08452 and 08458 (internal MR 7076). * Fix typo in VkSwapchainPresentScalingCreateInfoEXT VU 10154 (internal MR 7077). * Remove redundant explicit VkPhysicalDeviceSurfaceCapabilitiesKHR VU 06523 (internal MR 7078). * Remove redundant VkWriteDescriptorSetAccelerationStructureKHR and VkWriteDescriptorSetAccelerationStructureNV VUs 02236 and 03747 (internal MR 7079). * Remove redundant vkCmdBindShadersEXT feature bit VUs 08474, 08475, 08490, and 08491, (internal MR 7083). * Revert vkCmdWaitEvents2 dependencyFlags VU that should not have been removed (internal MR 7089). * Reword common draw vertex binding vertex attribute VU 10390 (internal MR 7091). * Fix asciidoctor markup for the VK_QCOM_image_processing proposal and update some descriptions (internal MR 7097). New Extensions * VK_ARM_pipeline_opacity_micromap * VK_KHR_depth_clamp_zero_one * VK_KHR_maintenance8
KhronosGroup · Jan 17, 2025 · 840c7b8 · 840c7b8
1 parent 9215858
commit 840c7b8
Show file tree

Hide file tree

Showing 843 changed files with 1,994 additions and 1,132 deletions.
diff --git a/.gitattributes b/.gitattributes
@@ -1,4 +1,4 @@
-# Copyright 2015-2024 The Khronos Group Inc.
+# Copyright 2015-2025 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

diff --git a/.github/ISSUE_TEMPLATE/roadmap-feedback.md b/.github/ISSUE_TEMPLATE/roadmap-feedback.md
@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 <!--
-Copyright 2018-2024 The Khronos Group Inc.
+Copyright 2018-2025 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.github/ISSUE_TEMPLATE/template-for-release-task-list.md b/.github/ISSUE_TEMPLATE/template-for-release-task-list.md
@@ -9,7 +9,7 @@ assignees: ''
 ---
 
 <!--
-- Copyright 2019-2024 The Khronos Group Inc.
+- Copyright 2019-2025 The Khronos Group Inc.
 -
 - SPDX-License-Identifier: CC-BY-4.0
 -

diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,4 @@
-# Copyright 2015-2024 The Khronos Group Inc.
+# Copyright 2015-2025 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
@@ -1,4 +1,4 @@
-# Copyright 2018-2024 The Khronos Group Inc.
+# Copyright 2018-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Gitlab CI file for vulkan spec and header generation
@@ -152,43 +152,6 @@ hpp-generate:
     expire_in: 1 week
   allow_failure: true
 
-# Regenerate Rust bindings (Ash crate)
-ash-generate:
-  image: khronosgroup/docker-images@sha256:cf554c9cf5d0322e022f0be32efad9bff44ada4b32653bfdc8033cba22972fa2
-  stage: build
-  needs:
-    - spec-generate # For the full include/ directory
-  cache: # Generator has lots of dependencies that take a while to download/compile
-    key: cargo-ash-generator
-    paths:
-      - cargo-cache
-      - ash-target
-  before_script:
-    - SPEC_DIR="${PWD}"
-    - rm -rf ash
-    - git clone https://github.com/ash-rs/ash
-    - pushd ash
-    # Piece together minimal Vulkan-Headers - Ash only needs headers and vk.xml
-    - rm -rf generator/Vulkan-Headers/* # Should already be empty, just in case
-    - ln -s ${SPEC_DIR}/gen/include generator/Vulkan-Headers/ # Complete headers come from spec-generate
-    - ln -s ${SPEC_DIR}/xml generator/Vulkan-Headers/registry # vk.xml sits in the root of this spec repo
-    # Move to root directory to be picked up by `cache` step
-    - export CARGO_HOME="${SPEC_DIR}/cargo-cache"
-    - export CARGO_TARGET_DIR="${SPEC_DIR}/ash-target"
-  script:
-    - cargo run -p generator
-    - cargo fmt --all
-  after_script:
-    # Make the folder a single level deep
-    - mv ash/ash ash-crate
-    - rm -rf ash/
-    - mv ash-crate ash
-  artifacts:
-    paths:
-      - ash
-    expire_in: 1 week
-  allow_failure: true
-
 # Run the CTS Vulkan framework tests, to make sure XML changes will not
 # cause problems there.
 cts-framework-tests:
@@ -231,25 +194,3 @@ hpp-compile:
     - g++ -c -std=c++11 -Igen/include -IVulkan-Hpp -Wall -Wextra -Werror tests/hpptest.cpp
     - clang++ -c -std=c++11 -Igen/include -IVulkan-Hpp -Wall -Wextra -Werror tests/hpptest.cpp
   allow_failure: true
-
-# Build-test Rust bindings (Ash crate)
-ash-compile:
-  image: khronosgroup/docker-images@sha256:cf554c9cf5d0322e022f0be32efad9bff44ada4b32653bfdc8033cba22972fa2
-  stage: test
-  needs:
-    - ash-generate
-  cache:
-    key:
-      files:
-        - ash/Cargo.toml
-    paths:
-      - cargo-cache
-      - ash-target
-  before_script:
-    - export CARGO_HOME="${SPEC_DIR}/cargo-cache"
-    - export CARGO_TARGET_DIR="${SPEC_DIR}/ash-target"
-  script:
-    - cd ash
-    # Build-test the ash crate
-    - cargo clippy --all --all-targets
-  allow_failure: true
diff --git a/.gitlab/issue_templates/EXT_release_checklist.md b/.gitlab/issue_templates/EXT_release_checklist.md
@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2024 The Khronos Group Inc.
+Copyright 2018-2025 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.gitlab/issue_templates/KHR_release_checklist.md b/.gitlab/issue_templates/KHR_release_checklist.md
@@ -1,5 +1,5 @@
 <!--
-Copyright 2018-2024 The Khronos Group Inc.
+Copyright 2018-2025 The Khronos Group Inc.
 
 SPDX-License-Identifier: CC-BY-4.0
 -->

diff --git a/.mailmap b/.mailmap
@@ -1,4 +1,4 @@
-# Copyright 2023-2024 The Khronos Group Inc.
+# Copyright 2023-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: CC-BY-4.0
 
 Faith Ekstrand <[email protected]> <[email protected]>

diff --git a/.reuse/dep5 b/.reuse/dep5
@@ -3,7 +3,7 @@ Upstream-Name: Vulkan-Docs
 Source: https://github.com/KhronosGroup/Vulkan-Docs
 
 Files: images/*.svg config/chunkindex/custom.patch config/CI/* config/*/docinfo-header.html build_tests/expectations/* build_tests/images/*.svg images/proposals/*.svg
-Copyright: 2015-2024 The Khronos Group Inc.
+Copyright: 2015-2025 The Khronos Group Inc.
 License: CC-BY-4.0
 
 Files: katex/*
@@ -32,11 +32,11 @@ Copyright: 1998-2006 MACS, Inc.
 License: MIT
 
 Files: *.json scripts/vuidCounts.py config/chunkindex/addscript.*
-Copyright: 2020-2024 The Khronos Group Inc.
+Copyright: 2020-2025 The Khronos Group Inc.
 License: Apache-2.0
 
 Files: config/copyright-spec.adoc
-Copyright: 2014-2024 The Khronos Group Inc
+Copyright: 2014-2025 The Khronos Group Inc
 License: LicenseRef-KhronosSpecCopyright
 
 Files: scripts/asciidoctor-chunker/*

diff --git a/BUILD.adoc b/BUILD.adoc
@@ -1,4 +1,4 @@
-// Copyright 2014-2024 The Khronos Group Inc.
+// Copyright 2014-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan^(R)^ Specification Build Instructions and Notes

diff --git a/CODE_OF_CONDUCT.adoc b/CODE_OF_CONDUCT.adoc
@@ -1,4 +1,4 @@
-// Copyright 2018-2024 The Khronos Group Inc.
+// Copyright 2018-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Code of Conduct

diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 The Khronos Group Inc.
+// Copyright 2020-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Contributing

diff --git a/COPYING.adoc b/COPYING.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 The Khronos Group Inc.
+// Copyright 2020-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = COPYING File for the KhronosGroup/Vulkan-Docs Project

diff --git a/ChangeLog.adoc b/ChangeLog.adoc
@@ -1,4 +1,4 @@
-Copyright 2016-2024 The Khronos Group Inc.
+Copyright 2016-2025 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the Vulkan-Docs repository on GitHub. Updates are in reverse
@@ -14,6 +14,57 @@ appears frequently in the change log.
 
 '''
 
+Change log for January 17, 2025 Vulkan 1.4.305 spec update:
+
+Github Issues
+
+  * Clarify dynamic array layer access in common draw dispatch VU 09600 and
+    the <<resources-image-layouts, Image Layouts>> introduction (public
+    issue 2474).
+  * Remove Ash CI in both Github and Gitlab (public PR 2479).
+
+Internal Issues
+
+  * Consolidate common draw discard rectangle VUs and clarify behavior
+    (internal issue 3400).
+  * Clarify the maxMemoryAllocationSize limit (internal issue 4119).
+  * Restrict vkCmdExecuteCommands VU 09376 to secondary command buffers
+    (internal issue 4126).
+  * Fix AV1 decode frameHeaderOffset typo in vkCmdDecodeVideoKHR VU 09251
+    (internal MR 7043).
+  * Add more detail about
+    VkAccelerationStructureCreateInfoKHR::deviceAddress (internal MR 7067).
+  * Clarify ambiguities related to <<decode-av1-picture-info, AV1 decode
+    parameters>> FeatureEnabled, FeatureData, loop_filter_ref_deltas, and
+    loop_filter_mode_deltas (internal MR 7070).
+  * Remove common buffer memory barrier and image memory barrier VUs already
+    converted by VUIDs 10387 and 10388 (internal MR 7075).
+  * Remove redundant VkShaderCreateInfoEXT VUs 08452 and 08458 (internal MR
+    7076).
+  * Fix typo in VkSwapchainPresentScalingCreateInfoEXT VU 10154 (internal MR
+    7077).
+  * Remove redundant explicit VkPhysicalDeviceSurfaceCapabilitiesKHR VU
+    06523 (internal MR 7078).
+  * Remove redundant VkWriteDescriptorSetAccelerationStructureKHR and
+    VkWriteDescriptorSetAccelerationStructureNV VUs 02236 and 03747
+    (internal MR 7079).
+  * Remove redundant vkCmdBindShadersEXT feature bit VUs 08474, 08475,
+    08490, and 08491, (internal MR 7083).
+  * Revert vkCmdWaitEvents2 dependencyFlags VU that should not have been
+    removed (internal MR 7089).
+  * Reword common draw vertex binding vertex attribute VU 10390 (internal MR
+    7091).
+  * Fix asciidoctor markup for the VK_QCOM_image_processing proposal and
+    update some descriptions (internal MR 7097).
+
+New Extensions
+
+  * VK_ARM_pipeline_opacity_micromap
+  * VK_KHR_depth_clamp_zero_one
+  * VK_KHR_maintenance8
+
+'''
+
 Change log for December 20, 2024 Vulkan 1.4.304 spec update:
 
 Github Issues

diff --git a/ChangeLogSC.adoc b/ChangeLogSC.adoc
@@ -1,4 +1,4 @@
-Copyright 2022-2024 The Khronos Group Inc.
+Copyright 2022-2025 The Khronos Group Inc.
 SPDX-License-Identifier: CC-BY-4.0
 
 Update Log for the VulkanSC-Docs repository on GitHub.

diff --git a/LICENSE.adoc b/LICENSE.adoc
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 The Khronos Group Inc.
+// Copyright 2020-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = LICENSE File for the KhronosGroup/Vulkan-Docs Project

diff --git a/LICENSES/LicenseRef-KhronosSpecCopyright.adoc b/LICENSES/LicenseRef-KhronosSpecCopyright.adoc
@@ -1,4 +1,4 @@
-Copyright 2014-2024 The Khronos Group Inc.
+Copyright 2014-2025 The Khronos Group Inc.
 
 This Specification is protected by copyright laws and contains material
 proprietary to Khronos. Except as described by these terms, it or any

diff --git a/Makefile b/Makefile
@@ -1,4 +1,4 @@
-# Copyright 2014-2024 The Khronos Group Inc.
+# Copyright 2014-2025 The Khronos Group Inc.
 #
 # SPDX-License-Identifier: Apache-2.0
 
@@ -148,7 +148,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 304
+PATCHVERSION = 305
 BASEOPTS     =
 
 ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))

diff --git a/README.adoc b/README.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2024 The Khronos Group Inc.
+// Copyright 2017-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/READMESC.adoc b/READMESC.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2024 The Khronos Group Inc.
+// Copyright 2017-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/READMEVK.adoc b/READMEVK.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2024 The Khronos Group Inc.
+// Copyright 2017-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 ifdef::env-github[]

diff --git a/antora/.gitignore b/antora/.gitignore
@@ -1,4 +1,4 @@
-# Copyright 2024 The Khronos Group Inc.
+# Copyright 2024-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 **/images

diff --git a/antora/Makefile b/antora/Makefile
@@ -1,4 +1,4 @@
-# Copyright 2014-2024 The Khronos Group Inc.
+# Copyright 2014-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Configure Vulkan-Docs Antora tree with generated files and transformed

diff --git a/antora/features/antora.yml b/antora/features/antora.yml
@@ -1,4 +1,4 @@
-# Copyright 2022-2024 The Khronos Group Inc.
+# Copyright 2022-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 name: features

diff --git a/antora/features/modules/features/nav.adoc b/antora/features/modules/features/nav.adoc
@@ -1,4 +1,4 @@
-// Copyright 2024 The Khronos Group Inc.
+// Copyright 2024-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 // This file is generated by the scripts/antora-nav-features.py script.

diff --git a/antora/features/modules/features/pages/index.adoc b/antora/features/modules/features/pages/index.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2024 The Khronos Group Inc.
+// Copyright 2022-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan Feature Descriptions

diff --git a/antora/pageHeaders-spec.adoc b/antora/pageHeaders-spec.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2024 The Khronos Group Inc.
+// Copyright 2022-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 // Boilerplate to include in spec pages.

diff --git a/antora/spec/antora.yml b/antora/spec/antora.yml
@@ -1,4 +1,4 @@
-# Copyright 2022-2024 The Khronos Group Inc.
+# Copyright 2022-2025 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 name: spec

diff --git a/antora/spec/modules/ROOT/nav.adoc b/antora/spec/modules/ROOT/nav.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2024 The Khronos Group Inc.
+// Copyright 2022-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 // Navigation page for Vulkan spec in Antora

diff --git a/antora/spec/modules/ROOT/pages/index.adoc b/antora/spec/modules/ROOT/pages/index.adoc
@@ -1,4 +1,4 @@
-// Copyright 2022-2024 The Khronos Group Inc.
+// Copyright 2022-2025 The Khronos Group Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan Documentation

diff --git a/appendices/VK_AMDX_shader_enqueue.adoc b/appendices/VK_AMDX_shader_enqueue.adoc
@@ -1,4 +1,4 @@
-// Copyright 2017-2024 The Khronos Group Inc.
+// Copyright 2017-2025 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 

diff --git a/appendices/VK_ANDROID_external_format_resolve.adoc b/appendices/VK_ANDROID_external_format_resolve.adoc
@@ -1,4 +1,4 @@
-// Copyright 2023-2024 The Khronos Group Inc.
+// Copyright 2023-2025 The Khronos Group Inc.
 //
 // SPDX-License-Identifier: CC-BY-4.0
-Original file line number
+Diff line change
@@ Expand Up / @@ -8,7 +8,7 @@ assignees: '' @@
     ---
     <!--
-    Copyright 2018-2024 The Khronos Group Inc.
+    Copyright 2018-2025 The Khronos Group Inc.
     SPDX-License-Identifier: CC-BY-4.0
     -->
@@ Expand Down @@