feat(srp): formalize renderer contracts and project feature bridge

2026-04-20 15:03:45 +08:00
parent 10b092d467
commit a615f78e72
13 changed files with 1604 additions and 28 deletions
--- a/tests/scripting/test_project_script_assembly.cpp
+++ b/tests/scripting/test_project_script_assembly.cpp
@@ -1,5 +1,11 @@
 #include <gtest/gtest.h>

+#include <XCEngine/Rendering/Execution/CameraFrameRenderGraphFrameData.h>
+#include <XCEngine/Rendering/Graph/RenderGraph.h>
+#include <XCEngine/Rendering/Graph/RenderGraphCompiler.h>
+#include <XCEngine/Rendering/Pipelines/ManagedScriptableRenderPipelineAsset.h>
+#include <XCEngine/Rendering/RenderSurface.h>
+#include <XCEngine/RHI/RHIResourceView.h>
 #include <XCEngine/Scripting/Mono/MonoScriptRuntime.h>

 #include <algorithm>
@@ -146,4 +152,111 @@ TEST_F(ProjectScriptAssemblyTest, DiscoversProjectAssetMonoBehaviourClassesAndFi
    EXPECT_FLOAT_EQ(std::get<float>(defaultValues[2].value), 2.5f);
 }

+TEST_F(ProjectScriptAssemblyTest, DiscoversProjectAssetRenderPipelineAssetClasses) {
+    std::vector<ScriptClassDescriptor> classes;
+    ASSERT_TRUE(runtime->TryGetAvailableRenderPipelineAssetClasses(classes));
+
+    EXPECT_NE(
+        std::find(
+            classes.begin(),
+            classes.end(),
+            ScriptClassDescriptor{
+                "GameScripts",
+                "ProjectScripts",
+                "ProjectUniversalFeaturePipelineAsset"}),
+        classes.end());
+}
+
+TEST_F(
+    ProjectScriptAssemblyTest,
+    CreatesProjectAssetUniversalFeatureRuntimeThroughManagedBridge) {
+    const auto bridge =
+        XCEngine::Rendering::Pipelines::GetManagedRenderPipelineBridge();
+    ASSERT_NE(bridge, nullptr);
+
+    const XCEngine::Rendering::Pipelines::ManagedRenderPipelineAssetDescriptor descriptor = {
+        "GameScripts",
+        "ProjectScripts",
+        "ProjectUniversalFeaturePipelineAsset"
+    };
+
+    std::shared_ptr<const XCEngine::Rendering::Pipelines::ManagedRenderPipelineAssetRuntime>
+        assetRuntime = bridge->CreateAssetRuntime(descriptor);
+    ASSERT_NE(assetRuntime, nullptr);
+    EXPECT_NE(assetRuntime->GetPipelineRendererAsset(), nullptr);
+
+    std::unique_ptr<XCEngine::Rendering::RenderPipelineStageRecorder> recorder =
+        assetRuntime->CreateStageRecorder();
+    ASSERT_NE(recorder, nullptr);
+
+    const XCEngine::Rendering::RenderContext renderContext = {};
+    ASSERT_TRUE(recorder->Initialize(renderContext));
+    EXPECT_TRUE(
+        recorder->SupportsStageRenderGraph(
+            XCEngine::Rendering::CameraFrameStage::MainScene));
+    EXPECT_TRUE(
+        recorder->SupportsStageRenderGraph(
+            XCEngine::Rendering::CameraFrameStage::PostProcess));
+
+    XCEngine::Rendering::RenderGraph graph;
+    XCEngine::Rendering::RenderGraphBuilder graphBuilder(graph);
+    XCEngine::Rendering::RenderGraphTextureDesc colorDesc = {};
+    colorDesc.width = 64u;
+    colorDesc.height = 64u;
+    colorDesc.format =
+        static_cast<XCEngine::Core::uint32>(
+            XCEngine::RHI::Format::R8G8B8A8_UNorm);
+    const XCEngine::Rendering::RenderGraphTextureHandle sourceColor =
+        graphBuilder.ImportTexture(
+            "ProjectManagedPostProcessSource",
+            colorDesc,
+            reinterpret_cast<XCEngine::RHI::RHIResourceView*>(901),
+            {});
+    const XCEngine::Rendering::RenderGraphTextureHandle outputColor =
+        graphBuilder.CreateTransientTexture(
+            "ProjectManagedPostProcessOutput",
+            colorDesc);
+
+    const XCEngine::Rendering::RenderSceneData sceneData = {};
+    const XCEngine::Rendering::RenderSurface surface(64u, 64u);
+    bool executionSucceeded = true;
+    XCEngine::Rendering::RenderGraphBlackboard blackboard = {};
+    XCEngine::Rendering::EmplaceCameraFrameRenderGraphFrameData(blackboard)
+        .resources.mainScene.color = sourceColor;
+    const XCEngine::Rendering::RenderPipelineStageRenderGraphContext graphContext = {
+        graphBuilder,
+        "ProjectManagedPostProcess",
+        XCEngine::Rendering::CameraFrameStage::PostProcess,
+        renderContext,
+        sceneData,
+        surface,
+        nullptr,
+        nullptr,
+        XCEngine::RHI::ResourceStates::Common,
+        {},
+        { outputColor },
+        {},
+        {},
+        &executionSucceeded,
+        &blackboard
+    };
+
+    EXPECT_TRUE(recorder->RecordStageRenderGraph(graphContext));
+
+    XCEngine::Rendering::CompiledRenderGraph compiledGraph = {};
+    XCEngine::Containers::String errorMessage;
+    ASSERT_TRUE(
+        XCEngine::Rendering::RenderGraphCompiler::Compile(
+            graph,
+            compiledGraph,
+            &errorMessage))
+        << errorMessage.CStr();
+    ASSERT_EQ(compiledGraph.GetPassCount(), 1u);
+    EXPECT_STREQ(
+        compiledGraph.GetPassName(0).CStr(),
+        "ProjectManagedPostProcess");
+
+    recorder->Shutdown();
+}
+
 } // namespace