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
@@ -21,7 +21,7 @@
     <!-- Analyzers -->
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="5.3.0" />
     <!-- SilkTouch -->
-    <PackageVersion Include="ClangSharp.PInvokeGenerator" Version="21.1.8.3" />
+    <PackageVersion Include="ClangSharp.PInvokeGenerator" Version="21.1.8.4" />
     <PackageVersion Include="CSharpier.Core" Version="1.3.0" />
     <PackageVersion Include="Humanizer.Core" Version="2.14.1" />
     <PackageVersion Include="Microsoft.Build.Locator" Version="1.11.2" />

@@ -17,6 +17,9 @@
   <Folder Name="/examples/CSharp/OpenAL/">
     <Project Path="examples/CSharp/OpenAL/Tutorial001.HelloSound/OpenAL.Tutorial001.HelloSound.csproj" />
   </Folder>
+    <Folder Name="/examples/CSharp/OpenCL/">
+        <Project Path="examples/CSharp/OpenCL/Tutorial001.SimpleKernel/OpenCL.Tutorial001.SimpleKernel.csproj" />
+    </Folder>
   <Folder Name="/examples/CSharp/SDL/">
     <Project Path="examples/CSharp/SDL/Tutorial001.HelloWindow/SDL.Tutorial001.HelloWindow.csproj" />
   </Folder>
@@ -54,9 +57,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 (needs more work to be usable).
 - 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,73 @@
 # 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.
+
+---
+
+For APIs that use the `Flags/FlagBits` pattern, the `Flags` version of the name is use for both the native name and
+managed name. This is because the XML data uses the `Flags` version to provide base type data. There was a time where
+we preferred the `FlagBits` version instead for the `[NativeName]` attribute. This is because searching for the
+`FlagBits` version online brings up a more useful documentation page.
+
+### 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.

@@ -111,6 +111,9 @@ Stateless APIs are typically accessed through static methods, while stateful API
 objects. More information on this can be found in the
 [Static vs Instance Bindings](../../silk.net/static-vs-instance-bindings.md) document.
 
+`[DllImport]` is used over `[LibraryImport]` because `[LibraryImport]`'s source generator ends up using `[DllImport]`
+in its generated code.
+
 Usage recommendations:
 
 (TODO: To be added)
@@ -170,6 +173,9 @@ provide cross-platform bindings.
 - Enums use `uint` as their backing type on Linux instead of `int` like on Windows. Silk handles this by using
   `TransformEnums` to "coerce" the backing types to their Windows equivalents when possible.
 
+- C `long` is output as C# `long` on Windows and C# `nint` on Linux. Silk handles this by generating bindings on Windows
+  where possible.
+
 Note: There may be other differences not yet documented here. In the case new differences are discovered, please
 update this section. API-specific differences should not be documented here and should be documented in the
 [API-Specific Notes](api-specific-notes.md) document.
@@ -213,10 +219,6 @@ Usage recommendations:
 
 This mod should be used when the API being bound makes use of the pre-C99 enum pattern described above.
 
-This mod was originally part of the now removed `ExtractNestedTyping` mod. For simplicity, feel free to include all
-mods originally from `ExtractNestedTyping`. However, you may also include the mods strictly needed for the bindings
-being generated.
-
 ### ExtractFunctionPointers
 
 Mod categories: Creation
@@ -237,8 +239,15 @@ Name affix categories:
   delegate representation of a function pointer type to distinguish the delegate type from the struct type for extracted
   function pointers.
 
-- `FunctionPointerParent` - This is a prefix used by the delegate representation of a function pointer type. This is
-  used to ensure that the delegate type always uses the current name of its struct counterpart as part of its own name.
+- `FunctionPointerNameFallbackParent` - This is a prefix used by the struct representation of a function pointer type.
+  This is used in cases where a "fallback" name is used since there is no other native name available. For example, if
+  an unmanaged delegate was extracted from a method parameter, the method name and parameter name are joined together.
+  This prefix references the method name to ensure that the struct type uses the final name of the method as part of
+  its own name during name prettification.
+
+- `FunctionPointerParent` - This is a prefix used by the delegate representation of a function pointer type. This
+  prefix references the name of its struct counterpart to ensure that the delegate type uses the final name of its
+  struct counterpart as part of its own name during name prettification.
 
 These affixes are usually left unconfigured in `PrettifyNames`.
 
@@ -247,10 +256,6 @@ Usage recommendations:
 This mod should be used when a set of bindings contains unmanaged delegates annotated with `[NativeTypeName]`
 attributes.
 
-This mod was originally part of the now removed `ExtractNestedTyping` mod. For simplicity, feel free to include all
-mods originally from `ExtractNestedTyping`. However, you may also include the mods strictly needed for the bindings
-being generated.
-
 ### ExtractHandles
 
 Mod categories: Creation
@@ -297,10 +302,6 @@ Furthermore, this mod should be used alongside `TransformHandles` so that the ha
 user-friendly version. `ExtractHandles` should be positioned before `TransformHandles` and any other mods that might use
 its results in the mod order.
 
-This mod was originally part of the now removed `ExtractNestedTyping` mod. For simplicity, feel free to include all
-mods originally from `ExtractNestedTyping`. However, you may also include the mods strictly needed for the bindings
-being generated.
-
 ### ExtractNestedTypes
 
 Mod categories: Creation
@@ -316,8 +317,8 @@ Examples for how `ExtractNestedTypes` works can be found in the `ExtractNestedTy
 Name affix categories:
 
 - `NestedStructParent` - This is a prefix that references the name of the type that the extracted type was previously
-  nested in. This is used to ensure that the extracted type always uses the current name of its original "parent" type
-  as part of its own name.
+  nested in. This ensures the extracted type uses the final name of its original "parent" type as part of its own name
+  during name prettification.
 
 These affixes are usually left unconfigured in `PrettifyNames`.
 
@@ -328,10 +329,6 @@ bindings. This is because `PrettifyNames` does not handle nesting when renaming
 restrictions. This restriction is generally because nesting increases complexity, and as such, mods are written with the
 assumption that nested types are extracted beforehand.
 
-This mod was originally part of the now removed `ExtractNestedTyping` mod. For simplicity, feel free to include all
-mods originally from `ExtractNestedTyping`. However, you may also include the mods strictly needed for the bindings
-being generated.
-
 ### IdentifySharedPrefixes
 
 Mod categories: Metadata, Naming
@@ -496,13 +493,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.
 

@@ -386,10 +386,16 @@ public struct GamepadBindingInput;
 public struct GamepadBindingInputAxis;
 ```
 
-Limitation: Only simple references are allowed because references are resolved manually by `PrettifyNames` and not by
-Roslyn. For example, `nameof(GamepadBinding.Member)` will not work because member access expressions are not handled.
-Currently, only identifiers that exist in the current scope or parent scope can be referenced. That said, this should be
-enough for most use cases.
+Or from the OpenCL bindings:
+```cs
+[NameAffix("Prefix", "FunctionPointerNameFallbackParent", nameof(Cl.EnqueueSvmFreeARM))]
+public struct EnqueueSvmFreeArmPfnFreFunc;
+
+public class Cl
+{
+    public int EnqueueSvmFreeARM();
+}
+```
 
 ## Symbol-based Renamer