-
Notifications
You must be signed in to change notification settings - Fork 454
/
ChangeLog.txt
9888 lines (8238 loc) · 453 KB
/
ChangeLog.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Copyright 2016-2021 The Khronos Group Inc.
SPDX-License-Identifier: CC-BY-4.0
Update Log for the Vulkan-Docs repository on Github. Updates are in reverse
chronological order starting with the latest public release.
This summarizes the periodic public updates, not individual commits. Updates
on Github are done as single large patches at the release point, collecting
together the resolution of many Khronos internal issues, along with any
public pull requests that have been accepted.
-----------------------------------------------------
Change log for December 7, 2021 Vulkan 1.2.202 spec update:
* Update release number to 202 for this update.
Github Issues:
* Split some valid usage statements for slink:VkAttachmentDescription
so they can have appropriate conditional protection
(public pull request 1698).
* Clean up links to GLSL and SPIR-V extension documents (public pull
request 1705).
* Fix markup for <<primsrast-polygon-barycentrics, perspective
interpolation>> math (public pull request 1711).
Internal Issues:
* Clarify valid usage statements for
flink:vkCmdWriteTimestamp2KHR::pname:stage to accomodate
ename:VK_PIPELINE_STAGE_2_NONE_KHR (internal issue 2867).
* Disallow descriptorset decorations on non-descriptor ray tracing
variables in the <<spirvenv-module-validation-standalone, Standalone
SPIR-V Validation>> section (internal issue 2881).
* Fix sentence describing behavior when
slink:VkRenderingFragmentDensityMapAttachmentInfoEXT is not present in
the slink:VkRenderingInfoKHR::pname:pNext chain (internal issue 2881).
* Require that
slink:VkPhysicalDeviceRayTracingPipelinePropertiesKHR::pname:shaderGroupHandleAlignment
be a power of two (internal merge request 4943).
* Add a new ename:VK_IMAGE_ASPECT_NONE_KHR=0 enum to
slink:VkImageAspectFlagBits in the apiext:VK_KHR_maintenance4 extension
so that pname:planeAspect can be set to zero without having to use a
cast, and fix some typos (internal merge request 4961).
* Add "`must: be a power of two`" to all alignment limits (internal issue
2939).
* Make all limit anchors follow the `[[limit-NAME]]` style (internal merge
request 4969).
* Require render pass to be valid and add missing state subset
dependencies to slink:VkGraphicsPipelineCreateInfo valid usage
statements for apiext:VK_ARM_rasterization_order_attachment_access
(internal merge request 4970).
* Parameterize OpenGL and GLSL extension registry URLs via asciidoctor
attributes in `config/attribs.txt`, and move the existing SPIR-V
extension registry URL from the Makefile into that file. Use `https:`
prefixes on URLs instead of `http:` where possible.
-----------------------------------------------------
Change log for November 30, 2021 Vulkan 1.2.201 spec update:
* Update release number to 201 for this update.
Github Issues:
* Fix typo in refpage description of ename:VK_REMAINING_MIP_LEVELS
(public pull request 1702).
* Add missing structextends attribute for
slink:VkPhysicalDeviceRasterizationOrderAttachmentAccessFeaturesARM
(public issue 1703).
* Fixes and clarifications to valid usage statements for
slink:VkRenderPassCreateInfo,
slink:VkRenderPassFragmentDensityMapCreateInfoEXT, and
slink:VkSubpassDescriptionDepthStencilResolve (matching changes in
public Vulkan-ValidationLayers pull request 3571).
Internal Issues:
* Changes to the provisional video extension encode rate control API,
including changing some existing structures and adding new structures
and flags (internal issue 1844).
* Update valid usage statements for apiext:VK_NV_mesh_shader (internal
issue 2880).
* Remove valid usage statement IDs 02854 / 02855 / 06081 / 06082, which
are duplicates of 06166 / 06167 (internal issue 2944).
* Add a valid usage statement banning code:OpImage*Dref* instructions on
non-depth views (internal merge request 3889).
* Add CI test for disallowed contractions (internal merge request 4934).
* Generate the <<formats-compatibility, Format Compatibility Class Table>>
from XML tags (internal merge request 4936).
* Clarify that dependent operations of quad-sensitive ops have helpers
(internal merge request 4947).
* Remove redundant valid usage statement for
apiext:VK_QCOM_render_pass_shader_resolve (internal merge request 4950).
* Support `api` attribute fully in XML and scripts (internal merge request
4951).
* Fix pname:planeIndex attribute in format XML for
ename:VK_FORMAT_G10X6_B10X6R10X6_2PLANE_422_UNORM_3PACK16 (internal
merge request 4953).
-----------------------------------------------------
Change log for November 23, 2021 Vulkan 1.2.200 spec update:
* Update release number to 200 for this update.
Github Issues:
* Refer to flink:vkCmdPipelineBarrier2KHR::pname:pDependencyInfo as a
pointer, not an array (public issue 1456).
* Fix spelling and add backwards-compatibility aliases for some
elink:VkPipelinCreateFlagBits values (public issue 1676).
* Fix typo in apiext:VK_INTEL_shader_integer_functions2 (public issue
1696).
* Replace usage of {depth, color} buffer with {depth, color} attachment
(public pull request 1701).
* Add restriction to the <<formats-mandatory-features-depth-stencil,
manadatory format support table>> for depth/stencil formats preventing
implementations from advertising those bits in
slink:VkFormatProperties::pname:bufferFeatures (public
Vulkan-ValidationLayers issue 3225).
Internal Issues:
* Add an additional guarantee for buffer memory requirements in
slink:VkMemoryRequirements as a minor update to the
apiext:VK_KHR_maintenance4 extension (internal issue 2885).
* Add a <<fundamentals-api-name-aliases, section to the fundamentals
chapter>> describing typo aliases (internal issue 2897).
* Determine extensions dependencies directly from `vk.xml` in the build
scripts, rather than generating an auxiliary `extDependency.py` target
(internal issue 2923).
* Remove redundant SPIR-V `RuntimeSpirv` valid usage statements 04830,
06271, 06374, and 06375 (internal merge requests 4827, 4830).
* Suppress file-not-found `include::` errors for validusage target, using
an IncludeProcessor extension, due to the way in which the validusage
extension processes conditionals. Make all include paths absolute and
require this in the style guide (internal merge request 4925).
* Add missing `optional="true"` attribute to
slink:VkCommandBufferInheritanceRenderingInfoKHR::pname:colorAttachmentCount
(internal merge request 4935).
* Remove references to apiext:VK_KHR_synchronization2 enums when that
extension is not enabled in the specification being built (internal
merge request 4937).
* Minor wording changes for style guide compliance and consistency
(internal merge request 4938).
* Ignore etext:*_EXTENSION_NAME and etext:*_SPEC_VERSION aliases in
`makemanaliases.py` script since there are no corresponding refpages for
these meta-enums.
New Extensions:
* apiext:VK_ARM_rasterization_order_attachment_access (internal merge
request 3856).
* apiext:VK_EXT_depth_clip_control (public issues 986 and 1054).
-----------------------------------------------------
Change log for November 16, 2021 Vulkan 1.2.199 spec update:
* Update release number to 199 for this update.
Github Issues:
* Add upper bound for stext:AccelerationStructure geometry limits for
slink:VkPhysicalDeviceRayTracingPropertiesNV and
slink:VkPhysicalDeviceAccelerationStructurePropertiesKHR (public issue
1670).
* Trivial typos in proposal documents (public pull request 1682).
* Add missing stage mask common valid usage statements to
slink:VkSubmitInfo, slink:VkSubpassDependency, and
slink:VkSubpassDependency2; remove unused common VU 4098; and add new
stage mask VUs to flink:vkCmdBeginRenderPass,
flink:vkCmdBeginRenderPass2, flink:vkCmdSetEvent, flink:vkCmdResetEvent,
flink:vkCmdWaitEvents, and flink:vkCmdPipelineBarrier (public
Vulkan-ValidationLayers pull request 3331).
Internal Issues:
* Fix formatting of <<versions-1.0, Vulkan 1.0>> appendix section headers
(internal issue 2921).
* Fix location of bad conditional `endif::` in SPIR-V environment appendix
VU 06271 (internal issue 2917).
* Use etext:VK_VERSION_m_n instead of etext:VK_API_VERSION_m_n in
`<spirvcapability>` and `<spirvextension>` XML tags for consistency with
other version / extension reqiurements. Note that there is a possibility
of this change affecting downstream consumers of the XML (internal issue
2896).
* Add refpage cross-reference from slink:VkSwapchainKHR to
flink:vkQueuePresent (internal issue 2823).
* Update apiext:VK_KHR_dynamic_rendering
proposal document to use etext:STORE_OP_DONT_CARE
(internal merge request 4924).
* Fix most remaining dead links in the published specifications and
refpages by adding missing API language for basetype:VkFlags64;
stub reference pages for apiext:VK_NVX_binary_import; and
tag refpage aliases for API constants which were promoted to core
(internal merge request 4921).
* Add description of elink:VkFormats in the new <formats>
tag for `vk.xml`, and corresponding schema and script updates.
(internal issues 1761, 2484, and 2811).
New Extensions:
* apiext:VK_EXT_image_view_min_lod (internal merge request 4701).
-----------------------------------------------------
Change log for November 9, 2021 Vulkan 1.2.198 spec update:
* Update release number to 198 for this update.
Github Issues:
* Sort dependencies of "`Provided by`" comments in generated API includes,
and remove duplicates (public issue 1483, internal issue 2620).
* Remove max-width attribute from document headers, causing CSS to limit
page width in wide windows (public pull request 1660).
Internal Issues:
* Filter out `VK_VERSION_1_x` pages when generating refpage sources for a
build that does not include the corresponding core version (internal
issue 1971).
* Adjust section header level for extension appendix refpages to match
other refpages (internal issue 2151).
* Add and fix protected memory valid usage statements to require queues be
protected if any batch if a protected batch, and restrict indirect
operations when pname:protectedNoFault is supported (internal issues
2169, 2841)
* Generate refpages to SPIR-V builtins, which were marked up in the spec
source but not being extracted and built (internal issue 2395).
* Clarify VUID 04918 regarding use of code:Location decorations (internal
issue 2737).
* Remove redundant nested VK_VERSION_1_1 conditional markup from the
<<initialization>> chapter (internal issue 2851).
* Add code:IdrPicFlag to code:StdVideoDecodeH264PictureInfoFlags for
provisional video extensions (internal issue 2901).
* Fix incorrect example code in apiext:VK_HUAWEI_subpass_shading appendix
sample code (internal merge request 4889).
* Promote ename:VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT and
ename:VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT in a few
places where the etext:KHR suffixes had not been removed (internal merge
request 4902).
* Add missing format properties consistency checks for
slink:VkDrmFormatModifierPropertiesList2EXT and
slink:VkAndroidHardwareBufferFormatProperties2ANDROID.
* Minor editorial markup fixes.
-----------------------------------------------------
Change log for November 2, 2021 Vulkan 1.2.197 spec update:
* Update release number to 197 for this update.
Github Issues:
* Align some of the provisional video standard headers enums and bitfields
to have predictable sizes (public issue 1571).
* Remove exporting of D3D memory handles from
slink:VkExportMemoryWin32HandleInfoKHR (public pull request 1612).
* Add language to slink:VkAccelerationStructureBuildGeometryInfoKHR
explicitly stating that source and target acceleration structures are
allowed to be the same or different during an update (public issue
1641).
* Fix typos (public pull request 1662).
* Register remaining newly introduced `vk_video` types in `vk.xml` (public
pull request 1663).
Internal Issues:
* Clarify <<resources-external-sharing, ownership transfers on external
resources>> (internal issue 2692).
* Changes to (nearly) eliminate dead internal links and improve scripts:
** Correctly generate API dependencies on extensions and core versions in
cases where "`spelling aliases`" were present
** Clean up a few incorrectly marked up links, anchors, and refpage block
alias= attributes
** Use an API alias map to substitute promoted API names for promoted-to
APIs when an older or restricted spec is being generated and the
promoted-to API is not included
* Tag sname:VkVideo{Encode,Decode}H26{4,5}ProfileEXT structures as
extending slink:VkQueryPoolCreateInfo in `vk.xml` (internal issue 2861).
* Grammar edits to slink:VkAccelerationStructureKHR (internal issue 2887).
* Change the cited title of the <<LoaderInterfaceArchitecture>> document
to "`Architecture of the Vulkan Loader Interfaces`" matching a recent
change in https://github.com/KhronosGroup/Vulkan-Loader/pull/685
(internal merge request 4823).
* Re-remove etext:VkVideoEncodeH265CapabilityFlagBitsEXT, which was
accidentally reintroduced but is still unused (internal merge request
4885).
* Update wording for
ename:VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR since it no
longer contains `"update`" (internal merge request 4886).
* Consistency edits to remove "`instance of`" when referring to a specific
structure, and use "`render pass`" instead of "`renderpass`" as a noun
(internal merge request 4896).
* Add -version option to 'makeSpec' frontend build script.
New Extensions
* `<<VK_KHR_dynamic_rendering>>`
-----------------------------------------------------
Change log for October 13, 2021 Vulkan 1.2.196 spec update:
* Update release number to 196 for this update.
Github Issues:
* Clarify normative language for
ename:VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT in
elink:VkImageUsageFlagBits, allowing two styles of implementation
(public issue 1616).
* Fix typo in flink:vkCmdSetScissor (public pull request 1659).
* Reorder attributes of elink:VkFormatFeatureFlags2KHR in `vk.xml` for
consistency (public pull request 1653).
Internal Issues:
* More cleanup of internal broken links in various builds of the specs.
Fix typos on xrefs and anchors, add stub pages for missing Flags and
FlagBits types, update `spirvcapgenerator.py` to put anchors with the
same table row they belong to, validate `apiext:` macro targets at build
time, and don't generate API requirements for `<type>` tags with no
`category`, eliminating spurious warnings for external types (internal
issues 2864, 2866).
* Update `htmldiff` scripts for Python3.
* Add subsection titles and anchors in the <<fxvertex, Fixed-Function
Vertex Processing>> chapter to make thematic breaks more clear (internal
merge request 4867).
New Extensions
* `<<VK_EXT_border_color_swizzle>>`
* `<<VK_EXT_video_encode_h265>>` *provisional* H.265 video encode codec extension
-----------------------------------------------------
Change log for October 5, 2021 Vulkan 1.2.195 spec update:
* Update release number to 195 for this update.
Github Issues:
* Add a NOTE to flink:vkDestroyQueryPool clarifying when a query pool can
be destroyed (public issue 1647).
Internal Issues:
* Begin cleanup of internal broken links in various builds of the specs,
including generating a Ruby API map to be used by the asciidoctor macros
to validate their API name arguments; using "nofollow" on github issue
opening links to avoid link-checkers being interpreted as DOS attacks;
improved checker scripts; minor markup fixes; and using the `apiext:`
macro to replace `<<VK_KHR_extension_name>>`-style extension links
everywhere (internal issue 2831).
* Minor editorial cleanups to descriptions of
`apiext:VK_FUCHSIA_buffer_collection` APIs (internal issue 2836).
* Match `Cull Mask` SPIR-V name to pname:mask parameter name in the
<<acceleration-structure, Acceleration Structures>> chapter (internal
merge request 4844).
* Add pname:minTexelOffset and pname:maxTexelOffset limit valid usage
statements for code:OpImageSample* and code:OpImageFetch* in the
<<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
section (internal merge request 4845).
* Add pname:maxFragmentDualSrcAttachments and
pname:maxFragmentCombinedOutputResources limit valid usage statements
for output and color attachments in the
<<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
section (internal merge request 4847).
New Extensions
* `<<VK_KHR_format_feature_flags2>>`
* `<<VK_KHR_maintenance4>>`
* `<<VK_EXT_rgba10x6_formats>>`
-----------------------------------------------------
Change log for September 28, 2021 Vulkan 1.2.194 spec update:
* Update release number to 194 for this update.
Github Issues:
* Add missing `len` attribute to
slink:VkCuModuleCreateInfoNVX::pname:pData (public merge request 1646).
* Refer to dynamic state consistently from ftext:vkCmdSet* commands, and
link to the definition of dynamic state (public issue 1428, but with
expanded scope beyond the actual ask in that issue).
Internal Issues:
* Fix incorrect member name in slink:VkRenderPassCreateInfo valid usage
statement 02515 (internal issue 2824).
* Fix XML dependency for `<<VK_NV_device_generated_commands>>` (internal
issue 2818).
* Add packed formats from `<<VK_KHR_sampler_ycbcr_conversion>>`` to the
<<formats-packed, table of packed formats>> and improve description of
packed format naming conventions (internal merge request 4798).
New Extensions
* `<<VK_FUCHSIA_buffer_collection>>`
-----------------------------------------------------
Change log for September 21, 2021 Vulkan 1.2.193 spec update:
* Update release number to 193 for this update.
Github Issues:
* Use consistent `implicitexternsync` language in XML for
flink:vkDestroyDevice (public issue 1482).
* Clarify requirements of flink:vkGetInstanceProcAddr to match that of the
Android loader when attempting to retrieve a global function with a
non-NULL instance parameter (public issue 1605).
* Add new elink:VK_DRIVER_ID reservations for upcoming Mesa drivers
(public pull request 1642).
Internal Issues:
* Fix flink:vkCmdEndDebugUtilsLabelEXT to clarify command buffer recording
interactions with debug labels (internal issue 2777).
* Improve NOTE for acceleration structure capture / replay in
slink:VkAccelerationStructureCreateInfoKHR (internal issue 2769).
* Add "`See Also`" crosslinks to extension refpages providing aliased APIs
in API refpages (internal issue 2819).
* Fix markup for core version (`VK_VERSION_1_0`, etc.) refpages -
asciidoctor doesn't allow section headers here and this affected the
specification appendix rendering (internal issue 2826).
* Use open range notation for slink:VkSamplerCreateInfo
ptext:addressMode[UVW] descriptions (internal issue 2829).
* Replace term "`channel`" with "`component`" when discussing formats, and
update glossary to help clarify formats such as
ename:VK_FORMAT_E5B9G9R9_UFLOAT_PACK32 and
ename:VK_FORMAT_B10X6G10X6R10X6G10X6_422_UNORM_4PACK16 (internal merge
request 4799).
* Fix some primitive_topology_list_restart VUIDs to only apply if
pname:primitiveRestartEnable is ename:VK_TRUE (internal merge request
4818).
* Fix slink:VkPhysicalDeviceShaderCorePropertiesAMD `limittype` attributes
in XML (internal merge request 4819).
* Fix accidentally duplicated VUIDs 06256 due to missing {accessMaskName}
in VUID markup (internal merge request 4829).
* Miscellaneous minor formatting and style fixes (internal merge requests
4832, 4838).
-----------------------------------------------------
Change log for September 14, 2021 Vulkan 1.2.192 spec update:
* Update release number to 192 for this update.
Github Issues:
* Correctly describe slink:VkDeviceQueueInfo2::pname:pNext (public issue
1622).
* Improve behavior of contact links from extension metadata generator
(public merge request 1635).
* Require slink:VkDeviceAddress in 1.0 spec conditional markup, matching
XML (public issue 1636).
Internal Issues:
* Turn <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
section into formal Valid Usage statements with assigned valid usage IDs
(internal issue 1598).
* Use `pass:[~~~~]` delimiters for `[source]` blocks inside reference page
`[open]` blocks to bypass logic problem with VUID assignment script
(internal issue 2040).
* Update style guide to incorporate Khronos Inclusive Language document by
reference. Followon changes will apply the suggestions as needed
(internal issue 2293).
* Add clarifications about ray tracing transform matrices to
slink:VkAccelerationStructureGeometryTrianglesDataKHR,
slink:VkAccelerationStructureBuildOffsetInfoKHR, and the
<<ray-intersection-candidate-determination, Ray Intersection Candidate
Determination>> section (internal issue 2709).
* Clarify descriptor requirements for code:Buffer and code:Subpassdata in
the <<interfaces-resources-correspondence, Shader Resource and
Descriptor Type Correspondence>> table (internal issue 2751).
* Add aliases for versioned extensions which don't treat the trailing
version number as a separate word, such as
ename:VK_KHR_MAINTENANCE1_SPEC_VERSION ->
ename:VK_KHR_MAINTENANCE_1_SPEC_VERSION, and add a CI test in
`scripts/xml_consistency.py` to try and detect future occurrences
(internal issue 2810).
* Add missing pname:sType and pname:pNext boilerplate descriptions to spec
language for several elink:*Features structures that were missing it
(though they did have them in the XML definition of the structures)
(internal issue 2815).
* Add extension and version crosslinks to generated reference pages,
expressing the same information in the `Provided by` comments in
generated API includes (internal issue 2816).
* Move the old "`Fragment Shader Execution`" section from the <<shaders>>
chapter to the <<fragops-shader, Fragment Shading>> section of the
<<fragops>> chapter, change anchor names accordingly, and factor out
common related language from several parts of the spec into this section
(internal merge request 4765).
* Allow access to the code:PrimitiveId builtin from shaders declared with
the code:MeshShadingNV capability (internal merge request 4767).
* Make the <<features-primitiveTopologyListRestart,
pname:primitiveTopologyListRestart>> feature mandatory for
`<<VK_EXT_primitive_topology_list_restart>>` (internal merge request
4790).
* Edit <<limits-types, Required Limit Types>> table to add Vulkan 1.2
interactions for pname:filterMinmaxSingleComponentFormats and
pname:filterMinmaxImageComponentMapping limits (internal merge request
4802).
* Add ename:VK_FORMAT_R10X6_UNORM_PACK16 and
ename:VK_FORMAT_R12X4_UNORM_PACK16 to the list of 16-bit packed formats,
and fix formatting of "`wildcard`" enums containing a placeholder _i_
tag corresponding to supported integers (internal merge request 4803).
* Refactor CI scripts to use the Makefile `allchecks` target as part of CI
instead of multiple separate steps, allowing a quick local check
equivalent to that part of CI, and update that target accordingly
(internal merge request 4807).
* Make slink:VkImageCreateInfo valid usage statement 01572 apply to all
compressed formats (internal merge request 4812).
-----------------------------------------------------
Change log for September 7, 2021 Vulkan 1.2.191 spec update:
* Update release number to 191 for this update.
Internal Issues:
* Update checker scripts to detect extension number conflicts in `vk.xml`,
and run the check in CI (internal issue 2612).
* Minor cleanup for the provisional video extensions, including
documenting a few undocumented enums and structure members and some
language cleanup (internal issue 2705).
* Add a NOTE to flink:vkAllocateMemory.txt about protected memory
allocation count limits (internal issue 2791).
* Use "`cube map`" rather than "`cubemap`" spelling, and add this case to
the style guide (internal merge request 4794).
New Extensions:
* `<<VK_EXT_pageable_device_local_memory>>`
-----------------------------------------------------
Change log for August 29, 2021 Vulkan 1.2.190 spec update:
* Update release number to 190 for this update.
* Released a few days in advance of the usual Tuesday spec updates due to
holiday meeting schedule.
Github Issues:
* Make treatment of empty etext:Vk*FlagBits types consistent in `vk.xml`
(public issue 1601 and merge request 1609)
Internal Issues:
* Add more descriptive language for transforms in the
<<ray-intersection-candidate-determination, Ray Intersection Candidate
Determination>> section (internal issue 2709).
* Update `-validate` logic in registry scripts to validate the `limittype`
attribute presence and values where required (internal issue 2606).
* Update common validity statements for access masks to allow shader
pipeline bits to be use with ename:VK_ACCELERATION_STRUCTURE_READ_BIT
(internal issue 2782).
* Fix typo in the description of code:CullDistancePerViewNV (internal
merge request 4769).
* Various fixes and simplifications for
<<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>> valid
usage statements:
** Flatten markup for VK_KHR_shader_subgroup_extended_types valid usage
statements (internal issue 1598)
** Flatten markup for VK_EXT_shader_atomic_float valid usage statements
(internal issue 1598).
** Remove asciidoctor conditional check for
`VK_KHR_storage_buffer_storage_class`, not needed because the SPIR-V
specification is unified and `spirv-val` will throw an error if trying
to use code:StorageBuffer without the proper extension / version being
set (internal merge request 4779).
New Extensions:
* `<<VK_KHR_shader_integer_dot_product>>`
* `<<VK_EXT_primitive_topology_list_restart>>`
-----------------------------------------------------
Change log for August 17, 2021 Vulkan 1.2.189 spec update:
* Update release number to 189 for this update.
Github Issues:
* Add parent check valid usage statements to flink:vkUpdateDescriptors
(public issue 1581).
* Document the feature requirement for separate depth/stencil layouts in
the <<resources-image-layouts, Image Layouts>> section (public issue
1583).
* Revert a valid usage statement constraining
slink:VkMemoryAllocateInfo::pname:allocationSize (public issue 1595).
* Remove misleading reference to `z` from the description of image
coordinates for slink:VkSamplerCreateInfo::pname:unnormalizedCoordinates
(public issue 1602).
* Fix typo in <<fxvertex-input-extraction>> section (public pull request
1604).
* Fix comment in example for `<<VK_EXT_debug_utils>>` appendix to
correctly reference pname:objectHandle, not ptext:object (public pull
request 1606).
* Revert `vk_platform.h` path change in `vk.xml` from public pull request
1538, which was causing build issues for some projects. We will revisit
this in the future but did not want to put a problematic change into the
next SDK update (public pull request 1610).
Internal Issues:
* Use `hexapdf` for PDF optimization, rather than Ghostscript. This
improves overall PDF generation time about 15-20%, and final PDF size by
about 1/3 (internal issue 2422).
* Improve contrast for better accessibility of HTML outputs, based on
feedback from the ANDI tool. This includes updating the specification
CSS in `config/khronos.css`, switching to the rouge source code
highlighter instead of coderay, and overriding some of the rouge theme
CSS (internal issue 2784).
* Clarify that transforms are consumed only if transformData is non-null
for slink:VkAccelerationStructureBuildRangeInfoKHR.txt (internal issue
2787).
* Make spec language describing bitmasks consistent as 'Bits which can: be
set' (internal merge request 4762).
* Support `optional` attribute in the valid usage statement generator for
union types (internal merge request 4772).
-----------------------------------------------------
Change log for August 10, 2021 Vulkan 1.2.188 spec update:
* Update release number to 188 for this update.
Github Issues:
* Add missing `optional="true"` attributes to pname:pNext members. Enable
`scripts/xml_consistency.py` in CI, and add check for this case (public
pull request 1597).
* Add missing markup (setting `refpage` attributes where they were needed
for commonvalidity statements) to fix some broken valid usage ID link
names (public issue 1598).
* Update valid usage statement 02650 to use "`potential format features`"
consistently with other recent changes (discussion on public
Vulkan-ValidationLayers pull request 3139).
Internal Issues:
* Clarify the role of <<ray-traversal-culling-face, face winding>> in the
context of ray intersection candidate determination and alias
ename:VK_GEOMETRY_INSTANCE_TRIANGLE_FRONT_COUNTERCLOCKWISE_BIT_KHR to
ename:VK_GEOMETRY_INSTANCE_TRIANGLE_FLIP_FACING_BIT_KHR, corresponding
to the clarifications (internal issue 2780).
* Add valid usage statement for flink:vkCmdBeginTransformFeedbackEXT
requiring a valid graphics pipeline be bound (internal issue 2785).
* Use the term <<acceleration-structure-def, "`constructed`">> to refer to
an acceleration structure that was previously built or created by
copying or deserialization of a built acceleration structure (internal
merge request 4727).
* Add explicit valid usage statements to flink:vkWaitForPresentKHR and
slink:VkPresentInfoKHR requiring the corresponding features be enabled
(internal merge request 4754).
* Remove extraneous trailing periods from some valid usage statements
(internal merge request 4759).
New Extensions:
* `<<VK_EXT_load_store_op_none>>`
-----------------------------------------------------
Change log for August 3, 2021 Vulkan 1.2.187 spec update:
* Update release number to 187 for this update.
Github Issues:
* Add glossary terms for "`pipeline ray tracing instructions`" and "`ray
tracing commands`" (public issue 1578).
* Limit the code:OpTypeImage code:Unknown format restriction to storage
images in the <<spirvenv-module-validation-runtime, Runtime SPIR-V
Validation>> section (public issue 1588).
* Fix slink:VkRect2D::pname:extent in a few places where it was
misreferenced as pname:offset (public pull request 1590).
Internal Issues:
* Clarify that depth values outside the range [0,1] become undefined
following the depthClamp stage of the pipeline, by rearranging the
<<fragops-depth, Depth Test>> section and adding a new "`Depth Clamping
and Range Adjustment`" subsection (internal issues 2445, 2753).
* Clarify valid usage statement 01843 for slink:VkDeviceQueueInfo2 to
match similar statement for flink:vkGetDeviceQueue, and split off part
of it into a new VU statement (internal issue 2645).
* Fix a few enumerant and member names in the provisional video extensions
to comply with the spec style guidelinse (internal issue 2710).
* Update the descriptions of flink:vkCmdDrawMultiEXT and
flink:vkCmdDrawMultiIndexedEXT to clarify how they are equivalent to
calling underlying drawing commands multiple times with different
parameters (internal issue 2757).
* Renumber VUIDs which duplicated the numeric portion of another
non-common VUID, and add a duplicate number detection test to CI to
prevent recurrences (internal issue 2764).
* Make code:SubgroupSize command scope uniform in compute dispatches
(internal issue 2773).
* Expand the list of valid image layouts for
<<attachment-type-imagelayout, input attachments>>,
<<descriptorsets-sampleimage, sampled images>>, and
<<descriptorsets-combinedimagesampler, combined image samplers>> to
include DEPTH_READ_ONLY_OPTIMAL and STENCIL_READ_ONLY_OPTIMAL (internal
issue 2774).
* Remove `flowRoot` SVG elements from a few recent image updates, as they
are not supported by the current PDF toolchain (internal issue 2778).
* Update to asciidoctor-chunker 1.0.4, adding support for `aria-label`
accessibility tags on the chunked specification forward/back section
navigation arrows (internal issue 2784).
* Clean up description of flink:vkCmdClearAttachments and remove redundant
information (internal merge request 4717).
* Add a description of each of the
flink:vkCmdWriteAccelerationStructuresPropertiesKHR::pname:queryPool
query types (internal merge request 4728).
* Add new valid usage statement to slink:VkMemoryAllocateInfo when
allocating a memory object larger than the reported limit (internal
merge request 4737).
* Add missing description of pname:layerCount member of
slink:VkFramebufferAttachmentImageInfo (internal merge request 4744).
-----------------------------------------------------
Change log for July 27, 2021 Vulkan 1.2.186 spec update:
* Update release number to 186 for this update.
Github Issues:
* Reduce size and increase clarity of some SVG images for the provisional
video extensions (public issue 1537).
* Use a consistent description of pname:stride as "`byte stride`" rather
than "`distance in bytes`" in a few places (public issue 1575)
* Clarify the equivalence of flink:vkQueueWaitIdle to
fence submission (public issue 1579).
* Fix XML capabilities for new code:*Float*Atomic* SPIR-V capabilities to
require slink:VkPhysicalDeviceShaderAtomicFloat2FeaturesEXT rather than
slink:VkPhysicalDeviceShaderAtomicFloatFeaturesEXT (public pull request
1587, although fixed internally first).
Internal Issues:
* Refactor asciidoctor conditionals imbedded within valid usage statements
so they are extracted properly to `validusage.json`, and add a CI check
to prevent this happening in the future (internal issues 1529, 2439).
* Clarify that dynamic vertex buffer object stride of 0 is allowed in
valid usage statement for flink:vkCmdBindVertexBuffers2EXT
(internal issue 2742)
* Add valid usage statement to
ftext:vkGetPhysicalDeviceSurfaceCapabilities{KHR,2EXT,2KHR},
ftext:vkGetPhysicalDeviceSurfacePresentModes{KHR,2EXT}, and
ftext:vkGetDeviceGroupSurfacePresentModes{KHR,2EXT} requiring surface /
device compatibility (internal issue 2744).
* Clarify the requirements on code:OpTypeImage for input attachments in
the <<spirvenv-module-validation, Validation Rules within a Module>> and
<<interfaces-inputattachment, Fragment Input Attachment Interface>>
sections (internal issue 2752)
* Clarify that stipple parameters are ignored when line stipple is
disabled in slink:VkPipelineRasterizationLineStateCreateInfoEXT
(internal issue 2763)
* Improve wording for the shader interface code:Location limit in the
<<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
section (internal merge request 4693)
-----------------------------------------------------
Change log for July 20, 2021 Vulkan 1.2.185 spec update:
* Update release number to 185 for this update.
* Going forward we will probably be moving the default day for spec
updates to Tuesday (Pacific time) rather than Monday.
Github Issues:
* Clarify that only *device* extensions are required to be specified in
valid usage statement for flink:vkCreateDevice (public issue 1567).
* Fix extension dependencies for `<<VK_EXT_calibrated_timestamps>>` to
include `<<VK_KHR_get_physical_device_properties2>>` (public issue
1568).
* Conditionalize xref to VkPhysicalDeviceSubgroupProperties in
`<<VK_KHR_spirv_1_4>>` appendix so it does not show up in a 1.0 spec
build (public issue 1574).
* Relax portability usage of the identity swizzle in
slink:VkImageViewCreateInfo valid usage statement 04465 (public
KhronosGroup/Vulkan-Portability issue 27).
Internal Issues:
* Document in the <<extendingvulkan-extensions-extensiondependencies,
Extension Dependencies>> section that instance extensions do not have
dependencies on device extensions, and add a similar requirement to the
description of the `requires` attribute of extension tags in the
registry schema document (internal issue 2387).
* Fix `optional` attribute in XML for
flink:vkCmdBindVertexBuffers2EXT::pname:pBuffers (internal issue 2574).
* Remove redundant valid usage statements from flink:vkCmdPipelineBarrier,
flink:vkCmdSetEvent, and flink:vkCmdResetEvent. Add missing VUs for
slink:VkSubpassDependency and slink:VkSubpassDependency2 (internal issue
2583).
* Clarify that
ename:VK_FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR
must be supported in pname:bufferFeatures (internal issue 2686).
* Clarify that a valid function pointer pname:fp returned from
flink:vkGetInstanceProcAddr must not be `NULL` (internal issue 2720).
* Relax code:Flat, code:NoPerspective, code:Sample, and code:Centroid
storage class restriction in the
<<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
section (internal issue 2721).
* Clarify forward progress behavior of flink:vkAcquireNextImageKHR and
flink:vkQueuePresentKHR (internal issue 2729).
* Remove duplicated language describing queue submission in the
<<fundamentals-execmodel, Execution Model>> and
<<fundamentals-queueoperation, Queue Operation>> sections (internal
issue 2736).
* Describe the new pipeline stage
ename:VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI in several sections
of the <<synchronization>> chapter where it was missing (internal issue
2745).
* Improve formatting in the <<limits>> chapter, add support for the
missing optionally: normative word macro, and replace most use of
(non-normative) "`optionally`" with normative "`can:`". Update style
guide to add more contractions and remove contractions from the spec.
add a better description of the pname:shaderDrawParameters feature
(internal merge requests 4699, 4708).
* Fix name of parameter
flink:vkGetMemoryRemoteAddressNV::pname:pMemoryGetRemoteAddressInfo to
follow Vulkan conventions (internal merge request 4704).
* Minor fixes for the <<resources-image-views-compatibility, image view
compatibility table>> and related minor spec language fixes elsewhere
(internal merge request 4709).
New Extensions:
* `<<VK_EXT_shader_atomic_float2>>`
* `<<VK_HUAWEI_invocation_mask>>`
* `<<VK_KHR_present_id>>`
* `<<VK_KHR_present_wait>>`
Miscellany:
* Happy Lunar Landing Day!
-----------------------------------------------------
Change log for July 5, 2021 Vulkan 1.2.184 spec update:
* Update release number to 184 for this update.
Github Issues:
* Make description of
slink:VkSparseImageMemoryRequirements::pname:formatProperties.imageGranularity
consistent by replacing the nested structure descriptions with a simple
description of pname:formatProperties (public issue 1444).
* Update `<<VK_HUAWEI_subpass_shading>>` extension to rename
flink:vkGetSubpassShadingMaxWorkgroupSizeHUAWEI to
flink:vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI and give it a
dispatchable slink:VkDevice parameter (public issue 1564).
* Fix labelling of "`Resource`" reference block in pipeline block
diagrams (public issue 1582).
Internal Issues:
* Replace the old <<resources-image-views-compatibility>> table with a
simplified image type / image view type compatibility table, and move
the parameter compatibility portions of the table into explicit valid
usage statements (internal issue 2586).
* Define the slink:VkPipelinCacheHeaderVersionOne structure in `vk.xml`
instead of the previous "`Layout for pipeline cache header version one`"
table (internal merge request 4011).
* Make the `requires` attribute of the `spirvcapability` XML tag required
when specifying a structure, even if what's required is
`"VK_VERSION_1_0"`, to address a problem in the generated table from
these tags (internal merge request 4689).
New Extensions:
* `<<VK_NV_extermal_memory_rdma>>`
-----------------------------------------------------
Change log for June 28, 2021 Vulkan 1.2.183 spec update:
* Update release number to 183 for this update.
Github Issues:
* Rewrite and simplify the <<interfaces-iointerfaces-matching, Interface
Matching>> section. Clarify that results are undefined if the size of a
vector mismatches (public issue 666; internal issues 1269, 2059, 2323).
* Remove inappropriate `const` from `void *pNext` members of
`returnedonly` structures in `vk.xml` (public issue 1482, internal issue
2644).
* Add a NOTE to the <<interfaces, Shader Interfaces>> chapter that SPIR-V
execution model keywords with extension suffixes will always be present
in spec builds, even in a build not supporting any extensions, since
these keywords appear in the unified SPIR-V specification without such
qualifiers (public issue 1483, internal issue 2621).
* Modify `vk.xml` to include the Vulkan platform header via the path
`vulkan/vk_platform.h` rather than just `vk_platform.h`
(public pull request 1538).
* Add length annotations for slink:VkCuLaunchInfoNVX (public issue 1548).
* Describe slink:VkSubpassDescription::pname:pDepthStencilAttachment
correctly as a pointer to a structure, not a pointer to an array of
structures (public issue 1561).
* Fix `structextends` attribute of
slink:VkPhysicalDeviceRayTracingMotionBlurFeaturesNV, declare its
pname:pNext member correctly, and fix some typos in the related
extension language (public issue 1565, internal issue 2724).
Internal Issues:
* Add explicit valid usage statements for
flink:vkCmdClearColorImage::slink:VkClearColorValue and
slink:VkRenderPassBeginInfo::slink:VkClearValue (internal issue 2490).
* Change the term "`vertex processing {shader} stage`" to
"`pre-rasterization shader stage`" throughout the specification, link to
a single definition, and add "`pre-rasterization`" to the glossary
(internal issue 2634).
* Add an `<implicitexternsync>` constraint for
flink:vkResetCommandBuffers::pname:pool (internal issue 2646).
* Fix typo `vkCmdResetEvent` -> `vkResetEvent` in flink:vkResetEvent valid
usage statements (internal issue 2651).
* Fix wording of scope dependencies for slink:VkMemoryBarrier2KHR,
slink:VkBufferMemoryBarrier2KHR, and slink:VkImageMemoryBarrier2KHR
members pname:srcAccessMask and pname:dstAccessMask (internal issue
2654).
* Require support for pname:shaderInt64 in the <<features-requirements,
Feature Requirements>> section when pname:atomicInt64 features are
supported (internal issue 2660).
* Clarify ray tracing valid usage statements for cases where a parameter
refers to an acceleration structure that must have been built (internal
issue 2715).
* Add a NOTE clarifying shader record buffer uniformity in the
<<shader-binding-table, Shader Binding Table>> section (internal issue
2719).
* Minor clarifications and typo fixes to `<<VK_HUAWEI_subpass_shading>>`
(internal issue 2722).
* Add missing <spirvextension> entry in `vk.xml` to enable
`SPV_KHR_subgroup_uniform_control_flow`
(internal issue 2733).
* Move SPIR-V valid usage statement from the
<<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
section to <<spirvenv-module-validation-standalone]] Standalone SPIR-V
Validation>> (internal merge request 4637).
* Add a new <<spirvenv-image-signedness, Signedness of SPIR-V Image
Accesses>> section to allow the use of unsigned Sampled Types with
code:SignExtend and signed code:Format decorations (internal merge
request 4638).
* Add missing slink:VkDeviceCreateInfo to `structextends` attribute of
slink:VkPhysicalDeviceGlobalPriorityQueryFeaturesEXT (internal merge
request 4652).
* Remove nonexistent pname:minFragmentSize from the <<limits-minmax, Limit
Requirements>> table (internal merge request 4655).
* Fix markup typo for `<<VK_NV_fragment_shader_barycentric>>` ifdef
(internal merge request 4663).
-----------------------------------------------------
Change log for June 21, 2021 Vulkan 1.2.182 spec update:
* Update release number to 182 for this update.
Github Issues:
* Add XML attributes & schema updates to link untyped Vulkan object handle
values to corresponding object types (public issue 1536).
Internal Issues:
* Automatically generate links to extension proposal documents from
extension appendices (internal issue 2713).
* Clean up wording of flink:vkCmdWriteTimestamp and
flink:vkCmdWriteTimestamp2KHR (internal issue 2425).
* Fix hpp-compile CI stage after recent changes to Vulkan-Headers
repository which generate additional header files.
New Extensions:
* `<<VK_EXT_acquire_drm_display>>` (public pull request 1529).
* `<<VK_EXT_multi_draw>>`
* `<<VK_EXT_physical_device_drm>>` (public pull request 1356).
* `<<VK_HUAWEI_subpass_shading>>`