feat(d3d12): add indirect command execution support

Added ICommandSignature and D3D12CommandSignature for indirect command execution in the D3D12 backend, with supporting types. Updated ICommandBuffer and IGraphicsEngine interfaces to support indirect execution and command signature creation. Refactored command buffer pooling in D3D12GraphicsEngine for more flexible reuse. Changed BeginFrame and EndFrame to void and clarified parameter names. Updated resource and frame data structures to use direct buffer indices. Added RenderingUtility for buffer and texture uploads. Removed IRenderOutput interface. Updated RenderSystem render loop and HLSL/C# code to match new buffer usage patterns. BREAKING CHANGE: ICommandBuffer, IGraphicsEngine, and related APIs have changed signatures and behaviors. Indirect command execution is now supported and required for some advanced features.
2026-04-05 23:11:08 +09:00
parent effd33b285
commit c6bdbe0710
21 changed files with 488 additions and 220 deletions
--- a/src/Runtime/Ghost.Graphics/Utilities/RenderingUtility.cs
+++ b/src/Runtime/Ghost.Graphics/Utilities/RenderingUtility.cs
@@ -0,0 +1,88 @@
+using Ghost.Core;
+using Ghost.Graphics.RHI;
+using System.Diagnostics;
+
+namespace Ghost.Graphics.Utilities;
+
+public static unsafe class RenderingUtility
+{
+    public static void UploadBuffer<T>(ResourceManager resourceManager, IResourceDatabase resourceDatabase, ICommandBuffer cmd, Handle<GPUBuffer> buffer, params ReadOnlySpan<T> data)
+        where T : unmanaged
+    {
+        var r = resourceDatabase.GetResourceDescription(buffer.AsResource());
+        if (r.IsFailure)
+        {
+            return;
+        }
+
+        Debug.Assert(r.Value.Type == ResourceType.Buffer);
+
+        var sizeInBytes = (nuint)(data.Length * sizeof(T));
+        var memoryType = r.Value.BufferDescription.HeapType;
+
+        if (memoryType == HeapType.Upload)
+        {
+            fixed (T* pData = data)
+            {
+                resourceDatabase.MapResource(buffer.AsResource(), 0, null, null, pData, sizeInBytes);
+            }
+        }
+        else
+        {
+            var uploadDesc = new BufferDesc
+            {
+                Size = sizeInBytes,
+                Usage = BufferUsage.Upload,
+                HeapType = HeapType.Upload,
+            };
+
+            var uploadHandle = resourceManager.CreateTransientBuffer(in uploadDesc);
+            if (uploadHandle.IsInvalid)
+            {
+                throw new OutOfMemoryException("Failed to create upload buffer for buffer data.");
+            }
+
+            fixed (T* pData = data)
+            {
+                resourceDatabase.MapResource(uploadHandle.AsResource(), 0, null, null, pData, sizeInBytes);
+            }
+
+            cmd.CopyBuffer(buffer, uploadHandle, 0, 0, sizeInBytes);
+        }
+    }
+
+    public static void UploadTexture<T>(ResourceManager resourceManager, IResourceDatabase resourceDatabase, ICommandBuffer cmd, Handle<GPUTexture> texture, ReadOnlySpan<T> data)
+        where T : unmanaged
+    {
+        var desc = resourceDatabase.GetResourceDescription(texture.AsResource()).GetValueOrThrow();
+        desc.TextureDescription.Format.GetSurfaceInfo(desc.TextureDescription.Width, desc.TextureDescription.Height, out var rowPitch, out var slicePitch, out _);
+
+        var requiredSize = resourceDatabase.GetIntermediateResourceSize(texture.AsResource(), 0, 1);
+        var uploadDesc = new BufferDesc
+        {
+            Size = requiredSize,
+            Usage = BufferUsage.Upload,
+            HeapType = HeapType.Upload,
+        };
+
+        var uploadHandle = resourceManager.CreateTransientBuffer(in uploadDesc);
+        if (uploadHandle.IsInvalid)
+        {
+            throw new OutOfMemoryException("Failed to create upload buffer for texture data.");
+        }
+
+        cmd.Barrier(BarrierDesc.Texture(texture.AsResource(), BarrierSync.Copy, BarrierAccess.CopyDest, BarrierLayout.CopyDest));
+
+        fixed (T* pData = data)
+        {
+            var subresourceData = new SubResourceData
+            {
+                pData = pData,
+                rowPitch = rowPitch,
+                slicePitch = slicePitch
+            };
+
+            cmd.UpdateSubResources(texture.AsResource(), uploadHandle.AsResource(), subresourceData);
+        }
+    }
+}