From 623725ef2e2ad132c820367b992ef9626c32f765 Mon Sep 17 00:00:00 2001
From: Sascha Willems <webmaster@saschawillems.de>
Date: Sun, 22 Mar 2026 07:41:53 +0100
Subject: [PATCH 1/3] Add chapter on Slang shading language

Refs #172
---
 README.adoc                                   |   4 +-
 antora/modules/ROOT/nav.adoc                  |   1 +
 ...slang-write-once-run-anywhere-graphic.webp | Bin 0 -> 24208 bytes
 chapters/slang.adoc                           | 235 ++++++++++++++++++
 4 files changed, 239 insertions(+), 1 deletion(-)
 create mode 100644 chapters/images/slang-write-once-run-anywhere-graphic.webp
 create mode 100644 chapters/slang.adoc

diff --git a/README.adoc b/README.adoc
index 72d6f4d..8f26213 100644
--- a/README.adoc
+++ b/README.adoc
@@ -1,4 +1,4 @@
-// Copyright 2019-2024 The Khronos Group, Inc.
+// Copyright 2019-2026 The Khronos Group, Inc.
 // SPDX-License-Identifier: CC-BY-4.0
 
 = Vulkan^®^ Guide
@@ -172,6 +172,8 @@ The Vulkan Guide content is also viewable from https://docs.vulkan.org/guide/lat
 
 == xref:{chapters}hlsl.adoc[Using HLSL shaders]
 
+== xref:{chapters}slang.adoc[Using Slang shaders]
+
 == xref:{chapters}high_level_shader_language_comparison.adoc[High Level Shader Language Comparison]
 
 = When and Why to use Extensions
diff --git a/antora/modules/ROOT/nav.adoc b/antora/modules/ROOT/nav.adoc
index 6fd940a..0848207 100644
--- a/antora/modules/ROOT/nav.adoc
+++ b/antora/modules/ROOT/nav.adoc
@@ -66,6 +66,7 @@
 ** xref:{chapters}image_copies.adoc[]
 ** xref:{chapters}common_pitfalls.adoc[]
 ** xref:{chapters}hlsl.adoc[]
+** xref:{chapters}slang.adoc[]
 ** xref:{chapters}high_level_shader_language_comparison.adoc[]
 * When and Why to use Extensions
 ** xref:{chapters}extensions/cleanup.adoc[]
diff --git a/chapters/images/slang-write-once-run-anywhere-graphic.webp b/chapters/images/slang-write-once-run-anywhere-graphic.webp
new file mode 100644
index 0000000000000000000000000000000000000000..7df32b2b294cc078f0eeff837b38615cb8c6dad5
GIT binary patch
literal 24208
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
BwkQAq

literal 0
HcmV?d00001

diff --git a/chapters/slang.adoc b/chapters/slang.adoc
new file mode 100644
index 0000000..63f57ba
--- /dev/null
+++ b/chapters/slang.adoc
@@ -0,0 +1,235 @@
+// Copyright 2026 Sascha Willems
+// SPDX-License-Identifier: CC-BY-4.0
+
+ifndef::chapters[:chapters:]
+ifndef::images[:images: images/]
+
+= Slang Shading Language in Vulkan
+
+image::{images}slang-write-once-run-anywhere-graphic.webp[Slang overview]
+
+Vulkan does not directly consume shaders in a human-readable text format, but instead uses xref:{chapters}what_is_spirv.adoc[SPIR-V] as an intermediate representation. This opens the option to use shader languages other than e.g. GLSL, as long as they can target the Vulkan SPIR-V environment.
+
+One such language is the link:https://shader-slang.org[Slang Shading Language] developed by NVIDIA. It was designed to address the evolving needs of real-time graphics development, especially in regards to shader code bases getting larger and more complex. It supports multiple APIs, among them is first-class support for Vulkan's SPIR-V.
+
+Slang is developed in the link:https://github.com/shader-slang[Open Source] and is under the link:https://www.khronos.org/news/press/khronos-group-launches-slang-initiative-hosting-open-source-compiler-contributed-by-nvidia[goverance of Khronos], meaning it has broad industry support and is actively maintained.
+
+It's syntax is similar to xref:{chapters}HLSL.adoc[HLSL] with additions like modules to make the language easier to use and to better handle complex code bases. 
+
+== Educational resources
+
+If you are new to Slang, here are some educational points:
+
+* link:https://shader-slang.org/[Slang website]
+* link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/[Slang Users's Guide].
+* link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/a2-01-spirv-target-specific.html[SPIR-V specific functionalities]
+* link:https://shader-slang.org/docs/coming-from-hlsl/[Porting from HLSL]
+* link:https://shader-slang.org/docs/coming-from-glsl/[Porting from GLSL]
+* xref:samples::README.adoc[The Vulkan Samples support Slang shaders]
+
+== Key differences
+
+Some of the key differences for Vulkan developers compared to GLSL and HLSL:
+
+* C{pp} syntax based on HLSL
+	* Modules
+	* Interfaces and generics
+	* Namespaces
+	* Pointers
+* Multiple shader stages in a single file
+* Automatic generation of binding points
+
+== From the application's point-of-view
+
+From the application's point-of-view, using Slang is exactly the same as using GLSL. As the application always consumes shaders in the SPIR-V format, the only difference is in the tooling to generate the SPIR-V shaders from the desired shading language.
+
+== Syntax comparison
+
+Slang and GLSL differ heavily in their syntax. While GLSL is more procedural (like C), Slang is more object-oriented (like C{pp}).
+
+Here is the same shader written in both languages to give quick comparison on how they basically differ, including the aforementioned namespace that e.g. adds explicit locations:
+
+=== GLSL
+
+In GLSL, you need one shader per stage.
+
+==== Vertex shader
+
+link:https://godbolt.org/z/6fefo9cWT[Try Online]
+[source,glsl]
+----
+#version 450
+
+layout (location = 0) in vec3 inPos;
+layout (location = 1) in vec2 inUV;
+
+layout (binding = 0) uniform UBO 
+{
+	mat4 projection;
+	mat4 model;
+} ubo;
+
+layout (location = 0) out vec2 outUV;
+
+void main() 
+{
+	outUV = inUV;
+	gl_Position = ubo.projection * ubo.model * vec4(inPos.xyz, 1.0);
+}
+----
+
+==== Fragment shader
+
+link:https://godbolt.org/z/4ecx89TWE[Try Online]
+[source,glsl]
+----
+#version 450
+
+layout (binding = 1) uniform sampler2D samplerColor;
+
+layout (location = 0) in vec2 inUV;
+
+layout (location = 0) out vec4 outFragColor;
+
+void main() 
+{
+	outFragColor = texture(samplerColor, inUV);
+}
+----
+
+=== Slang
+
+In Slang, a single file can contain multiple shader stages. This helps reduce duplication. Also note how we don't have to specify explicit bindings, as they're implicitly deduced for `ubo` and `samplerColor` from their ordering.
+
+link:https://godbolt.org/z/rEYeG6EdY[Try Online]
+[source,slang]
+----
+struct VSInput
+{
+	float3 Pos;
+	float2 UV;
+	float3 Normal;
+};
+
+struct VSOutput
+{
+	float4 Pos : SV_POSITION;
+	float2 UV;
+};
+
+struct UBO
+{
+    float4x4 projection;
+    float4x4 model;
+};
+ConstantBuffer<UBO> ubo;
+
+Sampler2D samplerColor;
+
+[shader("vertex")]
+VSOutput vertexMain(VSInput input)
+{
+	VSOutput output;
+	output.UV = input.UV;
+	output.Pos = mul(ubo.projection, mul(ubo.model, float4(input.Pos.xyz, 1.0)));
+	return output;
+}
+
+[shader("fragment")]
+float4 fragmentMain(VSOutput input)
+{
+    return samplerColor.Sample(input.UV);
+}
+----
+
+== Compiling shaders
+
+To get SPIR-V from Slang requires a compiler. Just like GLSL and HLSL, Slang comes with both an offline compiler (a binary for multiple operating systems) and a library for runtime compilation. Both can be downloaded via link:https://github.com/shader-slang/slang/releases[github] and are also part of the link:https://vulkan.lunarg.com/sdk/home[Vulkan SDK].
+
+=== Offline compilation using the stand-alone compiler
+
+Compiling a shader offline via the pre-compiled `slangc` binary is similar to compiling with glslang:
+
+[source]
+----
+slangc texture.slang -target spirv -o texture.vert.spv
+----
+
+This will generate a single SPIR-V file with all shader stages provided in the Slang source file.
+
+Specific shader stages can be compiled like this:
+
+[source]
+----
+slangc texture.slang -target spirv -entry vertexMain -stage vertex -o texture.vert.spv
+----
+
+Capabilities are implicitly enabled based on feature usage, but can also be explicitly specified:
+
+[source]
+----
+slangc heap.slang -target spirv -entry vertexMain -stage vertex -o heap.vert.spv -capability spvDescriptorHeapEXT
+----
+
+The resulting SPIR-V can then be directly loaded by the app, same as SPIR-V generated from GLSL.
+
+=== Runtime compilation using the library
+
+Slang can also be integrated into a Vulkan application using the Slang Compiler API. This allows for runtime compilation of shaders. Doing so requires you to include the slang compiler headers and link against the `slang` (or `slang-compiler`) library.
+
+Compiling Slang to SPIR-V at runtime then is pretty straight-forward:
+
+[source, cpp]
+----
+#include "slang/slang.h"
+#include "slang/slang-com-ptr.h"
+
+...
+
+// Initialize the Slang shader compiler
+slang::createGlobalSession(slangGlobalSession.writeRef());
+auto slangTargets{ std::to_array<slang::TargetDesc>({ {.format{SLANG_SPIRV}, .profile{slangGlobalSession->findProfile("spirv")} } }) };
+auto slangOptions{ std::to_array<slang::CompilerOptionEntry>({ { slang::CompilerOptionName::EmitSpirvDirectly, {slang::CompilerOptionValueKind::Int, 1} } }) };
+slang::SessionDesc slangSessionDesc{
+	.targets{slangTargets.data()},
+	.targetCount{SlangInt(slangTargets.size())},
+	// Match GLSL's matrix layout
+	.defaultMatrixLayoutMode = SLANG_MATRIX_LAYOUT_COLUMN_MAJOR,
+	.compilerOptionEntries{slangOptions.data()},
+	.compilerOptionEntryCount{uint32_t(slangOptions.size())} 
+};
+
+// Load and compile the shader
+Slang::ComPtr<slang::ISession> slangSession;
+slangGlobalSession->createSession(slangSessionDesc, slangSession.writeRef());
+Slang::ComPtr<slang::IModule> slangModule{ slangSession->loadModuleFromSource("shader", "shader.slang", nullptr, nullptr) };
+Slang::ComPtr<ISlangBlob> spirv;
+slangModule->getTargetCode(0, spirv.writeRef());
+VkShaderModuleCreateInfo shaderModuleCI{
+	.sType = VK_STRUCTURE_TYPE_SHADER_MODULE_CREATE_INFO,
+	.codeSize = spirv->getBufferSize(),
+	.pCode = (uint32_t*)spirv->getBufferPointer()
+};
+
+// Create the shader module to be used by the application
+VkShaderModule shaderModule{};
+chk(vkCreateShaderModule(device, &shaderModuleCI, nullptr, &shaderModule));
+
+// Take shader stages from the single module we just compiled
+VkPipelineShaderStageCreateInfo vertexShader{
+	.sType = VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO,
+	.stage = VK_SHADER_STAGE_VERTEX_BIT,
+	.module = shaderModule, .pName = "main"
+};
+VkPipelineShaderStageCreateInfo fragmentShader{
+	.sType = VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO,
+	.stage = VK_SHADER_STAGE_FRAGMENT_BIT,
+	.module = shaderModule, .pName = "main"
+};
+VkGraphicsPipelineCreateInfo pipelineCI{
+	...
+	.stageCount = 2,
+	.pStages = shaderStages.data(),
+};
+chk(vkCreateGraphicsPipelines(device, VK_NULL_HANDLE, 1, &pipelineCI, nullptr, &pipeline));
+----
\ No newline at end of file

From bbd8952631de53b46b9de7bec9327b1a1d04598b Mon Sep 17 00:00:00 2001
From: Sascha Willems <webmaster@saschawillems.de>
Date: Sun, 22 Mar 2026 07:53:07 +0100
Subject: [PATCH 2/3] Minor fixes, also copy .wepb files

Refs #172
---
 antora/Makefile     |  3 ++-
 chapters/slang.adoc | 12 ++++++------
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/antora/Makefile b/antora/Makefile
index 85b9640..5e56db4 100644
--- a/antora/Makefile
+++ b/antora/Makefile
@@ -1,4 +1,4 @@
-# Copyright 2022-2023 The Khronos Group Inc.
+# Copyright 2022-2026 The Khronos Group Inc.
 # SPDX-License-Identifier: Apache-2.0
 
 # Configure Vulkan Guide Antora tree with transformed markup files.
@@ -24,6 +24,7 @@ setup_spec:
 	mkdir -p $(ROOT)/images
 	$(CP) $(wildcard chapters/images/[A-Za-z]*.png) $(ROOT)/images/
 	$(CP) $(wildcard chapters/images/[A-Za-z]*.svg) $(ROOT)/images/
+	$(CP) $(wildcard chapters/images/[A-Za-z]*.webp) $(ROOT)/images/
 	$(CP) $(wildcard images/[A-Za-z]*.png) $(ROOT)/images/
 	mkdir -p $(ROOT)/images/extensions
 	$(CP) $(wildcard chapters/images/extensions/[A-Za-z]*.png) $(ROOT)/images/extensions
diff --git a/chapters/slang.adoc b/chapters/slang.adoc
index 63f57ba..7089c76 100644
--- a/chapters/slang.adoc
+++ b/chapters/slang.adoc
@@ -6,30 +6,30 @@ ifndef::images[:images: images/]
 
 = Slang Shading Language in Vulkan
 
-image::{images}slang-write-once-run-anywhere-graphic.webp[Slang overview]
-
 Vulkan does not directly consume shaders in a human-readable text format, but instead uses xref:{chapters}what_is_spirv.adoc[SPIR-V] as an intermediate representation. This opens the option to use shader languages other than e.g. GLSL, as long as they can target the Vulkan SPIR-V environment.
 
 One such language is the link:https://shader-slang.org[Slang Shading Language] developed by NVIDIA. It was designed to address the evolving needs of real-time graphics development, especially in regards to shader code bases getting larger and more complex. It supports multiple APIs, among them is first-class support for Vulkan's SPIR-V.
 
+image::{images}slang-write-once-run-anywhere-graphic.webp[Slang overview]
+
 Slang is developed in the link:https://github.com/shader-slang[Open Source] and is under the link:https://www.khronos.org/news/press/khronos-group-launches-slang-initiative-hosting-open-source-compiler-contributed-by-nvidia[goverance of Khronos], meaning it has broad industry support and is actively maintained.
 
-It's syntax is similar to xref:{chapters}HLSL.adoc[HLSL] with additions like modules to make the language easier to use and to better handle complex code bases. 
+It's syntax is similar to xref:{chapters}hlsl.adoc[HLSL] with additions like modules to make the language easier to use and to better handle complex code bases. 
 
 == Educational resources
 
 If you are new to Slang, here are some educational points:
 
 * link:https://shader-slang.org/[Slang website]
-* link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/[Slang Users's Guide].
+* link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/[Slang Users's Guide]
 * link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/a2-01-spirv-target-specific.html[SPIR-V specific functionalities]
 * link:https://shader-slang.org/docs/coming-from-hlsl/[Porting from HLSL]
 * link:https://shader-slang.org/docs/coming-from-glsl/[Porting from GLSL]
-* xref:samples::README.adoc[The Vulkan Samples support Slang shaders]
+* xref:samples::README.adoc[The Vulkan Samples come with Slang shaders]
 
 == Key differences
 
-Some of the key differences for Vulkan developers compared to GLSL and HLSL:
+Some of the key differences for Vulkan developers compared to GLSL and/or HLSL:
 
 * C{pp} syntax based on HLSL
 	* Modules

From 0f3375288362daeb63c90f88fb1cc0b38c1765f0 Mon Sep 17 00:00:00 2001
From: Sascha Willems <webmaster@saschawillems.de>
Date: Sun, 22 Mar 2026 08:02:45 +0100
Subject: [PATCH 3/3] Additional links, notes on tooling

Refs #172
---
 chapters/slang.adoc | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/chapters/slang.adoc b/chapters/slang.adoc
index 7089c76..1544ab5 100644
--- a/chapters/slang.adoc
+++ b/chapters/slang.adoc
@@ -14,17 +14,21 @@ image::{images}slang-write-once-run-anywhere-graphic.webp[Slang overview]
 
 Slang is developed in the link:https://github.com/shader-slang[Open Source] and is under the link:https://www.khronos.org/news/press/khronos-group-launches-slang-initiative-hosting-open-source-compiler-contributed-by-nvidia[goverance of Khronos], meaning it has broad industry support and is actively maintained.
 
-It's syntax is similar to xref:{chapters}hlsl.adoc[HLSL] with additions like modules to make the language easier to use and to better handle complex code bases. 
+It's syntax is similar to xref:{chapters}hlsl.adoc[HLSL] with additions like modules to make the language easier to use and to better handle complex code bases.
+
+It has great tooling-support with debuggers like link:https://renderdoc.org/[RenderDoc] and link:https://developer.nvidia.com/nsight-graphics[Night]. Syntax highlighting is available for most popular IDEs like link:https://marketplace.visualstudio.com/items?itemName=shader-slang.slang-vs-extension[Visual Studio] and link:https://marketplace.visualstudio.com/items?itemName=shader-slang.slang-language-extension[Visual Studio Code].
 
 == Educational resources
 
 If you are new to Slang, here are some educational points:
 
 * link:https://shader-slang.org/[Slang website]
+* link:https://shader-slang.org/docs/getting-started/[Getting started with Slang]
 * link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/[Slang Users's Guide]
 * link:https://docs.shader-slang.org/en/latest/external/slang/docs/user-guide/a2-01-spirv-target-specific.html[SPIR-V specific functionalities]
 * link:https://shader-slang.org/docs/coming-from-hlsl/[Porting from HLSL]
 * link:https://shader-slang.org/docs/coming-from-glsl/[Porting from GLSL]
+* link:https://shader-slang.org/slang-playground/[Interactive Slang shader playground]
 * xref:samples::README.adoc[The Vulkan Samples come with Slang shaders]
 
 == Key differences