feat(render): refactor pipeline & shader system for DX12 WG
Major refactor of render pipeline and shader system: - Replaced legacy shader properties with source generator and attribute-based HLSL struct generation. - Introduced ShaderPropertiesRegistry for runtime property layout/code registration. - Added modular IRenderPipeline, IRenderPipelineSettings, and IRenderPayload interfaces. - Implemented GhostRenderPipeline and ECS-driven GPUScene management. - Added experimental DirectX 12 Work Graph support. - Refactored shader compilation, variant hashing, and caching. - Updated APIs for consistency and improved codegen for registration. These changes modernize the rendering infrastructure for advanced features like work graphs and dynamic pipelines. BREAKING CHANGE: Shader DSL, pipeline, and property APIs have changed. Existing shaders and pipeline integrations must be updated.
This commit is contained in:
@@ -60,30 +60,32 @@ namespace Ghost.Generator
|
||||
return;
|
||||
}
|
||||
|
||||
var name = $"g_component_registration";
|
||||
|
||||
var sb = new StringBuilder();
|
||||
sb.Append($@"
|
||||
[global::System.ComponentModel.EditorBrowsable(global::System.ComponentModel.EditorBrowsableState.Never)]
|
||||
internal static class {name}
|
||||
{{
|
||||
[global::System.Runtime.CompilerServices.ModuleInitializer]
|
||||
public static void RegisterIComponentTypes()
|
||||
{{");
|
||||
|
||||
foreach (var symbol in components.Distinct(SymbolEqualityComparer.Default))
|
||||
{
|
||||
if (symbol is null) continue;
|
||||
if (symbol is null)
|
||||
{
|
||||
continue;
|
||||
}
|
||||
|
||||
sb.Append($@"
|
||||
global::Ghost.Entities.ComponentRegistry.GetOrRegisterComponentID<{symbol.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat)}>();");
|
||||
sb.AppendLine($@" global::Ghost.Entities.ComponentRegistry.GetOrRegisterComponentID<{symbol.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat)}>();");
|
||||
}
|
||||
|
||||
sb.Append(@"
|
||||
}
|
||||
}");
|
||||
var typeName = $"g_component_registration";
|
||||
var code = $@"// <auto-generated/>
|
||||
|
||||
context.AddSource($"{name}.gen.cs", SourceText.From(sb.ToString(), Encoding.UTF8));
|
||||
[global::System.ComponentModel.EditorBrowsable(global::System.ComponentModel.EditorBrowsableState.Never)]
|
||||
internal static partial class {typeName}
|
||||
{{
|
||||
[global::System.Runtime.CompilerServices.ModuleInitializer]
|
||||
internal static void RegisterIComponentTypes()
|
||||
{{
|
||||
{sb}
|
||||
}}
|
||||
}}";
|
||||
|
||||
context.AddSource($"{typeName}.gen.cs", code);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>netstandard2.0</TargetFramework>
|
||||
<LangVersion>14.0</LangVersion>
|
||||
<EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
|
||||
</PropertyGroup>
|
||||
|
||||
|
||||
215
src/Runtime/Ghost.Generator/ShaderPropertiesGenerator.cs
Normal file
215
src/Runtime/Ghost.Generator/ShaderPropertiesGenerator.cs
Normal file
@@ -0,0 +1,215 @@
|
||||
using Microsoft.CodeAnalysis;
|
||||
using System.Collections.Immutable;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
|
||||
namespace Ghost.Generator
|
||||
{
|
||||
[Generator]
|
||||
internal class ShaderPropertiesGenerator : IIncrementalGenerator
|
||||
{
|
||||
private class ShaderStructInfo
|
||||
{
|
||||
public string ShaderName
|
||||
{
|
||||
set; get;
|
||||
}
|
||||
|
||||
public string Name
|
||||
{
|
||||
get; set;
|
||||
}
|
||||
|
||||
public INamedTypeSymbol TypeSymbol
|
||||
{
|
||||
get; set;
|
||||
}
|
||||
}
|
||||
|
||||
public void Initialize(IncrementalGeneratorInitializationContext context)
|
||||
{
|
||||
var shaderProperties = context.SyntaxProvider
|
||||
.ForAttributeWithMetadataName(
|
||||
"Ghost.Core.Graphics.GenerateShaderPropertyAttribute",
|
||||
(n, ct) => n is Microsoft.CodeAnalysis.CSharp.Syntax.StructDeclarationSyntax,
|
||||
(ctx, ct) =>
|
||||
{
|
||||
var structSymbol = (INamedTypeSymbol)ctx.TargetSymbol;
|
||||
|
||||
var attributeData = ctx.Attributes.FirstOrDefault(ad => ad.AttributeClass?.ToDisplayString() == "Ghost.Core.Graphics.GenerateShaderPropertyAttribute");
|
||||
if (attributeData == null)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
return new ShaderStructInfo
|
||||
{
|
||||
ShaderName = attributeData.ConstructorArguments[0].Value as string,
|
||||
Name = attributeData.ConstructorArguments[1].Value as string ?? structSymbol.Name,
|
||||
TypeSymbol = structSymbol
|
||||
};
|
||||
})
|
||||
.Where(x => x != null)
|
||||
.Collect();
|
||||
|
||||
context.RegisterSourceOutput(shaderProperties, GenerateHlslPropertyStruct);
|
||||
}
|
||||
|
||||
private void GenerateHlslPropertyStruct(SourceProductionContext context, ImmutableArray<ShaderStructInfo> array)
|
||||
{
|
||||
if (array.IsDefaultOrEmpty)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
var codeBuilder = new StringBuilder();
|
||||
var registerBuilder = new StringBuilder();
|
||||
|
||||
foreach (var info in array)
|
||||
{
|
||||
if (string.IsNullOrEmpty(info.ShaderName))
|
||||
{
|
||||
context.ReportDiagnostic(Diagnostic.Create(new DiagnosticDescriptor(
|
||||
"GSHADER001",
|
||||
"Invalid shader name",
|
||||
$"Shader name for struct '{info.TypeSymbol.Name}' cannot be null or empty.",
|
||||
"ShaderGeneration",
|
||||
DiagnosticSeverity.Error,
|
||||
isEnabledByDefault: true), info.TypeSymbol.Locations.FirstOrDefault()));
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!info.TypeSymbol.IsUnmanagedType)
|
||||
{
|
||||
context.ReportDiagnostic(Diagnostic.Create(new DiagnosticDescriptor(
|
||||
"GSHADER002",
|
||||
"Unsupported struct type",
|
||||
$"Struct '{info.TypeSymbol.Name}' is not an unmanaged type and cannot be used for HLSL generation.",
|
||||
"ShaderGeneration",
|
||||
DiagnosticSeverity.Error,
|
||||
isEnabledByDefault: true), info.TypeSymbol.Locations.FirstOrDefault()));
|
||||
continue;
|
||||
}
|
||||
|
||||
var definedSymbol = $"__{info.Name.ToUpper()}_G_HLSL";
|
||||
|
||||
var fields = info.TypeSymbol.GetMembers().OfType<IFieldSymbol>();
|
||||
foreach (var field in fields)
|
||||
{
|
||||
if (field.IsStatic || field.IsConst)
|
||||
{
|
||||
continue;
|
||||
}
|
||||
|
||||
var hlslTypeAttribute = field.GetAttributes().FirstOrDefault(ad => ad.AttributeClass?.ToDisplayString() == "Ghost.Engine.Utilities.GenerateAsHLSLTypeAttribute");
|
||||
var hlslType = string.Empty;
|
||||
|
||||
if (hlslTypeAttribute == null)
|
||||
{
|
||||
switch (field.Type.SpecialType)
|
||||
{
|
||||
case SpecialType.System_Single:
|
||||
hlslType = "float";
|
||||
break;
|
||||
case SpecialType.System_Int32:
|
||||
hlslType = "int";
|
||||
break;
|
||||
case SpecialType.System_UInt32:
|
||||
hlslType = "uint";
|
||||
break;
|
||||
default:
|
||||
var typeName = field.Type.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat);
|
||||
switch (typeName)
|
||||
{
|
||||
case "global::System.Numerics.Vector2":
|
||||
hlslType = "float2";
|
||||
break;
|
||||
case "global::System.Numerics.Vector3":
|
||||
hlslType = "float3";
|
||||
break;
|
||||
case "global::System.Numerics.Vector4":
|
||||
hlslType = "float4";
|
||||
break;
|
||||
case "global::System.Numerics.Matrix3x3":
|
||||
hlslType = "float3x3";
|
||||
break;
|
||||
case "global::System.Numerics.Matrix4x4":
|
||||
hlslType = "float4x4";
|
||||
break;
|
||||
case "global::System.Numerics.Quaternion" or "global::Misaki.HighPerformance.Mathematics.quaternion":
|
||||
hlslType = "float4";
|
||||
break;
|
||||
case var _ when typeName.StartsWith("global::Misaki.HighPerformance.Mathematics."):
|
||||
hlslType = typeName.Substring("global::Misaki.HighPerformance.Mathematics.".Length);
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
break;
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
hlslType = hlslTypeAttribute.ConstructorArguments[0].Value as string;
|
||||
}
|
||||
|
||||
if (string.IsNullOrEmpty(hlslType))
|
||||
{
|
||||
context.ReportDiagnostic(Diagnostic.Create(new DiagnosticDescriptor(
|
||||
"GSHADER003",
|
||||
"Unsupported field type",
|
||||
$"Field '{field.Name}' in struct '{info.TypeSymbol.Name}' has unsupported type '{field.Type.ToDisplayString()}' for HLSL generation.",
|
||||
"ShaderGeneration",
|
||||
DiagnosticSeverity.Error,
|
||||
isEnabledByDefault: true), field.Locations.FirstOrDefault()));
|
||||
continue;
|
||||
}
|
||||
|
||||
codeBuilder.AppendLine($" {hlslType} {field.Name};");
|
||||
}
|
||||
|
||||
var code = $@"// <auto-generated/>
|
||||
|
||||
namespace {info.TypeSymbol.ContainingNamespace.ToDisplayString()}
|
||||
{{
|
||||
[global::System.Runtime.InteropServices.StructLayout(global::System.Runtime.InteropServices.LayoutKind.Sequential, Pack = 4)]
|
||||
{info.TypeSymbol.DeclaredAccessibility.ToString().ToLower()} partial struct {info.TypeSymbol.Name}
|
||||
{{
|
||||
public const string HLSL_SOURCE = @""
|
||||
# ifndef {definedSymbol}
|
||||
# define {definedSymbol}
|
||||
struct {info.Name}
|
||||
{{
|
||||
{codeBuilder}
|
||||
}};
|
||||
# endif // {definedSymbol}"";
|
||||
}}
|
||||
}}";
|
||||
|
||||
context.AddSource($"{info.TypeSymbol.Name}_HLSL.gen.cs", code);
|
||||
codeBuilder.Clear();
|
||||
|
||||
var typeFullName = info.TypeSymbol.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat);
|
||||
registerBuilder.AppendLine($@" global::Ghost.Core.Graphics.ShaderPropertiesRegistry.Register(""{info.ShaderName}"", {typeFullName}.HLSL_SOURCE, (uint)sizeof({typeFullName}));");
|
||||
}
|
||||
|
||||
var registerTypeName = "g_shaderproperty_registeration";
|
||||
var registerCode = $@"// <auto-generated/>
|
||||
|
||||
[global::System.ComponentModel.EditorBrowsable(global::System.ComponentModel.EditorBrowsableState.Never)]
|
||||
internal static partial class {registerTypeName}
|
||||
{{
|
||||
#if DEBUG || GHOST_EDITOR
|
||||
[global::System.Runtime.CompilerServices.ModuleInitializer]
|
||||
internal unsafe static void RegisterShaderProperties()
|
||||
{{
|
||||
{registerBuilder}
|
||||
}}
|
||||
#endif
|
||||
}}";
|
||||
|
||||
context.AddSource($"{registerTypeName}.gen.cs", registerCode);
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user