Change log for March 17, 2023 Vulkan 1.3.244 spec update:

Github Issues: * Fix typo in slink:VkDeviceGroupRenderPassBeginInfo::pname:deviceRenderAreaCount (public issue 2078). Internal Issues * Move copy attribute's pname: to commonvalidity attributes to aid with VUID generation (internal MR 5781). * Add a .mailmap file (internal MR 5786). * Refactor pipeline layout consistency VUs for slink:VkComputePipelineCreateInfo, slink:VkGraphicsPipelineCreateInfo, and slink:VkRayTracingPipelineCreateInfoNV into common validity statements (internal MR 5750). * Make VUID tag generation prioritize attributes, helping ensure tags are unique when the same common validity file is included twice in the same VU block (internal MR 5791). New Extensions: * apiext:VK_KHR_map_memory2
KhronosGroup · Mar 18, 2023 · 7beccb6 · tambry · Mar 18, 2023 · oddhack
1 parent 84ccde6
commit 7beccb6
Show file tree

Hide file tree

Showing 35 changed files with 902 additions and 198 deletions.
diff --git a/.mailmap b/.mailmap
@@ -0,0 +1,6 @@
+# Copyright 2023 The Khronos Group Inc.
+# SPDX-License-Identifier: CC-BY-4.0
+
+Faith Ekstrand <faith.ekstrand@collabora.com> <jason@jlekstrand.net>
+Faith Ekstrand <faith.ekstrand@collabora.com> <jason.ekstrand@intel.com>
+Faith Ekstrand <faith.ekstrand@collabora.com> <jason.ekstrand@collabora.com>
diff --git a/ChangeLog.adoc b/ChangeLog.adoc
@@ -14,6 +14,33 @@ appears frequently in the change log.
 
 -----------------------------------------------------
 
+Change log for March 17, 2023 Vulkan 1.3.244 spec update:
+
+Github Issues:
+
+  * Fix typo in
+    slink:VkDeviceGroupRenderPassBeginInfo::pname:deviceRenderAreaCount
+    (public issue 2078).
+
+Internal Issues
+
+  * Move copy attribute's pname: to commonvalidity attributes to aid with
+    VUID generation (internal MR 5781).
+  * Add a .mailmap file (internal MR 5786).
+  * Refactor pipeline layout consistency VUs for
+    slink:VkComputePipelineCreateInfo, slink:VkGraphicsPipelineCreateInfo,
+    and slink:VkRayTracingPipelineCreateInfoNV into common validity
+    statements (internal MR 5750).
+  * Make VUID tag generation prioritize attributes, helping ensure tags are
+    unique when the same common validity file is included twice in the same
+    VU block (internal MR 5791).
+
+New Extensions:
+
+  * apiext:VK_KHR_map_memory2
+
+-----------------------------------------------------
+
 Change log for March 12, 2023 Vulkan 1.3.243 spec update:
 
 Github Issues:

diff --git a/Makefile b/Makefile
@@ -104,7 +104,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 243
+PATCHVERSION = 244
 
 ifneq (,$(findstring VK_VERSION_1_3,$(VERSIONS)))
 SPECMINOR = 3

diff --git a/appendices/VK_ANDROID_external_memory_android_hardware_buffer.adoc b/appendices/VK_ANDROID_external_memory_android_hardware_buffer.adoc
@@ -12,7 +12,7 @@ include::{generated}/meta/{refprefix}VK_ANDROID_external_memory_android_hardware
     No known IP claims.
 *Contributors*::
   - Ray Smith, ARM
-  - Chad Versace, Google
+  - Lina Versace, Google
   - Jesse Hall, Google
   - Tobias Hector, Imagination
   - James Jones, NVIDIA

diff --git a/appendices/VK_EXT_extended_dynamic_state.adoc b/appendices/VK_EXT_extended_dynamic_state.adoc
@@ -51,7 +51,7 @@ is that this state should be more or less free to change.
 
 ifdef::VK_EXT_vertex_input_dynamic_state[]
 apiext:VK_EXT_vertex_input_dynamic_state allows the stride to be changed
-freely when supported via flink:vkCmdSetVertexInputStateEXT[].
+freely when supported via flink:vkCmdSetVertexInputEXT[].
 endif::VK_EXT_vertex_input_dynamic_state[]
 
 

diff --git a/appendices/VK_EXT_external_memory_dma_buf.adoc b/appendices/VK_EXT_external_memory_dma_buf.adoc
@@ -11,7 +11,7 @@ include::{generated}/meta/{refprefix}VK_EXT_external_memory_dma_buf.adoc[]
 *IP Status*::
     No known IP claims.
 *Contributors*::
-  - Chad Versace, Google
+  - Lina Versace, Google
   - James Jones, NVIDIA
   - Faith Ekstrand, Intel
 
@@ -55,5 +55,5 @@ to code:dma_buf.
 
 === Version History
 
-  * Revision 1, 2017-10-10 (Chad Versace)
+  * Revision 1, 2017-10-10 (Lina Versace)
   ** Squashed internal revisions
diff --git a/appendices/VK_EXT_image_drm_format_modifier.adoc b/appendices/VK_EXT_image_drm_format_modifier.adoc
@@ -13,7 +13,7 @@ include::{generated}/meta/{refprefix}VK_EXT_image_drm_format_modifier.adoc[]
 *Contributors*::
   - Antoine Labour, Google
   - Bas Nieuwenhuizen, Google
-  - Chad Versace, Google
+  - Lina Versace, Google
   - James Jones, NVIDIA
   - Faith Ekstrand, Intel
   - Jőrg Wagner, ARM
@@ -405,7 +405,7 @@ _requires_ the application to set pname:size to 0.
 
 ==== Version History
 
-  * Revision 1, 2018-08-29 (Chad Versace)
+  * Revision 1, 2018-08-29 (Lina Versace)
   ** First stable revision
   * Revision 2, 2021-09-30 (Jon Leech)
   ** Add interaction with `apiext:VK_KHR_format_feature_flags2` to `vk.xml`
diff --git a/appendices/VK_EXT_queue_family_foreign.adoc b/appendices/VK_EXT_queue_family_foreign.adoc
@@ -11,7 +11,7 @@ include::{generated}/meta/{refprefix}VK_EXT_queue_family_foreign.adoc[]
 *IP Status*::
     No known IP claims.
 *Contributors*::
-  - Chad Versace, Google
+  - Lina Versace, Google
   - James Jones, NVIDIA
   - Faith Ekstrand, Intel
   - Jesse Hall, Google
@@ -44,5 +44,5 @@ include::{generated}/interfaces/VK_EXT_queue_family_foreign.adoc[]
 
 === Version History
 
-  * Revision 1, 2017-11-01 (Chad Versace)
+  * Revision 1, 2017-11-01 (Lina Versace)
   ** Squashed internal revisions
diff --git a/appendices/VK_EXT_swapchain_maintenance1.adoc b/appendices/VK_EXT_swapchain_maintenance1.adoc
@@ -15,7 +15,7 @@ include::{generated}/meta/{refprefix}VK_EXT_swapchain_maintenance1.adoc[]
   - Ian Elliott, Google
   - Yiwei Zhang, Google
   - Charlie Lao, Google
-  - Chad Versace, Google
+  - Lina Versace, Google
   - Ralph Potter, Samsung
   - Igor Nazarov, Samsung
   - Hyunchang Kim, Samsung

diff --git a/appendices/VK_HUAWEI_cluster_culling_shader.adoc b/appendices/VK_HUAWEI_cluster_culling_shader.adoc
@@ -212,7 +212,7 @@ void main()
         // cluster based culling
         bool render = (!isSphereOutsideFrustum(desc.sphere.center,
         desc.sphere.radius) && isFrontFaceVisible(desc.sphere.center, desc.sphere.radius, desc.cone.norm
-	al, desc.cone.angle));
+        al, desc.cone.angle));
 
         if (render)
         {

diff --git a/appendices/VK_KHR_external_memory.adoc b/appendices/VK_KHR_external_memory.adoc
@@ -25,7 +25,7 @@ include::{generated}/meta/{refprefix}VK_KHR_external_memory.adoc[]
   - Daniel Rakos, AMD
   - Carsten Rohde, NVIDIA
   - Ray Smith, ARM
-  - Chad Versace, Google
+  - Lina Versace, Google
 
 === Description
 

diff --git a/appendices/VK_KHR_external_semaphore.adoc b/appendices/VK_KHR_external_semaphore.adoc
@@ -20,7 +20,7 @@ include::{generated}/meta/{refprefix}VK_KHR_external_semaphore.adoc[]
   - Jeff Juliano, NVIDIA
   - Matthew Netsch, Qualcomm Technologies, Inc.
   - Ray Smith, ARM
-  - Chad Versace, Google
+  - Lina Versace, Google
 
 === Description
 

diff --git a/appendices/VK_KHR_map_memory2.adoc b/appendices/VK_KHR_map_memory2.adoc
@@ -0,0 +1,32 @@
+// Copyright 2023 The Khronos Group Inc.
+//
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}VK_KHR_map_memory2.adoc[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2023-03-14
+*Interactions and External Dependencies*::
+  - None
+*Contributors*::
+  - Faith Ekstrand, Collabora
+  - Tobias Hector, AMD
+
+=== Description
+
+This extension provides extensible versions of the Vulkan memory map and
+unmap entrypoints.
+The new entrypoints are functionally identical to the core entrypoints,
+except that their parameters are specified using extensible structures that
+can be used to pass extension-specific information.
+
+include::{generated}/interfaces/VK_KHR_map_memory2.adoc[]
+
+=== Version History
+
+  * Revision 0, 2022-08-03 (Faith Ekstrand)
+  ** Internal revisions
+  * Revision 1, 2022-03-14
+  ** Public release
diff --git a/appendices/credits.adoc b/appendices/credits.adoc
@@ -76,7 +76,7 @@ their name.
   * Caio Marcelo de Oliveira Filho, Intel (versions 1.2, 1.3)
   * Cass Everitt, Oculus VR (versions 1.0, 1.1)
   * Cemil Azizoglu, Canonical (version 1.0)
-  * Chad Versace, Google (versions 1.0, 1.1, 1.2)
+  * Lina Versace, Google (versions 1.0, 1.1, 1.2)
   * Chang-Hyo Yu, Samsung Electronics (version 1.0)
   * Charles Giessen, LunarG (version 1.3)
   * Chia-I Wu, LunarG (version 1.0)

diff --git a/chapters/commonvalidity/copy_anyimage_to_imageany_common.adoc b/chapters/commonvalidity/copy_anyimage_to_imageany_common.adoc
@@ -11,28 +11,28 @@
 // field in pRegions corresponding to {imageparam}
 
 ifndef::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-None-07922]]
-    If {imageparam} is non-sparse then it must: be bound completely and
-    contiguously to a single sname:VkDeviceMemory object
+  * [[VUID-{refpage}-{imageparam}-07965]]
+    If pname:{imageparam} is non-sparse then it must: be bound completely
+    and contiguously to a single sname:VkDeviceMemory object
 endif::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
 ifdef::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-None-07923]]
-    If {imageparam} is non-sparse then the image or the specified _disjoint_
-    plane must: be bound completely and contiguously to a single
+  * [[VUID-{refpage}-{imageparam}-07966]]
+    If pname:{imageparam} is non-sparse then the image or the specified
+    _disjoint_ plane must: be bound completely and contiguously to a single
     sname:VkDeviceMemory object
 endif::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-pRegions-07924]]
-    The {imagesubresource}.mipLevel member of each element of pname:pRegions
-    must: be less than the pname:mipLevels specified in
-    slink:VkImageCreateInfo when {imageparam} was created
-  * [[VUID-{refpage}-imageSubresource-07925]]
-    The [eq]#{imagesubresource}.baseArrayLayer {plus}
-    pname:imageSubresource.layerCount# of each element of pname:pRegions
+  * [[VUID-{refpage}-{imagesubresource}-07967]]
+    The pname:{imagesubresource}.mipLevel member of each element of
+    pname:pRegions must: be less than the pname:mipLevels specified in
+    slink:VkImageCreateInfo when pname:{imageparam} was created
+  * [[VUID-{refpage}-{imagesubresource}-07968]]
+    The [eq]#pname:{imagesubresource}.baseArrayLayer {plus}
+    pname:{imageSubresource}.layerCount# of each element of pname:pRegions
     must: be less than or equal to the pname:arrayLayers specified in
-    slink:VkImageCreateInfo when {imageparam} was created
+    slink:VkImageCreateInfo when pname:{imageparam} was created
 ifdef::VK_EXT_fragment_density_map[]
-  * [[VUID-{refpage}-flags-07926]]
-    {imageparam} must: not have been created with pname:flags containing
-    ename:VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT
+  * [[VUID-{refpage}-{imageparam}-07969]]
+    pname:{imageparam} must: not have been created with pname:flags
+    containing ename:VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT
 endif::VK_EXT_fragment_density_map[]
 // Common Valid Usage
diff --git a/chapters/commonvalidity/copy_anyimage_to_imageany_no_rotation_common.adoc b/chapters/commonvalidity/copy_anyimage_to_imageany_no_rotation_common.adoc
@@ -11,17 +11,18 @@
 // Additionally, it relies on the {imagesubresource} attribute to specify the
 // field in pRegions corresponding to {imageparam}
 
-  * [[VUID-{refpage}-pRegions-07927]]
+  * [[VUID-{refpage}-{imagesubresource}-07970]]
     The image region specified by each element of pname:pRegions must: be
-    contained within the specified {imagesubresource} of {imageparam}
-  * [[VUID-{refpage}-pRegions-07928]]
+    contained within the specified pname:{imagesubresource} of
+    pname:{imageparam}
+  * [[VUID-{refpage}-{imagesubresource}-07971]]
     For each element of pname:pRegions, pname:imageOffset.x and
     [eq]#(pname:imageExtent.width {plus} pname:imageOffset.x)# must: both be
     greater than or equal to `0` and less than or equal to the width of the
-    specified {imagesubresource} of {imageparam}
-  * [[VUID-{refpage}-pRegions-07929]]
+    specified pname:{imagesubresource} of pname:{imageparam}
+  * [[VUID-{refpage}-{imagesubresource}-07972]]
     For each element of pname:pRegions, pname:imageOffset.y and
     [eq]#(pname:imageExtent.height {plus} pname:imageOffset.y)# must: both
     be greater than or equal to `0` and less than or equal to the height of
-    the specified {imagesubresource} of {imageparam}
+    the specified pname:{imagesubresource} of pname:{imageparam}
 // Common Valid Usage
diff --git a/chapters/commonvalidity/copy_anyimage_to_imageany_single_sampled_common.adoc b/chapters/commonvalidity/copy_anyimage_to_imageany_single_sampled_common.adoc
@@ -9,7 +9,7 @@
 // which includes this file, specifying the name of the source or
 // destination image.
 
-  * [[VUID-{refpage}-None-07930]]
-    {imageparam} must: have a sample count equal to
+  * [[VUID-{refpage}-{imageparam}-07973]]
+    pname:{imageparam} must: have a sample count equal to
     ename:VK_SAMPLE_COUNT_1_BIT
 // Common Valid Usage
diff --git a/...ers/commonvalidity/copy_bufferimage_to_imagebuffer_buffer_alignment_common.adoc b/...ers/commonvalidity/copy_bufferimage_to_imagebuffer_buffer_alignment_common.adoc
@@ -10,30 +10,30 @@
 //  - {imageparam}, specifying the name of the source or destination image,
 
 ifndef::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-bufferOffset-00193]]
-    If {imageparam} does not have a depth/stencil format, then for each
-    element of pname:pRegions, pname:bufferOffset must: be a multiple of the
-    format's texel block size
+  * [[VUID-{refpage}-{imageparam}-07974]]
+    If pname:{imageparam} does not have a depth/stencil format, then for
+    each element of pname:pRegions, pname:bufferOffset must: be a multiple
+    of the format's texel block size
 endif::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
 ifdef::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-bufferOffset-01558]]
-    If {imageparam} does not have either a depth/stencil or a
+  * [[VUID-{refpage}-{imageparam}-07975]]
+    If pname:{imageparam} does not have either a depth/stencil or a
     <<formats-requiring-sampler-ycbcr-conversion,multi-planar format>>, then
     for each element of pname:pRegions, pname:bufferOffset must: be a
     multiple of the format's texel block size
-  * [[VUID-{refpage}-bufferOffset-01559]]
-    If {imageparam} has a
+  * [[VUID-{refpage}-{imageparam}-07976]]
+    If pname:{imageparam} has a
     <<formats-requiring-sampler-ycbcr-conversion,multi-planar format>>, then
     for each element of pname:pRegions, pname:bufferOffset must: be a
     multiple of the element size of the compatible format for the format and
     the pname:aspectMask of the pname:imageSubresource as defined in
     <<formats-compatible-planes>>
 endif::VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion[]
-  * [[VUID-{refpage}-pRegions-07273]]
+  * [[VUID-{refpage}-{imageparam}-07977]]
     For each element of pname:pRegions, pname:bufferOffset must: be a
     multiple of the <<formats-compatibility-classes,texel block size>> of
-    the elink:VkFormat of {imageparam}
-  * [[VUID-{refpage}-srcImage-04053]]
-    If {imageparam} has a depth/stencil format, the pname:bufferOffset
+    the elink:VkFormat of pname:{imageparam}
+  * [[VUID-{refpage}-{imageparam}-07978]]
+    If pname:{imageparam} has a depth/stencil format, the pname:bufferOffset
     member of any element of pname:pRegions must: be a multiple of `4`
 // Common Valid Usage