The Vulkan Specification (referred usually as the Vulkan Spec) is the official description of how the Vulkan API works and is ultimately used to decide what is and is not valid Vulkan usage. At first glance, the Vulkan Spec seems like an incredibly huge and dry chunk of text, but it is usually the most useful item to have open when developing.
Reference the Vulkan Spec early and often.
The Vulkan Spec can be built for any version and with any permutation of extensions. The Khronos Group hosts the Vulkan Spec Registry which contains a few publicly available variations that most developers will find sufficient. Anyone can build their own variation of the Vulkan Spec from Vulkan-Docs.
When building the Vulkan Spec, you pass in what version of Vulkan to build for as well as what extensions to include. A Vulkan Spec without any extensions is also referred to as the core version as it is the minimal amount of Vulkan an implementation needs to support in order to be conformant.
The Vulkan Spec can be built into different formats.
Due to the size of the Vulkan Spec, a chunked version is the default when you visit the default index.html
page.
Example: https://www.khronos.org/registry/vulkan/specs/1.2/html/
Prebuilt HTML Chunked Vulkan Spec
- The Vulkan SDK comes packaged with the chunked version of the spec. Each Vulkan SDK version includes the corresponding spec version. See the Chunked Specification for the latest Vulkan SDK.
- Vulkan 1.0 Specification
- Vulkan 1.1 Specification
- Vulkan 1.2 Specification
If you want to view the Vulkan Spec in its entirety as HTML, you just need to view the vkspec.html
file.
Example: https://www.khronos.org/registry/vulkan/specs/1.2/html/vkspec.html
Prebuilt HTML Full Vulkan Spec
- The Vulkan SDK comes packaged with Vulkan Spec in its entirety as HTML for the version corresponding to the Vulkan SDK version. See the HTML version of the Specification for the latest Vulkan SDK. (Note: Slow to load. The advantage of the full HTML version is its searching capability).
- Vulkan 1.0 Specification
- Vulkan 1.1 Specification
- Vulkan 1.2 Specification
To view the PDF format, visit the pdf/vkspec.pdf
file.
Example: https://www.khronos.org/registry/vulkan/specs/1.2/pdf/vkspec.pdf
Prebuilt PDF Vulkan Spec
- Vulkan 1.0 Specification
- Vulkan 1.1 Specification
- Vulkan 1.2 Specification
The Khronos Group currently only host the Vulkan Man Pages for the latest version of the 1.2 spec, with all extensions, on the online registry.
The Vulkan Man Pages can also be found in the VulkanSDK for each SDK version. See the Man Pages for the latest Vulkan SDK.