diff --git a/README.adoc b/README.adoc index 72d6f4d..6e6f8b8 100644 --- a/README.adoc +++ b/README.adoc @@ -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/slang.adoc b/chapters/slang.adoc new file mode 100644 index 0000000..6f9b207 --- /dev/null +++ b/chapters/slang.adoc @@ -0,0 +1,41 @@ +// Copyright 2026 The Khronos Group, Inc. +// SPDX-License-Identifier: CC-BY-4.0 + +ifndef::chapters[:chapters:] +ifndef::images[:images: images/] + +[[slang-in-vulkan]] += Slang in Vulkan + +Slang is a _pleasing description TBD_ shading language that can be used with +Vulkan by compiling Slang shaders to SPIR-V. + +== _TBD_ + +_This page was generated by copying and simplifying the xref:hlsl.adoc[HLSL] +page. +All the Slang-specific details we care about need to be filled in._ + +[[slang-educational-resources]] +== Educational resources + +If you are new to Slang, a good starting point is... + +[[slang-applications-pov]] +== 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 SPIR-V shaders from the desired +shading language. + +[[slang-spirv-mapping-manual]] +== Slang to SPIR-V feature mapping manual + +A great starting point on using Slang in Vulkan via SPIR-V is _TBD_. + +== Other Sections _TBD_ + +_Add additional material similar to the HLSL page, e.g. Syntax comparison, +the Slang compiler, where to get Slang downloads and documentation..._