RecursiveAI.OneShader
0.1.0-preview.1
Prefix Reserved
See the version list below for details.
dotnet add package RecursiveAI.OneShader --version 0.1.0-preview.1
NuGet\Install-Package RecursiveAI.OneShader -Version 0.1.0-preview.1
<PackageReference Include="RecursiveAI.OneShader" Version="0.1.0-preview.1" />
<PackageVersion Include="RecursiveAI.OneShader" Version="0.1.0-preview.1" />
<PackageReference Include="RecursiveAI.OneShader" />
paket add RecursiveAI.OneShader --version 0.1.0-preview.1
#r "nuget: RecursiveAI.OneShader, 0.1.0-preview.1"
#:package RecursiveAI.OneShader@0.1.0-preview.1
#addin nuget:?package=RecursiveAI.OneShader&version=0.1.0-preview.1&prerelease
#tool nuget:?package=RecursiveAI.OneShader&version=0.1.0-preview.1&prerelease
OneShader
A HLSL compiler for .NET, written in C#, with no dependency beyond .NET itself. Modern HLSL (Shader Model 6 style) for vertex, pixel and compute shaders goes in; SPIR-V for Vulkan comes out, with reflection: inputs and outputs, resource bindings, buffer layouts and thread-group sizes. NativeAOT and trimming are supported.
Preview. Version 0.1 targets Vulkan (SPIR-V). The API may still change before 1.0.
Most projects want RecursiveAI.OneShader.Build,
which compiles *.hlsl during dotnet build and generates C# bindings. This package is the
compiler itself, for compiling at run time (hot reload, tools) and for the support types the
generated code uses.
Install
dotnet add package RecursiveAI.OneShader --prerelease
Target framework net10.0. The namespace is OneShader.
Quick start
using OneShader;
string source = File.ReadAllText("Shaders/Blur.hlsl");
CompileResult result = ShaderCompiler.Compile(source, "Shaders/Blur.hlsl", new CompileOptions
{
Defines = [new("RADIUS", "4")],
IncludeDirectories = ["Shaders/Common"],
});
foreach (var d in result.Diagnostics)
Console.WriteLine(d); // Shaders/Blur.hlsl(12,5): error OSH0300: ...
if (result.Success)
{
ReadOnlySpan<byte> spirv = result.Find("PSMain", CompileTarget.SpirV)!.Data;
var reflection = result.Reflection!; // resources, bindings, buffer layouts, entry points
}
Errors are returned as diagnostics with file, line and column, never thrown. Includes can come from
disk or from memory through CompileOptions.IncludeResolver. Output is deterministic.
What works in 0.1
- Vertex, pixel and compute shaders in modern HLSL (HLSL 2021): structs, functions, constant
buffers, textures and samplers, structured and byte-address buffers, storage images,
groupshared memory, barriers and atomics, and the preprocessor (
#include, macros,#if). - SPIR-V for Vulkan 1.2, validated with
spirv-val, and checked by running each shader in its test corpus on a GPU against the same shader compiled by DXC. - Buffer layouts and descriptor bindings follow the conventions DXC uses for Vulkan.
Known limits
- SPIR-V only. Metal (MSL) and WebGPU (WGSL) output are planned; asking for them returns diagnostic OSH0002.
- Resources are single (
Count == 1); resource arrays are not supported yet. - HLSL templates, struct member functions, operator overloads and wave intrinsics report "not supported yet".
License
MIT OR Apache-2.0, at your option. Copyright © Recursive AI, LLC.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
NuGet packages (4)
Showing the top 4 NuGet packages that depend on RecursiveAI.OneShader:
| Package | Downloads |
|---|---|
|
RecursiveAI.OneShader.Build
Compiles HLSL shaders during dotnet build: SPIR-V embedded in the assembly, shader errors as build errors on the HLSL line, and generated C# structs and binding constants laid out to match each shader. |
|
|
RecursiveAI.OneGame.Host
The game host: window, input, fixed-step simulation, UI and render stage for one game, windowed or headless. |
|
|
RecursiveAI.OneGame.Control
The control layer shared by the command line, the test API and live control. |
|
|
RecursiveAI.OneGpu
Devices, buffers, compute pipelines and command encoders for .NET, on any backend. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.7.1 | 59 | 11/13/2026 |
| 1.7.0 | 472 | 11/12/2026 |
| 1.6.1 | 132 | 11/11/2026 |
| 1.6.0 | 107 | 11/11/2026 |
| 1.5.0 | 96 | 11/11/2026 |
| 1.4.1 | 94 | 11/11/2026 |
| 1.4.0 | 159 | 10/27/2026 |
| 1.3.0 | 4,642 | 10/27/2026 |
| 1.2.0 | 247 | 10/27/2026 |
| 1.1.0 | 288 | 10/27/2026 |
| 1.0.0 | 699 | 10/25/2026 |
| 0.4.0-preview.1 | 83 | 10/25/2026 |
| 0.3.0-preview.1 | 78 | 10/25/2026 |
| 0.2.0-preview.1 | 84 | 10/25/2026 |
| 0.1.0-preview.1 | 81 | 10/25/2026 |