Change log for February 21, 2025 Vulkan 1.4.309 spec update:

Github Issues

  * Fix CullPrimitiveEXT VUs (public PR 2475).
  * Fix promoted extension dependencies in vk.xml (public PR 2492).
  * Fix XML dependency of VK_KHR_video_maintenance2
    (public Vulkan-ValidationLayers issue 9464).

Internal Issues

  * Clarify VUs for
    VkAccelerationStructureBuildRangeInfoKHR::primitiveOffset in cases where
    packed formats are used (internal issue 4058).
  * Add bufferFeatures restriction to VkFormatProperties for depth/stencil
    and multi-planar formats (internal issue 4155).
  * Add a standalone SPIR-V validation VU requiring that interpolation
    qualifiers match for any given location (internal issue 4161).
  * Clarify template text in transcluded tag::features language used to
    describe features consistently (internal issue 4190).
  * Fix XML `limittype` attributes for
    VkPhysicalDeviceCooperativeVectorPropertiesNV (internal MR 7160).
  * Specify that only the lower 32 bits are used in VkStridedDeviceAddressNV
    (internal MR 7173).
  * Add Vulkan object and base generator scripts for inclusion in
    Vulkan-Headers (internal MR 7180),
  * Update links to SPIR-V registry and add a missing spirvextension XML
    block (internal MR 7187).

Author: oddhack

.github/workflows/CI.yml

@@ -22,7 +22,7 @@ jobs:
     # We now refer to the container by its SHA instead of the name, to prevent
     # caching problems when updating the image.
     # container: khronosgroup/docker-images:asciidoctor-spec.20240726
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
     steps:
       - uses: actions/checkout@v4
@@ -32,7 +32,7 @@ jobs:
   consistency-check:
     name: Run consistency checks on the spec and XML sources
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
     steps:
       - uses: actions/checkout@v4
@@ -48,7 +48,7 @@ jobs:
   spec-toolchain:
     name: Build a test spec and check against expectation, to make sure the spec toolchain works as expected
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
     steps:
       - uses: actions/checkout@v4
@@ -57,7 +57,7 @@ jobs:
   spec-core:
     name: Build the core-only spec, to try and catch ifdef errors in extension markup
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
     steps:
       - uses: actions/checkout@v4
@@ -66,7 +66,7 @@ jobs:
   spec-generate:
     name: Build the vulkan specification and generate any associated files (such as vulkan.h)
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
     steps:
       - uses: actions/checkout@v4
@@ -140,7 +140,7 @@ jobs:
   cts-framework-tests:
     name: Run Vulkan CTS framework tests to validate against XML changes
     runs-on: ubuntu-latest
-    container: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+    container: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
     continue-on-error: true
 
     steps:

.gitlab-ci.yml

@@ -9,7 +9,7 @@
 # image: khronosgroup/docker-images:asciidoctor-spec.20240727
 # There are no 'before_script' tags for most stages, because all
 # prerequisites are in the default image.
-image: khronosgroup/docker-images@sha256:089687083ceb36483a3917389e4278718ab19c594099634f5dd80e22540c960f
+image: khronosgroup/docker-images@sha256:9f5add2758a383ba329bc8c4b819dea9fb695ee629b05b7da4739ddf81d39073
 
 # Specify which gitlab runner to use
 default:

ChangeLog.adoc

@@ -14,6 +14,37 @@ appears frequently in the change log.
 
 '''
 
+Change log for February 21, 2025 Vulkan 1.4.309 spec update:
+
+Github Issues
+
+  * Fix CullPrimitiveEXT VUs (public PR 2475).
+  * Fix promoted extension dependencies in vk.xml (public PR 2492).
+  * Fix XML dependency of VK_KHR_video_maintenance2
+    (public Vulkan-ValidationLayers issue 9464).
+
+Internal Issues
+
+  * Clarify VUs for
+    VkAccelerationStructureBuildRangeInfoKHR::primitiveOffset in cases where
+    packed formats are used (internal issue 4058).
+  * Add bufferFeatures restriction to VkFormatProperties for depth/stencil
+    and multi-planar formats (internal issue 4155).
+  * Add a standalone SPIR-V validation VU requiring that interpolation
+    qualifiers match for any given location (internal issue 4161).
+  * Clarify template text in transcluded tag::features language used to
+    describe features consistently (internal issue 4190).
+  * Fix XML `limittype` attributes for
+    VkPhysicalDeviceCooperativeVectorPropertiesNV (internal MR 7160).
+  * Specify that only the lower 32 bits are used in VkStridedDeviceAddressNV
+    (internal MR 7173).
+  * Add Vulkan object and base generator scripts for inclusion in
+    Vulkan-Headers (internal MR 7180),
+  * Update links to SPIR-V registry and add a missing spirvextension XML
+    block (internal MR 7187).
+
+'''
+
 Change log for February 7, 2025 Vulkan 1.4.308 spec update:
 
 Github Issues

Makefile

@@ -148,7 +148,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 308
+PATCHVERSION = 309
 BASEOPTS     =
 
 ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))

appendices/VK_EXT_debug_report.adoc

@@ -40,7 +40,7 @@ events.
 
 To capture events that occur while creating or destroying an instance an
 application can: link a slink:VkDebugReportCallbackCreateInfoEXT structure
-to the pname:pNext element of the slink:VkInstanceCreateInfo structure given
+to the pname:pNext chain of the slink:VkInstanceCreateInfo structure passed
 to flink:vkCreateInstance.
 
 Example uses: Create three callback objects.

appendices/VK_EXT_debug_utils.adoc

@@ -83,7 +83,7 @@ events.
 
 To capture events that occur while creating or destroying an instance an
 application can: link a slink:VkDebugUtilsMessengerCreateInfoEXT structure
-to the pname:pNext element of the slink:VkInstanceCreateInfo structure given
+to the pname:pNext chain of the slink:VkInstanceCreateInfo structure passed
 to flink:vkCreateInstance.
 
 Example uses: Create three callback objects.

appendices/VK_EXT_depth_clip_control.adoc

@@ -52,7 +52,7 @@ extended in the future?
 It is highly unlikely that the depth range is changed to anything other than
 [eq]#[0, 1]# in the future.
 Should that happen a new extension will be required to extend such an enum,
-and that extension might as well add a new struct to chain to
+and that extension might as well add a new structure to chain to
 slink:VkPipelineViewportStateCreateInfo::pname:pNext instead.
 
 === Version History

appendices/VK_EXT_device_generated_commands.adoc

@@ -104,7 +104,7 @@ The intended usage for this extension is for the application to:
     flink:vkGetGeneratedCommandsMemoryRequirementsEXT.
   * optionally preprocess the generated content using
     flink:vkCmdPreprocessGeneratedCommandsEXT, for example on an
-    asynchronous compute queue, or for the purpose of re-using the data in
+    asynchronous compute queue, or for the purpose of reusing the data in
     multiple executions.
   * call flink:vkCmdExecuteGeneratedCommandsEXT to create and execute the
     actual device commands for all sequences based on the inputs provided.

appendices/VK_EXT_layer_settings.adoc

@@ -28,10 +28,10 @@ include::{generated}/meta/{refprefix}VK_EXT_layer_settings.adoc[]
 This extension provides a mechanism for configuring programmatically through
 the Vulkan API the behavior of layers.
 
-This extension provides the slink:VkLayerSettingsCreateInfoEXT struct that
-can be included in the pname:pNext chain of the slink:VkInstanceCreateInfo
-structure passed as the pname:pCreateInfo parameter of
-flink:vkCreateInstance.
+This extension provides the slink:VkLayerSettingsCreateInfoEXT structure
+that can be included in the pname:pNext chain of the
+slink:VkInstanceCreateInfo structure passed as the pname:pCreateInfo
+parameter of flink:vkCreateInstance.
 
 The structure contains an array of slink:VkLayerSettingEXT structure values
 that configure specific features of layers.
@@ -79,7 +79,7 @@ const VkLayerSettingEXT settings[] = {
      {kLayerName, kLayerSettingsProfileFile, VK_LAYER_SETTING_TYPE_STRING_EXT, 1, &profile_file_data},
      {kLayerName, kLayerSettingsProfileName, VK_LAYER_SETTING_TYPE_STRING_EXT, 1, &profile_name_data},
      {kLayerName, kLayerSettingsEmulatePortability, VK_LAYER_SETTING_TYPE_BOOL32_EXT, 1, &emulate_portability_data},
-     {kLayerName, kLayerSettingsSimulateCapabilities, VK_LAYER_SETTING_TYPE_STRING_EXT, 
+     {kLayerName, kLayerSettingsSimulateCapabilities, VK_LAYER_SETTING_TYPE_STRING_EXT,
         static_cast<uint32_t>(std::size(simulate_capabilities)), simulate_capabilities},
      {kLayerName, kLayerSettingsDebugReports, VK_LAYER_SETTING_TYPE_STRING_EXT,
         static_cast<uint32_t>(std::size(debug_reports)), debug_reports}
@@ -90,7 +90,7 @@ const VkLayerSettingsCreateInfoEXT layer_settings_create_info{
     static_cast<uint32_t>(std::size(settings)), settings};
 
 VkInstanceCreateInfo inst_create_info = {};
-... 
+...
 inst_create_info.pNext = &layer_settings_create_info;
 vkCreateInstance(&inst_create_info, nullptr, &_instances);
 ----

appendices/VK_EXT_validation_cache.adoc

@@ -22,7 +22,7 @@ application.
 At the core is the slink:VkValidationCacheEXT object type, which is managed
 similarly to the existing slink:VkPipelineCache.
 
-The new struct slink:VkShaderModuleValidationCacheCreateInfoEXT can be
+The new structure slink:VkShaderModuleValidationCacheCreateInfoEXT can be
 included in the pname:pNext chain at flink:vkCreateShaderModule time.
 It contains a slink:VkValidationCacheEXT to use when validating the
 slink:VkShaderModule.