Change log for August 29, 2025 Vulkan 1.4.326 spec update:

Github Issues

  * Make descriptions of <<extendingvulkan-functionalitylevels,
    Functionality Levels>> and <<extendingvulkan-device-extensions, Device
    Extensions>> consistent with the glossary (public issue 922).
  * Clarify resource state between
    <<synchronization-queue-transfers-acquire, acquire>> and
    <<synchronization-queue-transfers-release, release>> queue family
    ownership transfers and for vkQueueSubmit (public issue 1050).
  * Require appropriate aspect masks for framebuffers in VkRenderingInfo and
    VkFramebufferCreateInfo (public issue 1469).
  * Clarify how attachments become undefined when not preserved for
    VkRenderPassCreateInfo, VkSubpassDescription, VkRenderPassCreateInfo2,
    and in the <<renderpass-load-operations, Render Pass Load>> and
    <<renderpass-store-operations, Render Pass Store>> Operations sections
    (public issue 1557).
  * Fix typos in VK_EXT_fragment_density_map appendix (public issue 1742).
  * Generate reference page component sources for Antora in the
    docs.vulkan.org site build (public PR 2553).
  * Document use of custom `len` attribute value for video.xml
    `StdVideoH265HrdParameters` (public issue 2557).
  * Fix common draw validity VU 09548 when
    vkCmdSetRenderingAttachmentLocations is called (public issue 2565).
  * Clarify that VK_WHOLE_SIZE can be used for VkDeviceMemory (public issue
    2568).

Internal Issues

  * Add `requiredlimittype` attribute for structs, check consistency of
    `limittype` attributes on members, and add missing attribute values
    (internal issue 4043).
  * Clarify <<synchronization-image-barrier-layout-transition-order,
    implicit layout transition ordering>> (internal issue 4302).
  * Specify in the <<fundamentals-binaryresults, Opaque Binary Data
    Results>> section that vkGet* functions returning opaque binary data may
    take their size/data arguments in an extensible structure (internal
    issue 4413).
  * Add VUs requiring that minDepthBounds must be less than or equal to
    maxDepthBounds for vkCmdSetDepthBounds and VkGraphicsPipelineCreateInfo
    (internal issue 4418).
  * Add FeatureRequirements for CTS to VulkanObject (internal issue 3992).
  * <<deprecation-devicelayers, Deprecate device layers>> (internal MR
    7388).
  * Fixes for VUIDs and other language of VK_ARM_data_graph (internal MR
    7478).
  * Merge Vulkan SC 1.0.19 changes back to main branch (internal MR 7573).
  * Tag VkPipelineMultisampleStateCreateInfo::pSampleMask as
    "noautovalidity" in XML, since it requires special handling in tooling
    (internal MR 7579).
  * Add a <<spirvenv-buffer-indexing, Buffer Indexing Calculations>> case
    for OpCooperativeVector* (internal MR 7585).
  * Clarify that VkPhysicalDeviceVertexAttributeRobustnessFeaturesEXT was
    not added to VK_KHR_maintenance9 in the
    VK_EXT_vertex_attribute_robustness appendix (internal MR 7590).
  * Document that the tileShadingApron feature is optional in the
    VK_QCOM_tile_shading appendix (internal MR 7594).
  * Tag some VkDeviceAddress members with missing `"optional"` in XML
    (internal MR 7601).
  * Remove unreachable VK_KHR_shader_untyped_pointers VUs in the runtime
    SPIR-V section (internal MR 7605).
  * Cleanup markup for VK_KHR_shader_untyped_pointers and move
    OpUntypedVariableKHR VU 11167 to the standalone SPIR-V section (internal
    MR 7606).
  * Move buffer device address VU 06314 to the standalone SPIR-V section
    (internal MR 7608).
  * Add vkCmdBeginRendering VU to catch invalid dynamic rendering begin
    (internal MR 7610).
  * Add missing vkGetDevice{Buffer,Image}MemoryRequirements to cases where
    VkMemoryRequirements2 can be extended by VkMemoryDedicatedRequirements
    (internal MR 7612).

Author: oddhack

ChangeLog.adoc

@@ -14,6 +14,81 @@ appears frequently in the change log.
 
 '''
 
+Change log for August 29, 2025 Vulkan 1.4.326 spec update:
+
+Github Issues
+
+  * Make descriptions of <<extendingvulkan-functionalitylevels,
+    Functionality Levels>> and <<extendingvulkan-device-extensions, Device
+    Extensions>> consistent with the glossary (public issue 922).
+  * Clarify resource state between
+    <<synchronization-queue-transfers-acquire, acquire>> and
+    <<synchronization-queue-transfers-release, release>> queue family
+    ownership transfers and for vkQueueSubmit (public issue 1050).
+  * Require appropriate aspect masks for framebuffers in VkRenderingInfo and
+    VkFramebufferCreateInfo (public issue 1469).
+  * Clarify how attachments become undefined when not preserved for
+    VkRenderPassCreateInfo, VkSubpassDescription, VkRenderPassCreateInfo2,
+    and in the <<renderpass-load-operations, Render Pass Load>> and
+    <<renderpass-store-operations, Render Pass Store>> Operations sections
+    (public issue 1557).
+  * Fix typos in VK_EXT_fragment_density_map appendix (public issue 1742).
+  * Generate reference page component sources for Antora in the
+    docs.vulkan.org site build (public PR 2553).
+  * Document use of custom `len` attribute value for video.xml
+    `StdVideoH265HrdParameters` (public issue 2557).
+  * Fix common draw validity VU 09548 when
+    vkCmdSetRenderingAttachmentLocations is called (public issue 2565).
+  * Clarify that VK_WHOLE_SIZE can be used for VkDeviceMemory (public issue
+    2568).
+
+Internal Issues
+
+  * Add `requiredlimittype` attribute for structs, check consistency of
+    `limittype` attributes on members, and add missing attribute values
+    (internal issue 4043).
+  * Clarify <<synchronization-image-barrier-layout-transition-order,
+    implicit layout transition ordering>> (internal issue 4302).
+  * Specify in the <<fundamentals-binaryresults, Opaque Binary Data
+    Results>> section that vkGet* functions returning opaque binary data may
+    take their size/data arguments in an extensible structure (internal
+    issue 4413).
+  * Add VUs requiring that minDepthBounds must be less than or equal to
+    maxDepthBounds for vkCmdSetDepthBounds and VkGraphicsPipelineCreateInfo
+    (internal issue 4418).
+  * Add FeatureRequirements for CTS to VulkanObject (internal issue 3992).
+  * <<deprecation-devicelayers, Deprecate device layers>> (internal MR
+    7388).
+  * Fixes for VUIDs and other language of VK_ARM_data_graph (internal MR
+    7478).
+  * Merge Vulkan SC 1.0.19 changes back to main branch (internal MR 7573).
+  * Tag VkPipelineMultisampleStateCreateInfo::pSampleMask as
+    "noautovalidity" in XML, since it requires special handling in tooling
+    (internal MR 7579).
+  * Add a <<spirvenv-buffer-indexing, Buffer Indexing Calculations>> case
+    for OpCooperativeVector* (internal MR 7585).
+  * Clarify that VkPhysicalDeviceVertexAttributeRobustnessFeaturesEXT was
+    not added to VK_KHR_maintenance9 in the
+    VK_EXT_vertex_attribute_robustness appendix (internal MR 7590).
+  * Document that the tileShadingApron feature is optional in the
+    VK_QCOM_tile_shading appendix (internal MR 7594).
+  * Tag some VkDeviceAddress members with missing `"optional"` in XML
+    (internal MR 7601).
+  * Remove unreachable VK_KHR_shader_untyped_pointers VUs in the runtime
+    SPIR-V section (internal MR 7605).
+  * Cleanup markup for VK_KHR_shader_untyped_pointers and move
+    OpUntypedVariableKHR VU 11167 to the standalone SPIR-V section (internal
+    MR 7606).
+  * Move buffer device address VU 06314 to the standalone SPIR-V section
+    (internal MR 7608).
+  * Add vkCmdBeginRendering VU to catch invalid dynamic rendering begin
+    (internal MR 7610).
+  * Add missing vkGetDevice{Buffer,Image}MemoryRequirements to cases where
+    VkMemoryRequirements2 can be extended by VkMemoryDedicatedRequirements
+    (internal MR 7612).
+
+'''
+
 Change log for August 8, 2025 Vulkan 1.4.325 spec update:
 
 Github Issues

ChangeLogSC.adoc

@@ -12,6 +12,26 @@ with any public pull requests that have been accepted.
 
 -----------------------------------------------------
 
+Change log for August 1, 2025 Vulkan SC 1.0.19 spec update:
+
+  * update release number to 19 for this update and reflow spec language (#258/!408)
+
+Public issues:
+
+  * None
+
+Internal issues:
+
+  * update json parser generator to explicitly support "0" in flag maps (!406)
+  * Clarify VK_PIPELINE_CACHE_CREATE_USE_APPLICATION_STORAGE_BIT flag
+    after Vulkan object model rewrite (#267/!405)
+  * Disable deprecation for Vulkan SC, pending clarifications (#269/!407)
+  * Merge VK 1.4.319 tag to sc_main (!404)
+  * Merge VK 1.4.318 tag to sc_main (!401)
+  * Merge VK 1.4.316 tag to sc_main (!400)
+
+-----------------------------------------------------
+
 Change log for March 24, 2025 Vulkan SC 1.0.18 spec update:
 
   * update release number to 18 for this update and reflow spec language (!398)

Makefile

@@ -149,12 +149,12 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 325
+PATCHVERSION = 326
 BASEOPTS     =
 
 ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))
 VKSPECREVISION := 1.2.$(PATCHVERSION)
-SCPATCHVERSION = 18
+SCPATCHVERSION = 19
 SPECREVISION = 1.0.$(SCPATCHVERSION)
 BASEOPTS = -a baserevnumber="$(VKSPECREVISION)"
 else

appendices/VK_ARM_data_graph.adoc

@@ -30,6 +30,7 @@ include::{generated}/meta/{refprefix}VK_ARM_data_graph.adoc[]
   - Derek Lamberti, Arm Ltd.
   - Chetan Mistry, Arm Ltd.
   - Georgios Teneketzis, Arm Ltd.
+  - Matthew Netsch, Qualcomm Technologies, Inc
 
 === Description
 

appendices/VK_EXT_fragment_density_map.adoc

@@ -135,8 +135,8 @@ VkRenderPassCreateInfo2 renderPassCreateInfo =
 vkCreateRenderPass2(device, &renderPassCreateInfo, nullptr, &renderPass);
 
 // Add fdmImage to framebuffer
-// Color attachments can be created with VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT
-// All attachments must be created with VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSETS_BIT_EXT
+// Color and depth attachments can be created with
+// VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT
 VkFramebufferCreateInfo framebufferCreateInfo =
 {
    .sType = VK_STRUCTURE_TYPE_FRAME_BUFFER_CREATE_INFO,

appendices/VK_EXT_vertex_attribute_robustness.adoc

@@ -23,6 +23,15 @@ This extension allows applications to not have to specify fake vertex
 attribute locations, and if the vertex shader reads those attributes it will
 read (0,0,0,0) or (0,0,0,1).
 
+ifdef::VK_KHR_maintenance9[]
+=== Promotion to `VK_KHR_maintenance9`
+
+The same functionality is provided by apiext:VK_KHR_maintenance9, but
+enabled by the <<features-maintenance9,pname:maintenance9>> feature instead.
+The slink:VkPhysicalDeviceVertexAttributeRobustnessFeaturesEXT structure was
+not included in the maintenance extension.
+endif::VK_KHR_maintenance9[]
+
 include::{generated}/interfaces/VK_EXT_vertex_attribute_robustness.adoc[]
 
 === Issues

appendices/VK_QCOM_tile_shading.adoc

@@ -7,7 +7,7 @@ include::{generated}/meta/{refprefix}VK_QCOM_tile_shading.adoc[]
 === Other Extension Metadata
 
 *Last Modified Date*::
-    2025-5-12
+    2025-8-13
 *IP Status*::
     No known IP claims.
 *Interactions and External Dependencies*::
@@ -104,8 +104,15 @@ include::{generated}/interfaces/VK_QCOM_tile_shading.adoc[]
 
 === Issues
 
-- none
+1) Some early Adreno drivers advertised support for version 1 of this
+extension without supporting the required
+<<features-tileShadingApron,pname:tileShadingApron>> feature.
+To cover all Adreno devices on the market, applications should not assume
+any version of this extension supports the pname:tileShadingApron feature
+without performing a feature query.
 
 === Version History
 
+  * Revision 2, 2025-08-13 (Matthew Netsch)
+  ** Make the pname:tileShadingApron feature optional
   * Revision 1, 2023-10-12 (Jeff Leger)

appendices/deprecation.adoc

@@ -48,6 +48,10 @@ the Extensions chapter>> for more information.
 When functionality is deprecated, an explanation of its deprecation will be
 added to the below sections.
 
+ifdef::VKSC_VERSION_1_0[]
+This section is currently empty for Vulkan SC.
+endif::VKSC_VERSION_1_0[]
+ifndef::VKSC_VERSION_1_0[]
 [NOTE]
 ====
 This list is a work in progress - we intend to add other items to this
@@ -84,6 +88,25 @@ Instead of dlink:VK_API_VERSION, specific version defines (e.g.
 dlink:VK_API_VERSION_1_0) or the dlink:VK_MAKE_API_VERSION macro should be
 used instead.
 
+[[deprecation-devicelayers]]
+=== Device Layers: Deprecation via instance layers
+
+Previous versions of this specification distinguished between instance and
+device layers.
+Instance layers were only able to intercept commands that operate on
+sname:VkInstance and sname:VkPhysicalDevice, except they were not able to
+intercept flink:vkCreateDevice.
+Device layers were enabled for individual devices when they were created,
+and could only intercept commands operating on that device or its child
+objects.
+
+Device-only layers are now deprecated, and this specification no longer
+distinguishes between instance and device layers.
+Layers are enabled during instance creation, and are able to intercept all
+commands operating on that instance or any of its child objects.
+At the time of deprecation there were no known device-only layers and no
+compelling reason to create one.
+
 ifdef::VK_VERSION_1_2[]
 [[deprecation-renderpass2]]
 === Render Pass Functions: Deprecation via version 2
@@ -133,3 +156,4 @@ Outside of vendor extensions, applications are advised to make use of
 flink:vkCmdBeginRendering and flink:vkCmdEndRendering to manage render
 passes from this API version onward.
 endif::VK_VERSION_1_4[]
+endif::VKSC_VERSION_1_0[]

appendices/spirvenv.adoc

@@ -665,26 +665,21 @@ or knowledge of runtime information, such as enabled features.
     generation, intersection, any-hit, closest hit, callable, or miss
     shaders
   * [[VUID-{refpage}-Base-07650]]
-    The code:Base operand of code:OpPtrAccessChain
-ifdef::VK_KHR_shader_untyped_pointers[]
-    or code:OpUntypedPtrAccessChainKHR
-endif::VK_KHR_shader_untyped_pointers[]
-    must: have a storage class of code:Workgroup, code:StorageBuffer, or
-    code:PhysicalStorageBuffer
+    The code:Base operand of code:OpPtrAccessChain or
+    code:OpUntypedPtrAccessChainKHR must: have a storage class of
+    code:Workgroup, code:StorageBuffer, or code:PhysicalStorageBuffer
   * [[VUID-{refpage}-Base-07651]]
-    If the code:Base operand of code:OpPtrAccessChain
-ifdef::VK_KHR_shader_untyped_pointers[]
-    or code:OpUntypedPtrAccessChainKHR
-endif::VK_KHR_shader_untyped_pointers[]
-    has a code:Workgroup {StorageClass}, then the code:VariablePointers
-    capability must: be declared
+    If the code:Base operand of code:OpPtrAccessChain or
+    code:OpUntypedPtrAccessChainKHR has a code:Workgroup {StorageClass},
+    then the code:VariablePointers capability must: be declared
   * [[VUID-{refpage}-Base-07652]]
-    If the code:Base operand of code:OpPtrAccessChain
-ifdef::VK_KHR_shader_untyped_pointers[]
-    or code:OpUntypedPtrAccessChainKHR
-endif::VK_KHR_shader_untyped_pointers[]
-    has a code:StorageBuffer {StorageClass}, then the code:VariablePointers
-    or code:VariablePointersStorageBuffer capability must: be declared
+    If the code:Base operand of code:OpPtrAccessChain or
+    code:OpUntypedPtrAccessChainKHR has a code:StorageBuffer {StorageClass},
+    then the code:VariablePointers or code:VariablePointersStorageBuffer
+    capability must: be declared
+  * [[VUID-{refpage}-OpUntypedVariableKHR-11167]]
+    Any code:OpUntypedVariableKHR must: have a code:Data code:Type operand
+    specified
   * [[VUID-{refpage}-PhysicalStorageBuffer64-04708]]
     If the code:PhysicalStorageBuffer64 addressing model is enabled, all
     instructions that support memory access operands and that use a physical
@@ -697,6 +692,11 @@ endif::VK_KHR_shader_untyped_pointers[]
     If the code:PhysicalStorageBuffer64 addressing model is enabled,
     code:OpConvertUToPtr and code:OpConvertPtrToU must: use an integer type
     whose code:Width is 64
+  * [[VUID-{refpage}-PhysicalStorageBuffer64-06314]]
+    If the code:PhysicalStorageBuffer64 addressing model is enabled any load
+    or store through a physical pointer type must: have an code:Aligned
+    operand which is a multiple of the size of the largest scalar type in
+    the pointed-to type
   * [[VUID-{refpage}-OpTypeForwardPointer-04711]]
     code:OpTypeForwardPointer must: have a {StorageClass} of
     code:PhysicalStorageBuffer
@@ -1419,10 +1419,6 @@ ifdef::VK_EXT_transform_feedback[]
     slink:VkPhysicalDeviceTransformFeedbackPropertiesEXT::pname:maxTransformFeedbackBufferDataStride
 endif::VK_EXT_transform_feedback[]
 ifdef::VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address[]
-  * [[VUID-{refpage}-PhysicalStorageBuffer64-06314]]
-    If the code:PhysicalStorageBuffer64 addressing model is enabled any load
-    or store through a physical pointer type must: be aligned to a multiple
-    of the size of the largest scalar type in the pointed-to type
   * [[VUID-{refpage}-PhysicalStorageBuffer64-06315]]
     If the code:PhysicalStorageBuffer64 addressing model is enabled the
     pointer value of a memory access instruction must: be at least as
@@ -2448,21 +2444,6 @@ endif::VK_KHR_maintenance8[]
 ifndef::VK_KHR_maintenance8[Image]
     operand code:Offset must: only be used with code:OpImage*Gather
     instructions
-ifdef::VK_KHR_workgroup_memory_explicit_layout[]
-ifndef::VK_KHR_shader_untyped_pointers[]
-  * [[VUID-{refpage}-workgroupMemoryExplicitLayout8BitAccess-11163]]
-    If the
-    <<features-workgroupMemoryExplicitLayout8BitAccess,pname:workgroupMemoryExplicitLayout8BitAccess>>
-    feature is ename:VK_FALSE, objects in the code:Workgroup storage class
-    with the code:Block decoration must: not contain 8-bit integer members
-  * [[VUID-{refpage}-workgroupMemoryExplicitLayout16BitAccess-11164]]
-    If the
-    <<features-workgroupMemoryExplicitLayout16BitAccess,pname:workgroupMemoryExplicitLayout16BitAccess>>
-    feature is ename:VK_FALSE, objects in the code:Workgroup storage class
-    with the code:Block decoration must: not contain 16-bit integer or
-    16-bit floating-point members
-endif::VK_KHR_shader_untyped_pointers[]
-endif::VK_KHR_workgroup_memory_explicit_layout[]
 ifdef::VK_KHR_shader_untyped_pointers[]
   * [[VUID-{refpage}-Size-11165]]
     The code:Size operand of code:OpCopyMemorySized must: be a multiple of 4
@@ -2476,9 +2457,6 @@ ifdef::VK_KHR_shader_untyped_pointers[]
     Any memory access made using an code:OpTypeUntypedPointerKHR must have
     an alignment that satisfies <<interfaces-resources-layout,Offset and
     Stride Assignment>>
-  * [[VUID-{refpage}-OpUntypedVariableKHR-11167]]
-    Any code:OpUntypedVariableKHR must: have a code:Data code:Type operand
-    specified
 endif::VK_KHR_shader_untyped_pointers[]
   * [[VUID-{refpage}-OpImage-06376]]
     If an code:OpImage*Gather operation has an image operand of code:Offset,
@@ -3642,11 +3620,11 @@ The offset calculations that have the 4GB limit include:
   * code:OpAccessChain and code:OpPtrAccessChain - the total offset summed
     over all indices multiplied by strides, including spanning multiple
     access chain instructions that lead to a given memory access.
-ifdef::VK_KHR_cooperative_matrix[]
-  * code:OpCooperativeMatrixLoadKHR and code:OpCooperativeMatrixStoreKHR
+ifdef::VK_NV_cooperative_matrix[]
+  * code:OpCooperativeMatrixLoadNV and code:OpCooperativeMatrixStoreNV
     instructions computing an offset based on element, row, and stride
     parameters.
-endif::VK_KHR_cooperative_matrix[]
+endif::VK_NV_cooperative_matrix[]
 ifdef::VK_KHR_cooperative_matrix[]
   * code:OpCooperativeMatrixLoadKHR and code:OpCooperativeMatrixStoreKHR
     instructions computing an offset based on element, row, and stride
@@ -3657,6 +3635,12 @@ ifdef::VK_NV_cooperative_matrix2[]
     code:OpCooperativeMatrixStoreTensorNV instructions computing an offset
     based on tensor layout state.
 endif::VK_NV_cooperative_matrix2[]
+ifdef::VK_NV_cooperative_vector[]
+  * code:OpCooperativeVectorMatrixMulAddNV,
+    code:OpCooperativeVectorMatrixMulNV and
+    code:OpCooperativeVectorOuterProductAccumulateNV instructions computing
+    an offset based on offset, row, and stride parameters.
+endif::VK_NV_cooperative_vector[]
 
 
 [[spirvenv-image-signedness]]