Change log for October 18, 2024 Vulkan 1.3.299 spec update:

Internal Issues

  * Update XML feature description schema to support feature names in the
    `depends` attributes of `require` tags, as well as enabling AND/OR lists
    of feature dependencies, and use the new syntax to generate more of the
    content in the <<features-requirements, Feature Requirements>> section
    (internal issues 3947, 3949, and 3950).
  * Minimize use of extraneous "`set to`" and add corresponding style guide
    section and CI test (internal issue 3966).
  * Add a <<features-multisampledRenderToSingleSampled,
    pname:multisampledRenderToSingleSampled>> exception to common draw VU
    07474 (internal issue 4024).
  * Update VkVideoEncodeRateControlInfoKHR VU 08358 to allow
    initialVirtualBufferSizeInMs to equal virtualBufferSizeInMs (internal
    issue 4028).
  * Add conditional render state VU for vkCmdExecuteGeneratedCommandsEXT
    (internal issue 4037).
  * Combine common draw validity VUs 03417, 03418, 03419, and 08635 covering
    shader object and graphics pipeline viewport count (internal MR 6870).
  * Fix missing exception for
    VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR in video profile
    compatibility in <<video-profile-compatibility, Video Profile
    Compatibility>> (internal MR 6909).
  * Fix buffer offset calculation to not offset based on image offsets in
    the <<copies-buffers-images, Copying Data Between Buffers and Images>>
    section (internal MR 6919).
  * Fix and add VkImageCreateInfo and VkImageViewCreateInfo VUs to restrict
    sparse and 2D views, moving them to image create time (internal MR
    6920).
  * Fix minor asciidoc conditional markup errors causing errors when
    building with specific extensions, which required refactoring some
    vendor extension interactions with KHR extensions into the vendor
    extension (internal MR 6923).
  * Remove redundant VkWriteIndirectExecutionSetPipelineEXT VU 11028
    (internal MR 6926).
  * Improve cross-references to the deviceGeneratedCommands feature from
    different VUs to distinguish between the NV and EXT
    device_generated_commands extensions where relevant (internal MR 6933).
  * Update cross-references and XML descriptions of spirvcapability alias
    names to match alias naming introduced in SPIRV-Headers by
    KhronosGroup/SPIRV-Headers#447 (internal MR
    6936).
  * Fix UniformTexelBufferArrayDynamicIndexing VUs 10132 and 10133, and
    StorageTexelBufferArrayNonUniformIndexing VU 10140 to properly limit the
    VUs to when the corresponding capability is *not* declared (internal MR
    6938).
  * Mark VK_EXT_feedback_loop_layout and VK_EXT_feedback_loop_dynamic_state
    as `specialuse="glemulation,d3demulation"` (internal MR 6941).

ChangeLog.adoc

@@ -14,6 +14,59 @@ appears frequently in the change log.
 
 '''
 
+Change log for October 18, 2024 Vulkan 1.3.299 spec update:
+
+Internal Issues
+
+  * Update XML feature description schema to support feature names in the
+    `depends` attributes of `require` tags, as well as enabling AND/OR lists
+    of feature dependencies, and use the new syntax to generate more of the
+    content in the <<features-requirements, Feature Requirements>> section
+    (internal issues 3947, 3949, and 3950).
+  * Minimize use of extraneous "`set to`" and add corresponding style guide
+    section and CI test (internal issue 3966).
+  * Add a <<features-multisampledRenderToSingleSampled,
+    pname:multisampledRenderToSingleSampled>> exception to common draw VU
+    07474 (internal issue 4024).
+  * Update VkVideoEncodeRateControlInfoKHR VU 08358 to allow
+    initialVirtualBufferSizeInMs to equal virtualBufferSizeInMs (internal
+    issue 4028).
+  * Add conditional render state VU for vkCmdExecuteGeneratedCommandsEXT
+    (internal issue 4037).
+  * Combine common draw validity VUs 03417, 03418, 03419, and 08635 covering
+    shader object and graphics pipeline viewport count (internal MR 6870).
+  * Fix missing exception for
+    VK_IMAGE_CREATE_VIDEO_PROFILE_INDEPENDENT_BIT_KHR in video profile
+    compatibility in <<video-profile-compatibility, Video Profile
+    Compatibility>> (internal MR 6909).
+  * Fix buffer offset calculation to not offset based on image offsets in
+    the <<copies-buffers-images, Copying Data Between Buffers and Images>>
+    section (internal MR 6919).
+  * Fix and add VkImageCreateInfo and VkImageViewCreateInfo VUs to restrict
+    sparse and 2D views, moving them to image create time (internal MR
+    6920).
+  * Fix minor asciidoc conditional markup errors causing errors when
+    building with specific extensions, which required refactoring some
+    vendor extension interactions with KHR extensions into the vendor
+    extension (internal MR 6923).
+  * Remove redundant VkWriteIndirectExecutionSetPipelineEXT VU 11028
+    (internal MR 6926).
+  * Improve cross-references to the deviceGeneratedCommands feature from
+    different VUs to distinguish between the NV and EXT
+    device_generated_commands extensions where relevant (internal MR 6933).
+  * Update cross-references and XML descriptions of spirvcapability alias
+    names to match alias naming introduced in SPIRV-Headers by
+    https://github.com/KhronosGroup/SPIRV-Headers/pull/447 (internal MR
+    6936).
+  * Fix UniformTexelBufferArrayDynamicIndexing VUs 10132 and 10133, and
+    StorageTexelBufferArrayNonUniformIndexing VU 10140 to properly limit the
+    VUs to when the corresponding capability is *not* declared (internal MR
+    6938).
+  * Mark VK_EXT_feedback_loop_layout and VK_EXT_feedback_loop_dynamic_state
+    as `specialuse="glemulation,d3demulation"` (internal MR 6941).
+
+'''
+
 Change log for October 11, 2024 Vulkan 1.3.298 spec update:
 
 Public Issues

ChangeLogSC.adoc

@@ -12,7 +12,31 @@ with any public pull requests that have been accepted.
 
 -----------------------------------------------------
 
-Change log for June 17, 2023 Vulkan SC 1.0.15 spec update:
+Change log for October 7, 2024 Vulkan SC 1.0.16 spec update:
+
+  * update release number to 16 for this update and reflow spec language (!389)
+
+Public issues:
+
+  * Remove dEQP-ism from generated CTS helpers (!382 based on public
+    pull request Vulkan-Docs 2396)
+
+Internal issues:
+
+  * Update the set of cases where VK_FAULT_TYPE_COMMAND_BUFFER_FULL
+    may be reported (#234/!390)
+  * Merge VK 1.3.295 tag to sc_main (!388)
+  * Merge VK 1.3.292 tag to sc_main (!384)
+  * Remove broken JSON codegen (#223/!381)
+  * Merge VK 1.3.298 tag to sc_main (!380)
+
+New Extensions:
+
+  * apiext:VK_EXT_layer_settings (!383)
+
+-----------------------------------------------------
+
+Change log for June 17, 2024 Vulkan SC 1.0.15 spec update:
 
   * update release number to 15 for this update and reflow spec language
 

Makefile

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

appendices/VK_EXT_device_generated_commands.adoc

@@ -122,6 +122,7 @@ For each dispatch in a sequence, the following can be specified:
   * updates to bound shader stages
 
 For each trace rays in a sequence, the following can be specified:
+
   * a number of different push constants
   * updates to bound shader stages
 

appendices/VK_EXT_shader_demote_to_helper_invocation.adoc

@@ -33,7 +33,7 @@ include::{generated}/interfaces/VK_EXT_shader_demote_to_helper_invocation.adoc[]
 
 === New SPIR-V Capability
 
-  * <<spirvenv-capabilities-table-DemoteToHelperInvocationEXT,
+  * <<spirvenv-capabilities-table-DemoteToHelperInvocation,
     code:DemoteToHelperInvocationEXT>>
 
 === Promotion to Vulkan 1.3

appendices/VK_KHR_shader_integer_dot_product.adoc

@@ -48,13 +48,13 @@ the core functionality.
 
 === New SPIR-V Capabilities
 
-  * <<spirvenv-capabilities-table-DotProductInputAllKHR,
+  * <<spirvenv-capabilities-table-DotProductInputAll,
     code:DotProductInputAllKHR>>
-  * <<spirvenv-capabilities-table-DotProductInput4x8BitKHR,
+  * <<spirvenv-capabilities-table-DotProductInput4x8Bit,
     code:DotProductInput4x8BitKHR>>
-  * <<spirvenv-capabilities-table-DotProductInput4x8BitPackedKHR,
+  * <<spirvenv-capabilities-table-DotProductInput4x8BitPacked,
     code:DotProductInput4x8BitPackedKHR>>
-  * <<spirvenv-capabilities-table-DotProductKHR, code:DotProductKHR>>
+  * <<spirvenv-capabilities-table-DotProduct, code:DotProductKHR>>
 
 === Version History
 

appendices/VK_KHR_shared_presentable_image.adoc

@@ -68,8 +68,8 @@ images and swapchains.
 slink:VkSwapchainCreateInfoKHR be ignored, or required to be compatible
 values?
 
-*RESOLVED*: pname:minImageCount must be set to 1, and pname:presentMode
-should be set to either ename:VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR or
+*RESOLVED*: pname:minImageCount must be 1, and pname:presentMode should be
+set to either ename:VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR or
 ename:VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR.
 
 6) What should the layout of the shared presentable image be?

appendices/VK_NV_compute_shader_derivatives.adoc

@@ -38,9 +38,9 @@ include::{generated}/interfaces/VK_NV_compute_shader_derivatives.adoc[]
 
 === New SPIR-V Capability
 
-  * <<spirvenv-capabilities-table-ComputeDerivativeGroupQuadsNV,
+  * <<spirvenv-capabilities-table-ComputeDerivativeGroupQuadsKHR,
     code:ComputeDerivativeGroupQuadsNV>>
-  * <<spirvenv-capabilities-table-ComputeDerivativeGroupLinearNV,
+  * <<spirvenv-capabilities-table-ComputeDerivativeGroupLinearKHR,
     code:ComputeDerivativeGroupLinearNV>>
 
 === Issues

appendices/VK_NV_device_generated_commands.adoc

@@ -179,7 +179,8 @@ the ability to change any elink:VkDynamicState.
 8) How do we allow re-using already "`generated`" code:indirectCommands?
 
 Expose a `preprocessBuffer` to reuse implementation-dependencyFlags data.
-Set the `isPreprocessed` to true in flink:vkCmdExecuteGeneratedCommandsNV.
+Set pname:isPreprocessed to ename:VK_TRUE in
+flink:vkCmdExecuteGeneratedCommandsNV.
 
 9) Under which conditions is flink:vkCmdExecuteGeneratedCommandsNV legal?
 

appendices/VK_NV_viewport_array2.adoc

@@ -76,7 +76,7 @@ include::{generated}/interfaces/VK_NV_viewport_array2.adoc[]
 
 === New SPIR-V Capabilities
 
-  * <<spirvenv-capabilities-table-ShaderViewportIndexLayerNV,
+  * <<spirvenv-capabilities-table-ShaderViewportIndexLayerEXT,
     code:ShaderViewportIndexLayerNV>>
   * <<spirvenv-capabilities-table-ShaderViewportMaskNV,
     code:ShaderViewportMaskNV>>

appendices/spirvenv.adoc

@@ -739,13 +739,13 @@ or knowledge of runtime information, such as enabled features.
     must: be determined by <<glossary-constant-integral-expression, constant
     integral expressions>>
   * [[VUID-{refpage}-UniformTexelBufferArrayDynamicIndexing-10132]]
-    If the code:UniformTexelBufferArrayDynamicIndexing capability is
+    If the code:UniformTexelBufferArrayDynamicIndexing capability is not
     declared, and an instruction accesses memory through a uniform texel
     buffer, the uniform texel buffer through which that memory is accessed
     must: be determined by <<glossary-constant-integral-expression, constant
     integral expressions>>
   * [[VUID-{refpage}-StorageTexelBufferArrayDynamicIndexing-10133]]
-    If the code:StorageTexelBufferArrayDynamicIndexing capability is
+    If the code:StorageTexelBufferArrayDynamicIndexing capability is not
     declared, and an instruction accesses memory through a storage texel
     buffer, the storage texel buffer through which that memory is accessed
     must: be determined by <<glossary-constant-integral-expression, constant
@@ -938,9 +938,9 @@ ifdef::VK_VERSION_1_1[]
 endif::VK_VERSION_1_1[]
   * [[VUID-{refpage}-StorageTexelBufferArrayNonUniformIndexing-10140]]
     If the code:StorageTexelBufferArrayNonUniformIndexing capability is not
-    is not declared, and an instruction accesses memory through a storage
-    texel buffer, the storage texel buffer through which that memory is
-    accessed must: be dynamically uniform within the invocation group
+    declared, and an instruction accesses memory through a storage texel
+    buffer, the storage texel buffer through which that memory is accessed
+    must: be dynamically uniform within the invocation group
 ifdef::VK_VERSION_1_1[]
     or subgroup
 endif::VK_VERSION_1_1[]
@@ -1540,19 +1540,17 @@ ifdef::VK_KHR_portability_subset[]
     slink:VkPhysicalDevicePortabilitySubsetFeaturesKHR::pname:shaderSampleRateInterpolationFunctions
     is ename:VK_FALSE, then `GLSL.std.450` fragment interpolation functions
     are not supported by the implementation and code:OpCapability must: not
-    be set to code:InterpolationFunction
+    be code:InterpolationFunction
   * [[VUID-{refpage}-tessellationShader-06326]]
     If <<features-tessellationShader, pname:tessellationShader>> is enabled,
     and the `apiext:VK_KHR_portability_subset` extension is enabled, and
     slink:VkPhysicalDevicePortabilitySubsetFeaturesKHR::pname:tessellationIsolines
-    is ename:VK_FALSE, then code:OpExecutionMode must: not be set to
-    code:IsoLines
+    is ename:VK_FALSE, then code:OpExecutionMode must: not be code:IsoLines
   * [[VUID-{refpage}-tessellationShader-06327]]
     If <<features-tessellationShader, pname:tessellationShader>> is enabled,
     and the `apiext:VK_KHR_portability_subset` extension is enabled, and
     slink:VkPhysicalDevicePortabilitySubsetFeaturesKHR::pname:tessellationPointMode
-    is ename:VK_FALSE, then code:OpExecutionMode must: not be set to
-    code:PointMode
+    is ename:VK_FALSE, then code:OpExecutionMode must: not be code:PointMode
 endif::VK_KHR_portability_subset[]
 ifdef::VK_KHR_8bit_storage[]
   * [[VUID-{refpage}-storageBuffer8BitAccess-06328]]

chapters/VK_EXT_acquire_drm_display/acquire_drm_display.adoc

@@ -45,7 +45,7 @@ include::{generated}/api/protos/vkGetDrmDisplayEXT.adoc[]
     returned here.
 
 If there is no slink:VkDisplayKHR corresponding to the pname:connectorId on
-the pname:physicalDevice, the returning pname:display must: be set to
+the pname:physicalDevice, the returning pname:display must: be
 dlink:VK_NULL_HANDLE.
 The provided pname:drmFd must: correspond to the one owned by the
 pname:physicalDevice.

chapters/VK_EXT_blend_operation_advanced/advanced_blend.adoc

@@ -161,9 +161,9 @@ equations:
 where the function f and terms X, Y, and Z are specified in the table.
 The R, G, and B components of the source color used for blending are derived
 according to pname:srcPremultiplied.
-If pname:srcPremultiplied is set to ename:VK_TRUE, the fragment color
-components are considered to have been premultiplied by the A component
-prior to blending.
+If pname:srcPremultiplied is ename:VK_TRUE, the fragment color components
+are considered to have been premultiplied by the A component prior to
+blending.
 The base source color [eq]#(R~s~',G~s~',B~s~')# is obtained by dividing
 through by the A component:
 
@@ -190,9 +190,8 @@ are used as the base color:
 
 The R, G, and B components of the destination color used for blending are
 derived according to pname:dstPremultiplied.
-If pname:dstPremultiplied is set to ename:VK_TRUE, the destination
-components are considered to have been premultiplied by the A component
-prior to blending.
+If pname:dstPremultiplied is ename:VK_TRUE, the destination components are
+considered to have been premultiplied by the A component prior to blending.
 The base destination color [eq]#(R~d~',G~d~',B~d~')# is obtained by dividing
 through by the A component:
 

chapters/VK_EXT_debug_marker.adoc

@@ -54,8 +54,8 @@ include::{generated}/api/structs/VkDebugMarkerObjectNameInfoEXT.adoc[]
 
 Applications may: change the name associated with an object simply by
 calling fname:vkDebugMarkerSetObjectNameEXT again with a new string.
-To remove a previously set name, pname:pObjectName should: be set to an
-empty string.
+To remove a previously set name, pname:pObjectName should: be an empty
+string.
 
 .Valid Usage
 ****
@@ -172,7 +172,7 @@ include::{generated}/api/structs/VkDebugMarkerMarkerInfoEXT.adoc[]
     the marker.
     A particular implementation may: choose to ignore this color value.
     The values contain RGBA values in order, in the range 0.0 to 1.0.
-    If all elements in pname:color are set to 0.0 then it is ignored.
+    If all elements in pname:color are 0.0, then it is ignored.
 
 include::{generated}/validity/structs/VkDebugMarkerMarkerInfoEXT.adoc[]
 --

chapters/VK_EXT_debug_utils.adoc

@@ -253,7 +253,7 @@ include::{generated}/api/structs/VkDebugUtilsLabelEXT.adoc[]
     the label.
     A particular implementation may: choose to ignore this color value.
     The values contain RGBA values in order, in the range 0.0 to 1.0.
-    If all elements in pname:color are set to 0.0 then it is ignored.
+    If all elements in pname:color are 0.0, then it is ignored.
 
 include::{generated}/validity/structs/VkDebugUtilsLabelEXT.adoc[]
 --

chapters/VK_EXT_depth_clamp_control/fragops.adoc

@@ -15,7 +15,7 @@ include::{generated}/api/structs/VkPipelineViewportDepthClampControlCreateInfoEX
   * pname:depthClampMode determines how the clamp range is determined for
     each viewport.
   * pname:pDepthClampRange sets the depth clamp range for all viewports if
-    pname:depthClampMode is set to
+    pname:depthClampMode is
     ename:VK_DEPTH_CLAMP_MODE_USER_DEFINED_RANGE_EXT.
 
 This structure extends sname:VkPipelineViewportStateCreateInfo and specifies
@@ -27,10 +27,10 @@ ename:VK_DEPTH_CLAMP_MODE_VIEWPORT_RANGE_EXT.
 .Valid Usage
 ****
   * [[VUID-VkPipelineViewportDepthClampControlCreateInfoEXT-pDepthClampRange-09646]]
-    If pname:depthClampMode is set to
+    If pname:depthClampMode is
     ename:VK_DEPTH_CLAMP_MODE_USER_DEFINED_RANGE_EXT, and the pipeline is
     not created with ename:VK_DYNAMIC_STATE_DEPTH_CLAMP_RANGE_EXT, then
-    pname:pDepthClampRange must be a valid pointer to a valid
+    pname:pDepthClampRange must: be a valid pointer to a valid
     sname:VkDepthClampRangeEXT structure
 ****
 
@@ -69,7 +69,7 @@ include::{generated}/api/protos/vkCmdSetDepthClampRangeEXT.adoc[]
   * pname:depthClampMode determines how the clamp range is determined for
     each viewport.
   * pname:pDepthClampRange sets the depth clamp range for all viewports if
-    pname:depthClampMode is set to
+    pname:depthClampMode is
     ename:VK_DEPTH_CLAMP_MODE_USER_DEFINED_RANGE_EXT.
 
 This command sets the viewport depth clamp range for subsequent drawing
@@ -85,7 +85,7 @@ value used to create the currently active pipeline.
 .Valid Usage
 ****
   * [[VUID-vkCmdSetDepthClampRangeEXT-pDepthClampRange-09647]]
-    If pname:depthClampMode is set to
+    If pname:depthClampMode is
     ename:VK_DEPTH_CLAMP_MODE_USER_DEFINED_RANGE_EXT, then
     pname:pDepthClampRange must be a valid pointer to a valid
     sname:VkDepthClampRangeEXT structure

chapters/VK_EXT_metal_objects/device_memory.adoc

@@ -531,8 +531,8 @@ ifdef::VK_KHR_timeline_semaphore[]
 If the pname:pNext chain of the slink:VkSemaphoreCreateInfo structure
 includes both sname:VkImportMetalSharedEventInfoEXT and
 slink:VkSemaphoreTypeCreateInfo, the code:signaledValue property of the
-imported `id<MTLSharedEvent>` object will be set to pname:initialValue of
-slink:VkSemaphoreTypeCreateInfo.
+imported `id<MTLSharedEvent>` object will be set to
+slink:VkSemaphoreTypeCreateInfo::pname:initialValue.
 endif::VK_KHR_timeline_semaphore[]
 
 include::{generated}/validity/structs/VkImportMetalSharedEventInfoEXT.adoc[]

chapters/VK_KHR_shared_presentable_image/wsi.adoc

@@ -76,7 +76,7 @@ interpreted as follows:
 ====
 The swapchain state may: be cached by implementations, so applications
 should: regularly call fname:vkGetSwapchainStatusKHR when using a swapchain
-with elink:VkPresentModeKHR set to
+with elink:VkPresentModeKHR equal to
 ename:VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR.
 ====
 

chapters/VK_KHR_surface/wsi.adoc

@@ -212,8 +212,9 @@ include::{generated}/api/protos/vkGetPhysicalDeviceSurfaceSupportKHR.adoc[]
   * pname:physicalDevice is the physical device.
   * pname:queueFamilyIndex is the queue family.
   * pname:surface is the surface.
-  * pname:pSupported is a pointer to a basetype:VkBool32, which is set to
-    ename:VK_TRUE to indicate support, and ename:VK_FALSE otherwise.
+  * pname:pSupported is a pointer to a basetype:VkBool32.
+    ename:VK_TRUE indicates support, and ename:VK_FALSE indicates no
+    support.
 
 include::{chapters}/commonvalidity/no_dynamic_allocations_common.adoc[]
 

chapters/VK_KHR_swapchain/PresentId.adoc

@@ -28,8 +28,7 @@ pname:pNext chain of the slink:VkPresentInfoKHR structure to supply
 identifiers.
 
 Each sname:VkSwapchainKHR has a presentId associated with it.
-This value is initially set to zero when the sname:VkSwapchainKHR is
-created.
+This value is initially zero when the sname:VkSwapchainKHR is created.
 
 When a sname:VkPresentIdKHR structure with a non-NULL pname:pPresentIds is
 included in the pname:pNext chain of a slink:VkPresentInfoKHR structure,