• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1// Copyright 2015-2021 The Khronos Group, Inc.
2//
3// SPDX-License-Identifier: CC-BY-4.0
4
5[appendix]
6
7[[extensions]]
8= Layers & Extensions (Informative)
9
10Extensions to the Vulkan API can: be defined by authors, groups of authors,
11and the Khronos Vulkan Working Group.
12In order not to compromise the readability of the Vulkan Specification, the
13core Specification does not incorporate most extensions.
14The online Registry of extensions is available at URL
15
16https://www.khronos.org/registry/vulkan/
17
18and allows generating versions of the Specification incorporating different
19extensions.
20
21Most of the content previously in this appendix does not specify *use* of
22specific Vulkan extensions and layers, but rather specifies the processes by
23which extensions and layers are created.
24As of version 1.0.21 of the Vulkan Specification, this content has been
25migrated to the <<vulkan-styleguide, Vulkan Documentation and Extensions>>
26document.
27Authors creating extensions and layers must: follow the mandatory procedures
28in that document.
29
30The remainder of this appendix documents a set of extensions chosen when
31this document was built.
32Versions of the Specification published in the Registry include:
33
34  * Core API + mandatory extensions required of all Vulkan implementations.
35  * Core API + all registered and published Khronos (`KHR`) extensions.
36  * Core API + all registered and published extensions.
37
38Extensions are grouped as Khronos `KHR`, multivendor `EXT`, and then
39alphabetically by author ID.
40Within each group, extensions are listed in alphabetical order by their
41name.
42
43[NOTE]
44.Note
45====
46As of the initial Vulkan 1.1 public release, the `KHX` author ID is no
47longer used.
48All `KHX` extensions have been promoted to `KHR` status.
49Previously, this author ID was used to indicate that an extension was
50experimental, and is being considered for standardization in future `KHR` or
51core Vulkan API versions.
52We no longer use this mechanism for exposing experimental functionality.
53
54Some vendors may use an alternate author ID ending in `X` for some of their
55extensions.
56The exact meaning of such an author ID is defined by each vendor, and may
57not be equivalent to `KHX`, but it is likely to indicate a lesser degree of
58interface stability than a non-`X` extension from the same vendor.
59====
60
61include::{generated}/meta/current_extensions_appendix.txt[]
62include::{generated}/meta/provisional_extensions_appendix.txt[]
63include::{generated}/meta/deprecated_extensions_appendix.txt[]
64