dotnet · Exanite · Jun 11, 2026 · Jun 12, 2026 · Jun 12, 2026 · Jun 12, 2026
@@ -1,11 +1,11 @@
 [submodule "submodules/terrafx.interop.windows"]
 	path = eng/submodules/terrafx.interop.windows
 	url = https://github.com/terrafx/terrafx.interop.windows
-[submodule "eng/submodules/opengl"]
-	path = eng/submodules/opengl
+[submodule "eng/submodules/opengl-registry"]
+	path = eng/submodules/opengl-registry
 	url = https://github.com/KhronosGroup/OpenGL-Registry.git
-[submodule "eng/submodules/egl"]
-	path = eng/submodules/egl
+[submodule "eng/submodules/egl-registry"]
+	path = eng/submodules/egl-registry
 	url = https://github.com/KhronosGroup/EGL-Registry/
 [submodule "eng/submodules/sdl"]
 	path = eng/submodules/sdl
@@ -16,9 +16,45 @@
 [submodule "eng/submodules/openal-soft"]
 	path = eng/submodules/openal-soft
 	url = https://github.com/kcat/openal-soft
-[submodule "eng/submodules/vulkan"]
-	path = eng/submodules/vulkan
+[submodule "eng/submodules/vulkan-docs"]
+	path = eng/submodules/vulkan-docs
 	url = https://github.com/KhronosGroup/Vulkan-Docs.git
 [submodule "eng/submodules/vulkan-headers"]
 	path = eng/submodules/vulkan-headers
 	url = https://github.com/KhronosGroup/Vulkan-Headers.git
+[submodule "eng/submodules/assimp"]
+	path = eng/submodules/assimp
+	url = https://github.com/assimp/assimp
+[submodule "eng/submodules/spirv-tools"]
+	path = eng/submodules/spirv-tools
+	url = https://github.com/KhronosGroup/SPIRV-Tools
+[submodule "eng/submodules/spirv-reflect"]
+	path = eng/submodules/spirv-reflect
+	url = https://github.com/KhronosGroup/SPIRV-Reflect.git
+[submodule "eng/submodules/spirv-headers"]
+	path = eng/submodules/spirv-headers
+	url = https://github.com/KhronosGroup/SPIRV-Headers
+[submodule "eng/submodules/spirv-cross"]
+	path = eng/submodules/spirv-cross
+	url = https://github.com/KhronosGroup/SPIRV-Cross
+[submodule "eng/submodules/shaderc"]
+	path = eng/submodules/shaderc
+	url = https://github.com/google/shaderc
+[submodule "eng/submodules/moltenvk"]
+	path = eng/submodules/moltenvk
+	url = https://github.com/KhronosGroup/MoltenVK
+[submodule "eng/submodules/vulkan-memory-allocator"]
+	path = eng/submodules/vulkan-memory-allocator
+	url = https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator.git
+[submodule "eng/submodules/glslang"]
+	path = eng/submodules/glslang
+	url = https://github.com/KhronosGroup/glslang.git
+[submodule "eng/submodules/openxr-sdk"]
+	path = eng/submodules/openxr-sdk
+	url = https://github.com/KhronosGroup/OpenXR-SDK.git
+[submodule "eng/submodules/opencl-docs"]
+	path = eng/submodules/opencl-docs
+	url = https://github.com/KhronosGroup/OpenCL-Docs.git
+[submodule "eng/submodules/opencl-headers"]
+	path = eng/submodules/opencl-headers
+	url = https://github.com/KhronosGroup/OpenCL-Headers.git
@@ -54,9 +54,15 @@
     <Project Path="sources/OpenAL/OpenAL/Silk.NET.OpenAL.csproj" />
     <Project Path="sources/OpenAL/Soft.Native/Silk.NET.OpenAL.Soft.Native.csproj" />
   </Folder>
+  <Folder Name="/sources/OpenCL/">
+    <Project Path="sources/OpenCL/OpenCL/Silk.NET.OpenCL.csproj" />
+  </Folder>
   <Folder Name="/sources/OpenGL/">
     <Project Path="sources/OpenGL/OpenGL/Silk.NET.OpenGL.csproj" />
   </Folder>
+  <Folder Name="/sources/OpenXR/">
+    <Project Path="sources/OpenXR/OpenXR/Silk.NET.OpenXR.csproj" />
+  </Folder>
   <Folder Name="/sources/SDL/">
     <Project Path="sources/SDL/Native/Silk.NET.SDL.Native.csproj" />
     <Project Path="sources/SDL/SDL/Silk.NET.SDL.csproj" />

@@ -12,6 +12,8 @@ Silk.NET 3.0 Preview 1
 
 - Added combined OpenGL bindings using the 3.0 bindings style.
 - Added OpenAL bindings using the 3.0 bindings style.
+- Added OpenCL bindings using the 3.0 bindings style.
+- Added OpenXR bindings using the 3.0 bindings style.
 - Added SDL3 bindings using the 3.0 bindings style.
 - Added Vulkan bindings using the 3.0 bindings style.
 - Improved the bindings style to be more accessible, IDE-friendly, and AOT-friendly. Learn more at **TODO ADD A LINK TO DOCUMENTATION HERE**.

@@ -1,23 +1,66 @@
 # API-Specific Notes
 
 This document's purpose is to note down any decisions or quirks that are specific to a library that Silk is generating
-bindings for.
+bindings for. It is fine for a section to be empty if we do not have any notes specific to that library.
 
 This is meant to be a living document. Please update this as new work is being done on the generator.
 
-## OpenAL
+Certain APIs are grouped together because they share similar characteristics.
 
-Currently empty.
+## C Bindings
+
+These are APIs that can be categorized as being straightforward C APIs or are C APIs that simply do not share
+characteristics with other bindings.
 
-## OpenGL
+### SDL
 
 Currently empty.
 
-## SDL
+## Khronos Bindings
 
-Currently empty.
+These are APIs managed either by Khronos or APIs managed in a similar way to the official Khronos APIs.
+These use the `MixKhronosData` mod and come with an XML spec.
+
+Be aware that the XML spec links point to the latest version. Silk's repo may be using an older version of these XML
+files.
+
+### OpenAL
+
+Spec file used: https://raw.githubusercontent.com/kcat/openal-soft/master/registry/xml/al.xml
+
+### OpenCL
+
+Spec file used: https://raw.githubusercontent.com/KhronosGroup/OpenCL-Docs/main/xml/cl.xml
+
+The following warning is expected since we do not want to hardcode the version in our entrypoint header:
+
+```
+warning: cl_version.h: CL_TARGET_OPENCL_VERSION is not defined. Defaulting to 310 (OpenCL 3.1) [-W#pragma-messages]
+```
+
+### OpenGL
+
+Spec file used: https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry/main/xml/gl.xml
+
+### OpenXR
+
+Spec file used: https://raw.githubusercontent.com/KhronosGroup/OpenXR-SDK/main/specification/registry/xr.xml
+
+There will be the following errors in the generation log. This is expected. These types are part of the XML
+specification, but not part of the main `openxr.h` header.
+
+API Constants shows up here, but not in Vulkan because OpenXR's XML lacks the `type="constants"` attribute that
+Vulkan's XML has.
+
+```
+fail: Silk.NET.SilkTouch.Mods.MixKhronosData[0] Enum "API Constants" has no base type. Please add TypeMap entry to the configuration. This enum group will be skipped.
+fail: Silk.NET.SilkTouch.Mods.MixKhronosData[0] Enum "XrAndroidThreadTypeKHR" has no base type. Please add TypeMap entry to the configuration. This enum group will be skipped.
+fail: Silk.NET.SilkTouch.Mods.MixKhronosData[0] Enum "XrLoaderInterfaceStructs" has no base type. Please add TypeMap entry to the configuration. This enum group will be skipped.
+```
+
+### Vulkan
 
-## Vulkan
+Spec file used: https://raw.githubusercontent.com/KhronosGroup/Vulkan-Docs/main/xml/vk.xml
 
 There will be the following errors in the generation log. This is expected. These types are part of the XML
 specification, but not part of the main `vulkan.h` header.

@@ -496,13 +496,13 @@ the mod.
 
 Khronos-style XML specifications:
 
-- OpenAL: https://raw.githubusercontent.com/kcat/openal-soft/refs/heads/master/registry/xml/al.xml
-- OpenCL: https://raw.githubusercontent.com/KhronosGroup/OpenCL-Docs/refs/heads/main/xml/cl.xml
-- OpenGL: https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry/refs/heads/main/xml/gl.xml
+- OpenAL: https://raw.githubusercontent.com/kcat/openal-soft/master/registry/xml/al.xml
+- OpenCL: https://raw.githubusercontent.com/KhronosGroup/OpenCL-Docs/main/xml/cl.xml
+- OpenGL: https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry/main/xml/gl.xml
 - OpenGL Windows: https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry/main/xml/wgl.xml
-- OpenGL X11: https://github.com/KhronosGroup/OpenGL-Registry/blob/main/xml/glx.xml
-- OpenXR: https://raw.githubusercontent.com/KhronosGroup/OpenXR-SDK-Source/main/specification/registry/xr.xml
-- Vulkan: https://raw.githubusercontent.com/KhronosGroup/Vulkan-Docs/refs/heads/main/xml/vk.xml
+- OpenGL X11: https://raw.githubusercontent.com/KhronosGroup/OpenGL-Registry/main/xml/glx.xml
+- OpenXR: https://raw.githubusercontent.com/KhronosGroup/OpenXR-SDK/main/specification/registry/xr.xml
+- Vulkan: https://raw.githubusercontent.com/KhronosGroup/Vulkan-Docs/main/xml/vk.xml
 
 Be aware that these link to the latest version. Silk's repo may be using an older version of these XML files.
 

@@ -15,12 +15,15 @@ Metal.
 
 ## Generator Overview
 
-There are two main things to configure:
+There are three main things to configure:
 
 1. Silk 3 - This is the [`generator.json`](https://github.com/dotnet/Silk.NET/blob/develop/3.0/generator.json) file.
 
 2. ClangSharpPInvokeGenerator - This is the [`eng/silktouch`](https://github.com/dotnet/Silk.NET/tree/develop/3.0/eng/silktouch) folder.
 
+3. C# Project File - This is your typical `.csproj` file and add it to your solution before running the SilkTouch
+   generator.
+
 Both are organized by native API.
 
 Note: For the average C API, SDL's generator configuration would be the best configuration to reference. Most options
@@ -63,7 +66,7 @@ Note that these files can be stored anywhere since the SilkTouch configuration l
 generator looks for these response files.
 
 > To read more about ClangSharpPInvokeGenerator's command line arguments, a good option is to install the tool directly
-> and use `--help` to display its command line documentation.
+> and use the `--help` option to display its command line documentation.
 >
 > ```sh
 > dotnet tool install --global ClangSharpPInvokeGenerator
@@ -211,14 +214,59 @@ static Vk()
 }
 ```
 
+### Initial Project Creation
+
+You must create the initial project for the generated bindings to go in. This also goes for the solution file.
+SilkTouch does not modify either file.
+
+The paths for these files correspond to the following options in the `generator.json` file:
+- `Jobs.JOB_NAME.SourceProject`
+- `Jobs.JOB_NAME.Solution`
+
+(TODO: Does this apply to `Jobs.JOB_NAME.TestProject` as well?)
+
+For the source project file, ensure that the project references the `Silk.NET.Core` project or package by using the
+corresponding `ProjectReference` or `PackageReference`. Also ensure the `AllowUnsafeBlocks` property is set to true.
+
+> Note: In Silk's repository, `AllowUnsafeBlocks` is set globally by
+> [Directory.Build.props](https://github.com/dotnet/Silk.NET/blob/develop/3.0/Directory.Build.props).
+>
+> (TODO: Not sure if other properties are required.)
+
+For the solution file, both `.sln` and `.slnx` file formats are supported. This is because we defer to Roslyn and
+MSBuild under the hood.
+
+### Running the Generator
+
+The generator can be run directly from source using the following command:
+
+```sh
+dotnet run --project sources/SilkTouch/SilkTouch/Silk.NET.SilkTouch.csproj -c Release -- generator.json --only SDL
+```
+
+You may use the `--help` option to display additional information about available options.
+
+```
+dotnet run --project sources/SilkTouch/SilkTouch/Silk.NET.SilkTouch.csproj -c Release -- --help
+```
+
+Some notable options include the `--only` and `--skip` options. `--only` lets you specify the exact jobs to run.
+`--skip` is the opposite and lets you specify the jobs to skip. If `--only` and `--skip` is specified for the same job,
+`--skip` takes precedence.
+
+Warning: There are currently some generator bugs associated with running multiple jobs in the same process. We recommend
+that you use `--only` to ensure that only one job is executed per process. Running multiple processes in parallel is
+fine.
+
 ### Generated Bindings Output
 
 All generated binding will be output to the `Jobs.JOB_NAME.SourceProject` path defined in `generator.json`.
 
-These generated files all have the `.gen.cs` suffix and most of them are partial type declarations.
-This means by creating a similarly named `.cs` file and using the `partial` C# keyword, you can add to the type.
+These generated files all have the `.gen.cs` suffix and most of them are partial type declarations. This means by
+creating a similarly named `.cs` file and using the `partial` C# keyword, you can add to the type.
 
-Do not modify the `.gen.cs` files since running the generator again will overwrite those changes.
+Do not modify the `.gen.cs` files since running the generator again will overwrite those changes. Files without this
+extension are left untouched by the generator.
 
 ### Packing the Generated Bindings
 

@@ -45,6 +45,16 @@ In order to use the experimental feed, you must change this project file slightl
   </PropertyGroup>
 ```
 
+Optionally, create a `nuget.config` file next to your solution file with the following contents:
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+    <packageSources>
+        <add key="silk" value="https://dotnet.github.io/Silk.NET/nuget/experimental/index.json"/>
+    </packageSources>
+</configuration>
+```
+
 ## Install an experimental version
 
 Now .NET has access to the experimental feed, it's time to install an experimental package. Check for the latest version on our [GitLab Package Registry](https://gitlab.com/silkdotnet/Silk.NET/-/packages).
@@ -57,7 +67,6 @@ At the time of writing, the latest version is `2.0.0-build97.0`. Now to install
   </ItemGroup>
 ```
 
-
 > [!WARNING]
 > Experimental Feed builds may be deleted without warning at the Silk.NET team's discretion.
 

@@ -0,0 +1,5 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+// Ported from the OpenCL headers and corresponding dependencies.
+// Original source is Copyright 2013-2026 The Khronos Group Inc. Licensed under the Apache 2.0 license.
@@ -0,0 +1,17 @@
+@../settings.rsp
+@../remap.rsp
+--additional
+-Wno-invalid-constexpr
+--file
+opencl-opencl.h
+--methodClassName
+Cl
+--namespace
+Silk.NET.OpenCL
+--output
+../../../../sources/OpenCL/OpenCL
+--test-output
+../../../../tests/OpenCL/OpenCL
+--traverse
+../../../submodules/opencl-headers/CL/cl.h
+../../../submodules/opencl-headers/CL/cl_ext.h
@@ -0,0 +1,2 @@
+#include <CL/cl.h>
+#include <CL/cl_ext.h>
@@ -0,0 +1,11 @@
+@../../remap-stdint.rsp
+--remap
+_cl_platform_id=cl_platform_id
+_cl_device_id=cl_device_id
+_cl_context=cl_context
+_cl_command_queue=cl_command_queue
+_cl_mem=cl_mem
+_cl_program=cl_program
+_cl_kernel=cl_kernel
+_cl_event=cl_event
+_cl_sampler=cl_sampler
@@ -0,0 +1,11 @@
+@../../common.rsp
+--define-macro
+TODO_DEFINE_MACROS=HERE
+--headerFile
+../header.txt
+--include-directory
+../../../submodules/opencl-headers
+--with-callconv
+*=Winapi
+--with-librarypath
+*=opencl
@@ -4,8 +4,8 @@ TODO_DEFINE_MACROS=HERE
 --headerFile
 ../header.txt
 --include-directory
-../../../submodules/opengl/api
-../../../submodules/egl/api
+../../../submodules/opengl-registry/api
+../../../submodules/egl-registry/api
 ../../../include
 --with-callconv
 *=Winapi

@@ -0,0 +1,5 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+// Ported from the OpenXR headers and corresponding dependencies.
+// Original source is Copyright 2017-2026 The Khronos Group Inc. Licensed under the MIT license.
@@ -0,0 +1,16 @@
+@../settings.rsp
+@../remap.rsp
+--exclude
+XR_NULL_HANDLE
+--file
+openxr-openxr.h
+--methodClassName
+Xr
+--namespace
+Silk.NET.OpenXR
+--output
+../../../../sources/OpenXR/OpenXR
+--test-output
+../../../../tests/OpenXR/OpenXR
+--traverse
+../../../submodules/openxr-sdk/include/openxr/openxr.h
@@ -0,0 +1 @@
+#include <openxr/openxr.h>
@@ -0,0 +1 @@
+@../../remap-stdint.rsp
@@ -0,0 +1,11 @@
+@../../common.rsp
+--define-macro
+TODO_DEFINE_MACROS=HERE
+--headerFile
+../header.txt
+--include-directory
+../../../submodules/openxr-sdk/include
+--with-callconv
+*=Winapi
+--with-librarypath
+*=openxr_loader