Skip to content

Commit e554740

Browse files
committed
Change log for November 14, 2025 Vulkan 1.4.333 spec update:
Github Issues * Fix `const` pNext in returnedonly="true" structs (public PR 2601). * Update description of queue objects to omit "`execution engines`" (public issue 2604). Internal Issues * Add CI checks in xml_consistency.py for cases where pNext members must not be `const` (internal issue 2734). * Use "`for each element`" instead of "`for any element`" in VUs for ray tracing extensions, and document this pattern in the style guide (internal issue 4534). * Add acceleration structures to vkUpdateDescriptorSetWithTemplate VU 01685 (internal issue 4536). * Add common query results VUs restricting VK_QUERY_RESULT_WITH_STATUS_BIT_KHR based on the query type (internal issue 4484). * Fix `const` pNext in VkPhysicalDeviceDataGraphModelFeaturesQCOM (internal MR 7804). * Merge INTEL, NN, NV, QCOM, and QNX extension markup in separate files into the chapters they are included from (internal issue 4516). * Update pipeline library dependency explanation in the VK_KHR_ray_tracing_pipeline extension appendix (internal MR 7828). New Extensions * VK_EXT_custom_resolve * VK_EXT_ray_tracing_invocation_reorder
1 parent 8fba3c1 commit e554740

File tree

76 files changed

+5604
-3784
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+5604
-3784
lines changed

ChangeLog.adoc

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,40 @@ appears frequently in the change log.
1414

1515
'''
1616

17+
Change log for November 14, 2025 Vulkan 1.4.333 spec update:
18+
19+
Github Issues
20+
21+
* Fix `const` pNext in returnedonly="true" structs (public PR 2601).
22+
* Update description of queue objects to omit "`execution engines`"
23+
(public issue 2604).
24+
25+
Internal Issues
26+
27+
* Add CI checks in xml_consistency.py for cases where pNext members must
28+
not be `const` (internal issue 2734).
29+
* Use "`for each element`" instead of "`for any element`" in VUs for ray
30+
tracing extensions, and document this pattern in the style guide
31+
(internal issue 4534).
32+
* Add acceleration structures to vkUpdateDescriptorSetWithTemplate VU
33+
01685 (internal issue 4536).
34+
* Add common query results VUs restricting
35+
VK_QUERY_RESULT_WITH_STATUS_BIT_KHR based on the query type (internal
36+
issue 4484).
37+
* Fix `const` pNext in VkPhysicalDeviceDataGraphModelFeaturesQCOM
38+
(internal MR 7804).
39+
* Merge INTEL, NN, NV, QCOM, and QNX extension markup in separate files
40+
into the chapters they are included from (internal issue 4516).
41+
* Update pipeline library dependency explanation in the
42+
VK_KHR_ray_tracing_pipeline extension appendix (internal MR 7828).
43+
44+
New Extensions
45+
46+
* VK_EXT_custom_resolve
47+
* VK_EXT_ray_tracing_invocation_reorder
48+
49+
'''
50+
1751
Change log for November 7, 2025 Vulkan 1.4.332 spec update:
1852

1953
Github Issues

ChangeLogSC.adoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,27 @@ with any public pull requests that have been accepted.
1212

1313
-----------------------------------------------------
1414
15+
Change log for November 10, 2025 Vulkan SC 1.0.20 spec update:
16+
17+
* update release number to 20 for this update and reflow spec language (#273/!417)
18+
19+
Public issues:
20+
21+
* None
22+
23+
Internal issues:
24+
25+
* Enable legacy appendix for Vulkan SC (#269/!415)
26+
* Add VKSC_VERSION_1_0 listing to Core Versions appendix (!416)
27+
* Merge VK 1.4.330 tag to sc_main (!414)
28+
* Merge VK 1.4.329 tag to sc_main (!413)
29+
* Merge VK 1.4.326 tag to sc_main (!412)
30+
* Add description of API compatibility between Vulkan and Vulkan SC (#272/!411)
31+
* Import reuse fix from github (!410)
32+
* Fix limittype for supportsNonZeroFirstInstance (!409)
33+
34+
-----------------------------------------------------
35+
1536
Change log for August 1, 2025 Vulkan SC 1.0.19 spec update:
1637

1738
* update release number to 19 for this update and reflow spec language (#258/!408)

Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -151,12 +151,12 @@ VERBOSE =
151151
# ADOCOPTS options for asciidoc->HTML5 output
152152

153153
NOTEOPTS = -a editing-notes -a implementation-guide
154-
PATCHVERSION = 332
154+
PATCHVERSION = 333
155155
BASEOPTS =
156156

157157
ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))
158158
VKSPECREVISION := 1.2.$(PATCHVERSION)
159-
SCPATCHVERSION = 19
159+
SCPATCHVERSION = 20
160160
SPECREVISION = 1.0.$(SCPATCHVERSION)
161161
BASEOPTS = -a baserevnumber="$(VKSPECREVISION)"
162162
else
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
// Copyright 2025 The Khronos Group Inc.
2+
//
3+
// SPDX-License-Identifier: CC-BY-4.0
4+
5+
include::{generated}/meta/{refprefix}VK_EXT_custom_resolve.adoc[]
6+
7+
=== Other Extension Metadata
8+
9+
*Last Modified Date*::
10+
2025-05-13
11+
*IP Status*::
12+
No known IP claims.
13+
*Interactions and External Dependencies*::
14+
- This extension interacts with `apiext:VK_KHR_dynamic_rendering`
15+
- This extension interacts with
16+
`apiext:VK_EXT_dynamic_rendering_unused_attachments`
17+
- This extension interacts with `apiext:VK_EXT_fragment_density_map`
18+
- This extension interacts with `apiext:VK_EXT_graphics_pipeline_library`
19+
- This extension interacts with `apiext:VK_EXT_shader_object`
20+
*Contributors*::
21+
- Mike Blumenkrantz, Valve
22+
- Connor Abbott, Valve
23+
- Samuel Pitoiset, Valve
24+
- Matthew Netsch, Qualcomm
25+
- Jan-Harald Fredriksen, ARM
26+
- Ting Wei, ARM
27+
- Ricardo Garcia, Igalia
28+
- Spencer Fricke, LunarG
29+
- Piers Daniell, Nvidia
30+
31+
=== Description
32+
33+
This extension provides functionality for using shaders to resolve
34+
multisample rendering attachments.
35+
36+
It builds upon mechanics introduced by VK_QCOM_render_pass_shader_resolve,
37+
additionally adding support for dynamic rendering.
38+
39+
include::{generated}/interfaces/VK_EXT_custom_resolve.adoc[]
40+
41+
=== Issues
42+
43+
1) How will this work with shader objects?
44+
45+
Some vendors emit an epilog at the end of the FS that stores each
46+
color/depth/stencil attachment to the appropriate tilebuffer location, and
47+
to do that they need to know the layout of the tilebuffer which depends on
48+
the attachment formats/sample counts.
49+
We agreed that for shader object the FS epilog is emitted dynamically when
50+
the draw happens.
51+
52+
=== Version History
53+
54+
* Revision 1, 2025-05-13 (Mike Blumenkrantz)
55+
** Initial draft
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
// Copyright (c) 2024-2025 Khronos Group
2+
//
3+
// SPDX-License-Identifier: CC-BY-4.0
4+
5+
include::{generated}/meta/{refprefix}VK_EXT_ray_tracing_invocation_reorder.adoc[]
6+
7+
=== Other Extension Metadata
8+
9+
*Last Modified Date*::
10+
2025-11-12
11+
*Interactions and External Dependencies*::
12+
- This extension provides API support for
13+
{GLSLregistry}/ext/GLSL_EXT_shader_invocation_reorder.txt[`GL_EXT_shader_invocation_reorder`]
14+
*Contributors*::
15+
- Eric Werness, NVIDIA
16+
- Ashwin Lele, NVIDIA
17+
- Daniel Koch, NVIDIA
18+
- Vikram Kushwaha, NVIDIA
19+
- Piers Daniell, NVIDIA
20+
- Stu Smith, AMD
21+
- Aaron Hagan, AMD
22+
- Tyler Nowicki, AMD
23+
- Sebastian Neubauer, AMD
24+
- Radoslaw Drabinski, Intel
25+
- Sven Woop, Intel
26+
- Aleksandra Krstic, QUALCOMM
27+
- Andrew Garrard, Imagination Technologies
28+
- Mathieu Robart, Arm Limited
29+
- Tom Olson, Khronos
30+
- Ralph Potter, Samsung Electronics
31+
- Antonio Caggiano, LunarG
32+
33+
=== Description
34+
35+
The ray tracing pipeline API provides some ability to reorder for locality,
36+
but it is useful to have more control over how the reordering happens and
37+
what information is included in the reordering.
38+
The shader API provides a hit object to contain result information from the
39+
hit which can be used as part of the explicit sorting plus options that
40+
contain an integer for hint bits to use to add more coherency.
41+
42+
include::{generated}/interfaces/VK_EXT_ray_tracing_invocation_reorder.adoc[]
43+
44+
45+
=== Version History
46+
47+
* Revision 1, 2025-11-12 (Eric Werness)
48+
** Internal development - forked from NV

appendices/VK_KHR_ray_tracing_pipeline.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -317,7 +317,7 @@ There are two main reasons for the difference here:
317317
--
318318

319319
(6) Why is `apiext:VK_KHR_pipeline_library` an interaction instead of a
320-
required dependency, particularly when the "`Feature Requirements`" section
320+
required dependency, particularly when the "`Device Extensions`" section
321321
says it is required to be supported anyhow?
322322
--
323323
*RESOLVED*: If the `apiext:VK_KHR_pipeline_library` extension were a
@@ -326,7 +326,7 @@ extension whether or not they actually want to use the pipeline library
326326
functionality.
327327
Developers found this to be annoying and unfriendly behavior.
328328
We do wish to require all *implementations* to support it though, and thus
329-
it is listed in the feature requirements section.
329+
it is listed as a requirement in device extensions section.
330330
--
331331

332332

appendices/glossary.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1526,6 +1526,14 @@ ifdef::VK_NV_ray_tracing_motion_blur[]
15261526
* code:OpHitObjectTraceRayMotionNV
15271527
endif::VK_NV_ray_tracing_motion_blur[]
15281528
endif::VK_NV_ray_tracing_invocation_reorder[]
1529+
ifdef::VK_EXT_ray_tracing_invocation_reorder[]
1530+
* code:OpHitObjectTraceRayEXT
1531+
* code:OpHitObjectTraceReorderExecuteEXT
1532+
ifdef::VK_NV_ray_tracing_motion_blur[]
1533+
* code:OpHitObjectTraceRayMotionEXT
1534+
* code:OpHitObjectTraceMotionReorderExecuteEXT
1535+
endif::VK_NV_ray_tracing_motion_blur[]
1536+
endif::VK_EXT_ray_tracing_invocation_reorder[]
15291537

15301538
endif::VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing[]
15311539

appendices/legacy.adoc

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -54,10 +54,6 @@ the Extensions chapter>> for more information.
5454
When functionality is marked as legacy or if an extension supersedes it, an
5555
explanation will be added to the following sections.
5656

57-
ifdef::VKSC_VERSION_1_0[]
58-
This section is currently empty for Vulkan SC.
59-
endif::VKSC_VERSION_1_0[]
60-
ifndef::VKSC_VERSION_1_0[]
6157
[NOTE]
6258
====
6359
This list is a work in progress - we intend to add other items to this
@@ -84,6 +80,8 @@ provided in the pname:pNext chain of slink:VkDeviceCreateInfo instead of
8480
using slink:VkDeviceCreateInfo::pEnabledFeatures.
8581
endif::VK_BASE_VERSION_1_1[]
8682

83+
ifndef::VKSC_VERSION_1_0[]
84+
// these were never included in VKSC 1.0
8785
[[legacy-version-macros]]
8886
=== Version Macros: Superseded via replacements including API variant
8987

@@ -94,6 +92,7 @@ that do, such as dlink:VK_MAKE_API_VERSION or dlink:VK_API_VERSION_MAJOR.
9492
Instead of dlink:VK_API_VERSION, specific version defines (e.g.
9593
dlink:VK_API_VERSION_1_0) or the dlink:VK_MAKE_API_VERSION macro should be
9694
used instead.
95+
endif::VKSC_VERSION_1_0[]
9796

9897
[[legacy-devicelayers]]
9998
=== Device Layers: Superseded via instance layers
@@ -170,4 +169,3 @@ Outside of vendor extensions, applications are advised to make use of
170169
flink:vkCmdBeginRendering and flink:vkCmdEndRendering to manage render
171170
passes from this API version onward.
172171
endif::VK_GRAPHICS_VERSION_1_4,VK_KHR_dynamic_rendering_local_read[]
173-
endif::VKSC_VERSION_1_0[]

0 commit comments

Comments
 (0)