From 90a23347b40e92bd93590648ac8dfc9c6f165b45 Mon Sep 17 00:00:00 2001
From: Vaclav Elias <vaclavelias@gmail.com>
Date: Tue, 24 Oct 2023 19:18:38 +0100
Subject: [PATCH 1/6] Update 2023-10-23-new-diagnostic-analyzers-feature.md

---
 posts/2023-10-23-new-diagnostic-analyzers-feature.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/posts/2023-10-23-new-diagnostic-analyzers-feature.md b/posts/2023-10-23-new-diagnostic-analyzers-feature.md
index da6d86fd..dd378f0f 100644
--- a/posts/2023-10-23-new-diagnostic-analyzers-feature.md
+++ b/posts/2023-10-23-new-diagnostic-analyzers-feature.md
@@ -18,7 +18,7 @@ Stride continues to evolve, adding new utilities and features every week. This b
 
 ## What is a `DiagnosticAnalyzer`?
 
-A `DiagnosticAnalyzer` is a feature from Roslyn that scans your code while you are typing in your IDE. C# also utilizes this feature; every time you see a warning or red squiggly lines in your IDE, a `DiagnosticAnalyzer` gets triggered. Importantly, this analysis has nothing to do with telemetry.
+A `DiagnosticAnalyzer` is a feature from Roslyn that scans your code while you are typing in your IDE. C# also utilizes this feature; every time you see a warning or red squiggly lines in your IDE, a `DiagnosticAnalyzer` gets triggered. Analyzers are offline tools used by the compiler to assist programmers. They are not used to collect telemetry on how Stride is being used.
 
 ## What does it do?
 
@@ -42,4 +42,4 @@ Adding new analyzers to the Stride engine is straightforward. However, be aware
 
 This is a new quality-of-life feature that simplifies development in Stride by providing immediate feedback on coding issues.
 
-Thank you for reading 📖, and happy coding 💻👩‍💻👨‍💻!
\ No newline at end of file
+Thank you for reading 📖, and happy coding 💻👩‍💻👨‍💻!

From e027697603382e684bb58d1d3b0f1e28be631ceb Mon Sep 17 00:00:00 2001
From: Vaclav Elias <vaclavelias@gmail.com>
Date: Thu, 26 Oct 2023 23:41:58 +0100
Subject: [PATCH 2/6] feat: Diagnostic example section added with an image

---
 images/blog/2023-10/diagnostics-example.webp  | Bin 0 -> 21810 bytes
 ...-10-23-new-diagnostic-analyzers-feature.md |  30 ++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 images/blog/2023-10/diagnostics-example.webp

diff --git a/images/blog/2023-10/diagnostics-example.webp b/images/blog/2023-10/diagnostics-example.webp
new file mode 100644
index 0000000000000000000000000000000000000000..b487404f9d30948a9fd6949cac391030e2c18c87
GIT binary patch
literal 21810
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

literal 0
HcmV?d00001

diff --git a/posts/2023-10-23-new-diagnostic-analyzers-feature.md b/posts/2023-10-23-new-diagnostic-analyzers-feature.md
index dd378f0f..6a4506da 100644
--- a/posts/2023-10-23-new-diagnostic-analyzers-feature.md
+++ b/posts/2023-10-23-new-diagnostic-analyzers-feature.md
@@ -26,8 +26,38 @@ The new `Diagnostics` primarily focus on [Serialization](https://doc.stride3d.ne
 
 Each error code follows this format: `STRDIAGXXX`, where 'X' represents a numerical digit. Clicking on these error codes will open a help page that explains in depth why the `DiagnosticAnalyzer` was triggered and how to resolve the warning. You can find these error code pages [here](https://doc.stride3d.net/latest/en/diagnostics/).
 
+## Example
+
+In this example, we'll delve into a common scenario where the `DiagnosticAnalyzer` spots issues related to Stride's serialization rules. We have a `Dictionary` property named `Name` within a class `Example`. We've also adorned the `Name` property with `[DataMember]` and `[DataMemberIgnore]` attributes which are contradictory, and this is where the `DiagnosticAnalyzer` steps in to provide valuable feedback.
+
+
+```csharp
+public class Example
+{
+    [DataMember]
+    [DataMemberIgnore]
+    public Dictionary<Example, int> Name { private get; set; }
+}
+```
+
+Upon compiling, the `DiagnosticAnalyzer` flags three diagnostic warnings related to the attributes and the property's accessibility:
+
+```yml
+STRDIAG000: There is an Attribute Contradiction on 'Name' Member. [DataMemberIgnore] Attribute on a [DataMember] is not supported. Except if it has also [DataMemberUpdatable] Attribute.
+STRDIAG009: The member 'Name' implements IDictionary<T,K> with an unsupported type for the key. Only primitive types ( like int,float,.. ) are supported or string or enums as the Dictionary Key in asset serialization. When used in other contexts the warning may not apply and can be suppressed.
+STRDIAG004: The property 'Name' with [DataMember] does not have an accessible getter which is required for serialization. A public/internal/internal protected getter is expected.
+```
+
+The following image demonstrates how these warnings are displayed in Visual Studio:
+
+{% img-click 'Diagnostics warning in Visual Studio' '/images/blog/2023-10/diagnostics-example.webp' %}
+
+These warnings provide immediate feedback, aiding the developer in adhering to Stride's serialization rules. The `DiagnosticAnalyzer` not only pinpoints the issues but also suggests the necessary adjustments to align the code with Stride's standards. For instance, it suggests the removal of the `[DataMemberIgnore]` attribute or the addition of a `[DataMemberUpdatable]` attribute to resolve the attribute contradiction on the `Name` member. It also highlights the requirement for an accessible getter for serialization, and informs about the supported types for the `Dictionary` key in asset serialization.
+
 ## Why use it?
 
+This real-time feedback is invaluable, making the coding process smoother and less error-prone, and ensuring that the codebase remains compliant with Stride's serialization standards.
+
 This feature aims to minimize those "Why is my property not showing up in the [Game Studio](https://doc.stride3d.net/latest/en/manual/game-studio/index.html)?" moments. It's often unclear why certain properties don't appear in the editor. These analyzers are designed to clarify such situations, aiding your development process in Stride.
 
 ## Current State

From 6128dc217aac611d264543ec04eaf3829aaf8365 Mon Sep 17 00:00:00 2001
From: Vaclav Elias <vaclavelias@gmail.com>
Date: Fri, 27 Oct 2023 10:02:24 +0100
Subject: [PATCH 3/6] Update site.json - Website version bumped

---
 _data/site.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_data/site.json b/_data/site.json
index 73a2dbde..c31a385a 100644
--- a/_data/site.json
+++ b/_data/site.json
@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0.21",
+  "version": "2.0.0.22",
   "engine": "Eleventy 2.0",
   "title": "Stride Game Engine",
   "description": "C# Stride Game Engine is a powerful and versatile game development engine that is based on the C# programming language",

From 94ea13acc71e96ed4942b3a256ecb85a952742e4 Mon Sep 17 00:00:00 2001
From: = <=>
Date: Fri, 10 Nov 2023 23:32:26 +0100
Subject: [PATCH 4/6] Blog post for Spirv

---
 images/Spir.png                               | Bin 0 -> 16828 bytes
 ...vestigating-spirv-for-the-shader-system.md |  86 ++++++++++++++++++
 2 files changed, 86 insertions(+)
 create mode 100644 images/Spir.png
 create mode 100644 posts/investigating-spirv-for-the-shader-system.md

diff --git a/images/Spir.png b/images/Spir.png
new file mode 100644
index 0000000000000000000000000000000000000000..f49cfd1e1814d07900c309497289a216493ecf33
GIT binary patch
literal 16828
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

literal 0
HcmV?d00001

diff --git a/posts/investigating-spirv-for-the-shader-system.md b/posts/investigating-spirv-for-the-shader-system.md
new file mode 100644
index 00000000..385925fb
--- /dev/null
+++ b/posts/investigating-spirv-for-the-shader-system.md
@@ -0,0 +1,86 @@
+---
+title: "Investigating spir-v for the shader system"
+author: youness
+popular: false
+image: /images/spir.png
+tags: ['.NET', 'spir-v', 'shader', 'hlsl', 'glsl', 'sdsl', 'compilation']
+---
+
+Let's investigate how the shader system works in Stride and how to make it better thanks to spir-v.
+---
+
+Table of Contents:
+
+[[TOC]]
+
+The Stride engine has a powerful shader system, helping users build very complex shaders thanks to its language features like composition and inheritance, and its C# integration through the very powerful material system.
+
+## What are shaders ?
+
+Simply put, they are typically snippets of codes that are run on the GPU, moslty written in C-like languages like GLSL and HLSL.
+
+When a game has to render on the screen, it starts by preparing the data on the GPU and then sends shaders with commands. The GPU then executes those commands and if everything goes well, the game ends with a lovely screen !
+
+## How does it work in Stride ?
+
+To first understand how it works in Stride we have to know the many barriers we're facing.
+
+Stride is meant to run on a wide range of devices, from computers to mobiles. For that we have to make sure our shaders can run on many kind of GPUs through different drivers.
+
+There are 3 most used shader languages and they are, for some, tide to different kind of machines.
+
+* For Windows machines, HLSL and GLSL are the most used languages through Vulkan, OpenGL and Direct3D drivers. Where HLSL with Direct3D is only available on Windows.
+* For Linux and Android machines, Vulkan and OpenGL are the most used options.
+* For Mac and iOS machines, MSL is used with Metal.
+
+Since there is no one-size-fits-all solution, every game engine has to come up with a more complex solution that makes sure we have one shader language for every machines. A language that will either be transpiled or cross-compiled into another one.
+
+This is where SDSL was born.
+
+## SDSL and transpilation
+
+For the sake of this article we won't dive into the language, but you can learn a lot more about SDSL [through the manual](https://doc.stride3d.net/latest/en/manual/graphics/effects-and-shaders/index.html).
+From here, the article will assume you have a high level view about how programming languages are compiled and knowledge about shader programming.
+
+SDSL (StriDe Shader Language), was born for the need to transpile HLSL code to GLSL. It is heavily inspired from HLSL but with more features to simplify the process of creating complex shader computations.
+
+The shader system has 3 sides to it, an effect system, a shader mixer and the transpilation.
+
+The effect system will use the many different SDSL features to create uber-shaders/permutations for creating complex pipeline rendering.
+
+Since HLSL and GLSL are very close to each other, all this mixing is done through the abstract syntax tree level(AST). There are very few modification on the code itself, most of the work is done for managing input/output of shaders.
+
+The SDSL AST will then be transformed into HLSL or GLSL depending the graphics driver used.
+
+
+## Why investigating spir-v?
+
+Unfortunately for us, this complex transpilation involves issues regarding performance. Working with tree structures, especially with string data, makes computations very slow can introduce issues like defensive copies.
+
+We would need tools to help us transpile this SDSL into other languages without going through tree structures, but maybe through arrays.
+
+Three things happened lately, Vulkan was released with a new kind of bytecode shader language called spir-v and .NET core came out with a new feature for operating on arrays without loss of performance, namely `Span<T>`. And most importantly, spirv-cross was created as a mean to perform cross-compilation of shaders in a performant way. 
+
+It was clear for everyone, we had to investigate how we could compile SDSL to spir-v and use tools like spirv-cross.
+
+## Problems ahead
+
+SDSL is a very peculiar shader language, using current spir-v tools to generate spir-v byte code would be extremely difficult to design given how spir-v has a very tight specification.
+Another problem is that most spir-v tools are written in system languages like Rust/C/C++, which is another barrier for a .NET based game engine.
+
+To be able to use spir-v to it's fullest we have to create a C#/.NET library from scratch, something that will help us assemble and manipulate spir-v bytecode the way SDSL works.
+
+## Mise en bouche for Part 2 of this article
+
+I've started to work on this issue not long ago through two projects : 
+
+* [A new simplified parser for SDSL](https://github.com/ykafia/SDSLParser)
+* [A spir-v assembler library for SDSL](https://github.com/ykafia/SoftTouch.Spirv)
+
+Those will be the core subjects of part 2!
+
+## Summary
+
+Embracing spir-v for Stride's shader system will hopefully empower us with a better control over the shader language but also improve performance for shader compilation!
+
+Thank you for reading!

From 3c2f0de0bf261963d4fc59ed75d3a22505e4f3fd Mon Sep 17 00:00:00 2001
From: Youness KAFIA <32330908+ykafia@users.noreply.github.com>
Date: Mon, 13 Nov 2023 10:11:18 +0100
Subject: [PATCH 5/6] Better structure for spirv blog

---
 images/blog/spirv/shaders-explanation.png     | Bin 0 -> 15141 bytes
 ...vestigating-spirv-for-the-shader-system.md |  86 +++++++++++-------
 2 files changed, 53 insertions(+), 33 deletions(-)
 create mode 100644 images/blog/spirv/shaders-explanation.png

diff --git a/images/blog/spirv/shaders-explanation.png b/images/blog/spirv/shaders-explanation.png
new file mode 100644
index 0000000000000000000000000000000000000000..6148eeee84d8196843ced57e18b69987d44268df
GIT binary patch
literal 15141
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
RKYzthSJru0qG<W%e*skL4%Gkv

literal 0
HcmV?d00001

diff --git a/posts/investigating-spirv-for-the-shader-system.md b/posts/investigating-spirv-for-the-shader-system.md
index 385925fb..4f332006 100644
--- a/posts/investigating-spirv-for-the-shader-system.md
+++ b/posts/investigating-spirv-for-the-shader-system.md
@@ -1,5 +1,5 @@
 ---
-title: "Investigating spir-v for the shader system"
+title: "Investigating spir-v for the shader system - Part 1"
 author: youness
 popular: false
 image: /images/spir.png
@@ -7,6 +7,7 @@ tags: ['.NET', 'spir-v', 'shader', 'hlsl', 'glsl', 'sdsl', 'compilation']
 ---
 
 Let's investigate how the shader system works in Stride and how to make it better thanks to spir-v.
+
 ---
 
 Table of Contents:
@@ -19,65 +20,84 @@ The Stride engine has a powerful shader system, helping users build very complex
 
 Simply put, they are typically snippets of codes that are run on the GPU, moslty written in C-like languages like GLSL and HLSL.
 
-When a game has to render on the screen, it starts by preparing the data on the GPU and then sends shaders with commands. The GPU then executes those commands and if everything goes well, the game ends with a lovely screen !
+When a game has to render on the screen, it starts by preparing the data on the GPU and then sends shaders with commands. The GPU then executes those commands and if everything goes well, the game ends with a lovely picture drawn on the screen !
+This single call of a GPU is called a `draw call`.
 
-## How does it work in Stride ?
+![shader overview](/images/blog/spirv/shaders-explanation.png)
+
+It can be simplified to this view. There is a first stage called `Vertex stage` which is meant to compute vertices and make sure they are transformed into data that can be rasterized by your GPU, and a final stage called `Pixel stage` or `Fragment stage` that takes the rasterized output of the rasterizer and computes color for each pixel on the screen based on which triangles they belong to.
 
-To first understand how it works in Stride we have to know the many barriers we're facing.
+In both stages, you can provide textures/images and data through buffers, this can help give more details to your rendering, or help you compute more complicated things.
 
-Stride is meant to run on a wide range of devices, from computers to mobiles. For that we have to make sure our shaders can run on many kind of GPUs through different drivers.
+## Rendering in game engines
 
-There are 3 most used shader languages and they are, for some, tide to different kind of machines.
+Drawing a single mesh is simple, one buffer of vertices, maybe some textures, do a draw call and marvel at the screen. Repeat it many times and you get a video, very useful to make video games.
 
-* For Windows machines, HLSL and GLSL are the most used languages through Vulkan, OpenGL and Direct3D drivers. Where HLSL with Direct3D is only available on Windows.
-* For Linux and Android machines, Vulkan and OpenGL are the most used options.
-* For Mac and iOS machines, MSL is used with Metal.
+In game engines, objects being drawn the same ways are grouped into `materials`. A material can be seen as a recipe for drawing a mesh with ingredients like shader code, textures, vertices and other informations.
 
-Since there is no one-size-fits-all solution, every game engine has to come up with a more complex solution that makes sure we have one shader language for every machines. A language that will either be transpiled or cross-compiled into another one.
+Having many different materials implies creating many shader source code, and depending if you use [forward or deferred shading](https://learnopengl.com/Advanced-Lighting/Deferred-Shading), you might need reuse code from one file to another leading to some duplicate code.
 
-This is where SDSL was born.
+To solve this problem, all game engines have developped shader systems that help create permutation of shader code depending the material you're using. It helps re-use code you've already written, which speeds up development gives you the power to organize your code in more manageable ways!
 
-## SDSL and transpilation
+A good example of that are [shader graphs from Unity](https://unity.com/features/shader-graph) or [the material editor in Unreal](https://docs.unrealengine.com/5.0/en-US/unreal-engine-material-editor-ui/), whenever you add a block/function to the graph, it reuses shader code already written, to create a new permutation.
 
-For the sake of this article we won't dive into the language, but you can learn a lot more about SDSL [through the manual](https://doc.stride3d.net/latest/en/manual/graphics/effects-and-shaders/index.html).
-From here, the article will assume you have a high level view about how programming languages are compiled and knowledge about shader programming.
+## How does it work in Stride ?
 
-SDSL (StriDe Shader Language), was born for the need to transpile HLSL code to GLSL. It is heavily inspired from HLSL but with more features to simplify the process of creating complex shader computations.
+Stride has its own shader language called SDSL which stands for **S**tri**D**e **S**hader **L**anguage.
 
-The shader system has 3 sides to it, an effect system, a shader mixer and the transpilation.
+SDSL uses a very smart system of composition and inheritance, similar to object oriented programming. You can learn more about it [through the manual](https://doc.stride3d.net/latest/en/manual/graphics/effects-and-shaders/index.html).
 
-The effect system will use the many different SDSL features to create uber-shaders/permutations for creating complex pipeline rendering.
+### The barriers
 
-Since HLSL and GLSL are very close to each other, all this mixing is done through the abstract syntax tree level(AST). There are very few modification on the code itself, most of the work is done for managing input/output of shaders.
+To create permutations you need to be aware of the many limitations you will face while writing code for GPU.
 
-The SDSL AST will then be transformed into HLSL or GLSL depending the graphics driver used.
+#### GPUs are all different
 
+As obvious as it sounds, it needs to be reminded. Whenever you write code for your GPU you have to be aware that it will not work for all other GPUs.
 
-## Why investigating spir-v?
+10 years ago, two languages were the most used for writing shader code : HLSL and GLSL.
+In the case of OpenGL GPU vendors would provide you with their own compilers to work for their GPUs through different drivers. A valid code for one compiler would be a syntax error for another. It was a big mess!
 
-Unfortunately for us, this complex transpilation involves issues regarding performance. Working with tree structures, especially with string data, makes computations very slow can introduce issues like defensive copies.
+Stride was created during this period and it was designed to run on a wide variety of devices.
 
-We would need tools to help us transpile this SDSL into other languages without going through tree structures, but maybe through arrays.
+The solution chosen for creating code permutations that could work on many different machine was transpilation. Text would be parsed in abstract syntax trees and the text would be translated from one language to another by manipulating those trees. [To have a better idea of how abstract syntax tree work, this playlist will definitely help !](https://www.youtube.com/watch?v=cxNlb2GTKIc&list=PLTd6ceoshpreZuklA7RBMubSmhE0OHWh_&pp=iAQB)
 
-Three things happened lately, Vulkan was released with a new kind of bytecode shader language called spir-v and .NET core came out with a new feature for operating on arrays without loss of performance, namely `Span<T>`. And most importantly, spirv-cross was created as a mean to perform cross-compilation of shaders in a performant way. 
+#### Drivers are not all the same
 
-It was clear for everyone, we had to investigate how we could compile SDSL to spir-v and use tools like spirv-cross.
+Drivers can be seen as a front-end API to use the GPU. They have different paradigm and logic which may result in your shader code needing to be different across different drivers.
 
-## Problems ahead
+Here's a table of which language is supported by which machine depending on the driver used. I chose the most used machines for gaming.
 
-SDSL is a very peculiar shader language, using current spir-v tools to generate spir-v byte code would be extremely difficult to design given how spir-v has a very tight specification.
-Another problem is that most spir-v tools are written in system languages like Rust/C/C++, which is another barrier for a .NET based game engine.
+Note that some APIs are tied to the machine you're developing for, adding more complexity to the shader system, needing to handle GPUs that have very specific features.
+<br/>
 
-To be able to use spir-v to it's fullest we have to create a C#/.NET library from scratch, something that will help us assemble and manipulate spir-v bytecode the way SDSL works.
+|                 | Direct3D | Vulkan    | OpenGL | Metal | PSGL | NVN            |
+|-----------------|----------|-----------|--------|-------|------|----------------|
+| Windows         | HLSL     | HLSL/GLSL | GLSL   |       |      |                |
+| Linux           |          | HLSL/GLSL | GLSL   |       |      |                |
+| Mac/iOS         |          |           |        | MSL   |      |                |
+| Android         |          | HLSL/GLSL | GLSL   |       |      |                |
+| Playstation 4/5 |          |           |        |       | PSSL |                |
+| Nintendo Switch |          | HLSL/GLSL |        |       |      | NVN language ? |
+| XBOX Series X/S | HLSL     |           |        |       |      |                |
+<br/>
+<br/>
 
-## Mise en bouche for Part 2 of this article
+#### Performance Cost
 
-I've started to work on this issue not long ago through two projects : 
+Managed languages like C# are well known to be slower with string objects since they treat them as immutable. On top of that, tree structures, especially the one used for shader compilation in Stride, tend to perform very slowly and are prone to be slow and work against the GC.
+
+## Why investigating spir-v?
+
+Three things happened in the past 10 years, Vulkan was released with a new kind of bytecode shader language called spir-v, .NET core came out with a new high performance feature for operating on slices of array (something that C# is way better at than processing string objects), namely `Span<T>`, and most importantly, tools like [spirv-cross](https://github.com/KhronosGroup/SPIRV-Cross) and [naga](https://github.com/gfx-rs/wgpu/tree/trunk/naga) were created as a mean to translate shaders through spir-v.
+
+It was clear for everyone that we had to investigate how we could compile SDSL to spir-v and use all those very performant tools to transpile SDSL to other languages.
+
+## Problems ahead
 
-* [A new simplified parser for SDSL](https://github.com/ykafia/SDSLParser)
-* [A spir-v assembler library for SDSL](https://github.com/ykafia/SoftTouch.Spirv)
+SDSL is a very peculiar language and shifting from processing tree structures to processing segments of byte code is a great endeavor, especially for an engine.
 
-Those will be the core subjects of part 2!
+The following parts of this series of blog posts will focus on how such system can be made thanks to many new C# and .NET features that came out since .NET Core.
 
 ## Summary
 

From 8a8608e10c3132fabc197be76828292c0b95de22 Mon Sep 17 00:00:00 2001
From: = <=>
Date: Mon, 13 Nov 2023 12:17:41 +0100
Subject: [PATCH 6/6] Structure + text

---
 .../shaders-explanation.png                   | Bin
 ...estigating-spirv-for-the-shader-system.md} |  61 ++++++++++--------
 2 files changed, 33 insertions(+), 28 deletions(-)
 rename images/blog/{spirv => 2023-11}/shaders-explanation.png (100%)
 rename posts/{investigating-spirv-for-the-shader-system.md => 2023-11-10-investigating-spirv-for-the-shader-system.md} (64%)

diff --git a/images/blog/spirv/shaders-explanation.png b/images/blog/2023-11/shaders-explanation.png
similarity index 100%
rename from images/blog/spirv/shaders-explanation.png
rename to images/blog/2023-11/shaders-explanation.png
diff --git a/posts/investigating-spirv-for-the-shader-system.md b/posts/2023-11-10-investigating-spirv-for-the-shader-system.md
similarity index 64%
rename from posts/investigating-spirv-for-the-shader-system.md
rename to posts/2023-11-10-investigating-spirv-for-the-shader-system.md
index 4f332006..4689e83b 100644
--- a/posts/investigating-spirv-for-the-shader-system.md
+++ b/posts/2023-11-10-investigating-spirv-for-the-shader-system.md
@@ -1,12 +1,12 @@
 ---
-title: "Investigating spir-v for the shader system - Part 1"
+title: "Investigating spirv for the shader system - Part 1"
 author: youness
 popular: false
 image: /images/spir.png
-tags: ['.NET', 'spir-v', 'shader', 'hlsl', 'glsl', 'sdsl', 'compilation']
+tags: ['.NET', 'Shaders']
 ---
 
-Let's investigate how the shader system works in Stride and how to make it better thanks to spir-v.
+Let's investigate how the shader system works in Stride and how to make it better thanks to spirv.
 
 ---
 
@@ -23,7 +23,7 @@ Simply put, they are typically snippets of codes that are run on the GPU, moslty
 When a game has to render on the screen, it starts by preparing the data on the GPU and then sends shaders with commands. The GPU then executes those commands and if everything goes well, the game ends with a lovely picture drawn on the screen !
 This single call of a GPU is called a `draw call`.
 
-![shader overview](/images/blog/spirv/shaders-explanation.png)
+![shader overview](/images/blog/2023-11/shaders-explanation.png)
 
 It can be simplified to this view. There is a first stage called `Vertex stage` which is meant to compute vertices and make sure they are transformed into data that can be rasterized by your GPU, and a final stage called `Pixel stage` or `Fragment stage` that takes the rasterized output of the rasterizer and computes color for each pixel on the screen based on which triangles they belong to.
 
@@ -31,11 +31,11 @@ In both stages, you can provide textures/images and data through buffers, this c
 
 ## Rendering in game engines
 
-Drawing a single mesh is simple, one buffer of vertices, maybe some textures, do a draw call and marvel at the screen. Repeat it many times and you get a video, very useful to make video games.
+Drawing a single mesh is simple, one buffer of vertices, maybe some textures, do a draw call and ✨ marvel at the screen ✨. Repeat it many times and you get a video, very useful to make video games 👾.
 
 In game engines, objects being drawn the same ways are grouped into `materials`. A material can be seen as a recipe for drawing a mesh with ingredients like shader code, textures, vertices and other informations.
 
-Having many different materials implies creating many shader source code, and depending if you use [forward or deferred shading](https://learnopengl.com/Advanced-Lighting/Deferred-Shading), you might need reuse code from one file to another leading to some duplicate code.
+Having many different materials implies creating many shader source code, and depending if you use [forward or deferred shading](https://learnopengl.com/Advanced-Lighting/Deferred-Shading), you might need to reuse code from one file to another leading to lots of duplicate code 👩‍💻👨‍💻.
 
 To solve this problem, all game engines have developped shader systems that help create permutation of shader code depending the material you're using. It helps re-use code you've already written, which speeds up development gives you the power to organize your code in more manageable ways!
 
@@ -47,53 +47,58 @@ Stride has its own shader language called SDSL which stands for **S**tri**D**e *
 
 SDSL uses a very smart system of composition and inheritance, similar to object oriented programming. You can learn more about it [through the manual](https://doc.stride3d.net/latest/en/manual/graphics/effects-and-shaders/index.html).
 
-### The barriers
+## The many problems shader systems are facing
 
 To create permutations you need to be aware of the many limitations you will face while writing code for GPU.
 
-#### GPUs are all different
+
+### GPUs are all different
 
 As obvious as it sounds, it needs to be reminded. Whenever you write code for your GPU you have to be aware that it will not work for all other GPUs.
 
 10 years ago, two languages were the most used for writing shader code : HLSL and GLSL.
-In the case of OpenGL GPU vendors would provide you with their own compilers to work for their GPUs through different drivers. A valid code for one compiler would be a syntax error for another. It was a big mess!
+In the case of OpenGL, GPU vendors would provide you with their own GLSL compilers to work for their GPUs through different drivers. A valid code for one compiler would be a syntax error for another. It was a big mess 💩, but a manageable one!
 
-Stride was created during this period and it was designed to run on a wide variety of devices.
+Stride was created during this period and it was designed to run on a wide variety of devices 🎮 🕹️ 💻 🖥️.
 
-The solution chosen for creating code permutations that could work on many different machine was transpilation. Text would be parsed in abstract syntax trees and the text would be translated from one language to another by manipulating those trees. [To have a better idea of how abstract syntax tree work, this playlist will definitely help !](https://www.youtube.com/watch?v=cxNlb2GTKIc&list=PLTd6ceoshpreZuklA7RBMubSmhE0OHWh_&pp=iAQB)
+The solution chosen for creating code permutations that could work on many different machine was transpilation. Text would be parsed in abstract syntax trees and the text would be translated from one language to another by manipulating those trees. [To have a better idea of how abstract syntax tree work, this playlist of videos will definitely help !](https://www.youtube.com/watch?v=cxNlb2GTKIc&list=PLTd6ceoshpreZuklA7RBMubSmhE0OHWh_&pp=iAQB)
 
-#### Drivers are not all the same
+### Drivers are not all the same
 
 Drivers can be seen as a front-end API to use the GPU. They have different paradigm and logic which may result in your shader code needing to be different across different drivers.
 
 Here's a table of which language is supported by which machine depending on the driver used. I chose the most used machines for gaming.
 
-Note that some APIs are tied to the machine you're developing for, adding more complexity to the shader system, needing to handle GPUs that have very specific features.
+Note that some APIs are tied to the machine you're developing for, adding more complexity to the shader system, needing to handle GPUs that have very specific features. Vulkan and OpenGL can be used on Mac and iOS but OpenGL is deprecated and Vulkan run on MoltenVK, a Vulkan implementation on top of Metal.
 <br/>
 
-|                 | Direct3D | Vulkan    | OpenGL | Metal | PSGL | NVN            |
-|-----------------|----------|-----------|--------|-------|------|----------------|
-| Windows         | HLSL     | HLSL/GLSL | GLSL   |       |      |                |
-| Linux           |          | HLSL/GLSL | GLSL   |       |      |                |
-| Mac/iOS         |          |           |        | MSL   |      |                |
-| Android         |          | HLSL/GLSL | GLSL   |       |      |                |
-| Playstation 4/5 |          |           |        |       | PSSL |                |
-| Nintendo Switch |          | HLSL/GLSL |        |       |      | NVN language ? |
-| XBOX Series X/S | HLSL     |           |        |       |      |                |
+|                 |   Direct3D   | Vulkan    | OpenGL | Metal | PSGL | NVN |
+|-----------------|--------------|-----------|--------|-------|------|-----|
+| Windows/XBox    |     HLSL     | HLSL/GLSL | GLSL   |       |      |     |
+| Linux           |              | HLSL/GLSL | GLSL   |       |      |     |
+| Mac/iOS         |              | HLSL/GLSL | GLSL   |  MSL  |      |     |
+| Android         |              | HLSL/GLSL | GLSL   |       |      |     |
+| Playstation 4/5 |              |           |        |       | PSSL |     |
+| Nintendo Switch |              | HLSL/GLSL | GLSL   |       |      |  ?  |
+
 <br/>
 <br/>
 
-#### Performance Cost
+### Performance Cost
 
 Managed languages like C# are well known to be slower with string objects since they treat them as immutable. On top of that, tree structures, especially the one used for shader compilation in Stride, tend to perform very slowly and are prone to be slow and work against the GC.
 
-## Why investigating spir-v?
+## Why investigating spirv?
+
+Three things happened in the past 10 years :
+
+* Vulkan was released with a new kind of bytecode shader language called spirv
 
-Three things happened in the past 10 years, Vulkan was released with a new kind of bytecode shader language called spir-v, .NET core came out with a new high performance feature for operating on slices of array (something that C# is way better at than processing string objects), namely `Span<T>`, and most importantly, tools like [spirv-cross](https://github.com/KhronosGroup/SPIRV-Cross) and [naga](https://github.com/gfx-rs/wgpu/tree/trunk/naga) were created as a mean to translate shaders through spir-v.
+* .NET core came out with a new high performance feature for operating on slices of array (something that C# is way better at than processing string objects), namely `Span<T>`
 
-It was clear for everyone that we had to investigate how we could compile SDSL to spir-v and use all those very performant tools to transpile SDSL to other languages.
+* Most importantly, tools like [spirv-cross](https://github.com/KhronosGroup/SPIRV-Cross) and [naga](https://github.com/gfx-rs/wgpu/tree/trunk/naga) were created as a mean to translate shaders through spirv.
 
-## Problems ahead
+It was clear for everyone that we had to investigate how we could compile SDSL to spirv and use all those very performant tools to transpile SDSL to other languages.
 
 SDSL is a very peculiar language and shifting from processing tree structures to processing segments of byte code is a great endeavor, especially for an engine.
 
@@ -101,6 +106,6 @@ The following parts of this series of blog posts will focus on how such system c
 
 ## Summary
 
-Embracing spir-v for Stride's shader system will hopefully empower us with a better control over the shader language but also improve performance for shader compilation!
+Embracing spirv for Stride's shader system will hopefully empower us with a better control over the shader language but also improve performance for shader compilation!  💪💪
 
 Thank you for reading!