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

managed/XCEngine.ScriptCore/Rendering/Universal/RendererBackedRenderPipelineAsset.cs

@@ -10,6 +10,8 @@ namespace XCEngine.Rendering.Universal
         public ScriptableRendererData[] rendererDataList =
             Array.Empty<ScriptableRendererData>();
         public int defaultRendererIndex = 0;
+        private int m_rendererDataRuntimeStateHash;
+        private bool m_rendererDataRuntimeStateHashResolved;
 
         protected RendererBackedRenderPipelineAsset()
         {
@@ -27,7 +29,7 @@ namespace XCEngine.Rendering.Universal
                 new RendererCameraRequestContext(context));
 
             ScriptableRendererData resolvedRendererData =
-                GetDefaultRendererData();
+                ResolveSelectedRendererData();
             if (resolvedRendererData != null)
             {
                 resolvedRendererData
@@ -40,7 +42,7 @@ namespace XCEngine.Rendering.Universal
             ScriptableRenderPipelinePlanningContext context)
         {
             ScriptableRendererData resolvedRendererData =
-                GetDefaultRendererData();
+                ResolveSelectedRendererData();
             if (resolvedRendererData != null)
             {
                 resolvedRendererData
@@ -52,7 +54,7 @@ namespace XCEngine.Rendering.Universal
         protected override string GetPipelineRendererAssetKey()
         {
             ScriptableRendererData resolvedRendererData =
-                GetDefaultRendererData();
+                ResolveSelectedRendererData();
             return resolvedRendererData != null
                 ? resolvedRendererData
                     .GetPipelineRendererAssetKeyInstance()
@@ -64,6 +66,29 @@ namespace XCEngine.Rendering.Universal
             ReleaseRendererDataRuntimeResources();
         }
 
+        protected override void SynchronizeRuntimeResourceVersion()
+        {
+            int runtimeStateHash =
+                ComputeRendererDataRuntimeStateHash();
+            if (!m_rendererDataRuntimeStateHashResolved)
+            {
+                m_rendererDataRuntimeStateHash =
+                    runtimeStateHash;
+                m_rendererDataRuntimeStateHashResolved = true;
+                return;
+            }
+
+            if (runtimeStateHash ==
+                m_rendererDataRuntimeStateHash)
+            {
+                return;
+            }
+
+            m_rendererDataRuntimeStateHash =
+                runtimeStateHash;
+            SetDirty();
+        }
+
         protected virtual ScriptableRenderPipeline
         CreateRendererBackedPipeline()
         {
@@ -83,37 +108,34 @@ namespace XCEngine.Rendering.Universal
 
         internal ScriptableRendererData GetDefaultRendererData()
         {
-            return GetRendererData(defaultRendererIndex);
+            return ResolveSelectedRendererData();
         }
 
         internal ScriptableRenderer GetDefaultRenderer()
         {
-            return GetRenderer(defaultRendererIndex);
+            return ResolveSelectedRenderer();
+        }
+
+        internal ScriptableRendererData ResolveSelectedRendererData()
+        {
+            return ResolveRendererDataByResolvedIndex(
+                ResolveSelectedRendererIndex());
+        }
+
+        internal ScriptableRenderer ResolveSelectedRenderer()
+        {
+            ScriptableRendererData rendererData =
+                ResolveSelectedRendererData();
+            return rendererData != null
+                ? rendererData.GetRendererInstance()
+                : null;
         }
 
         internal ScriptableRendererData GetRendererData(
             int rendererIndex)
         {
-            EnsureRendererDataList();
-            if (rendererDataList.Length == 0)
-            {
-                return null;
-            }
-
-            int resolvedRendererIndex =
-                ResolveRendererIndex(rendererIndex);
-            if (resolvedRendererIndex < 0)
-            {
-                return null;
-            }
-
-            if (rendererDataList[resolvedRendererIndex] == null)
-            {
-                rendererDataList[resolvedRendererIndex] =
-                    CreateDefaultRendererData();
-            }
-
-            return rendererDataList[resolvedRendererIndex];
+            return ResolveRendererDataByResolvedIndex(
+                ResolveRendererIndex(rendererIndex));
         }
 
         internal ScriptableRenderer GetRenderer(
@@ -182,6 +204,60 @@ namespace XCEngine.Rendering.Universal
             return false;
         }
 
+        private int ComputeRendererDataRuntimeStateHash()
+        {
+            unchecked
+            {
+                int hash = 17;
+                hash =
+                    (hash * 31) +
+                    ResolveSelectedRendererIndex();
+                if (rendererDataList == null)
+                {
+                    return hash;
+                }
+
+                hash = (hash * 31) + rendererDataList.Length;
+                for (int i = 0; i < rendererDataList.Length; ++i)
+                {
+                    ScriptableRendererData rendererData =
+                        rendererDataList[i];
+                    if (rendererData != null)
+                    {
+                        hash =
+                            (hash * 31) +
+                            rendererData
+                                .GetRuntimeStateVersionInstance();
+                    }
+                }
+
+                return hash;
+            }
+        }
+
+        private ScriptableRendererData ResolveRendererDataByResolvedIndex(
+            int resolvedRendererIndex)
+        {
+            EnsureRendererDataList();
+            if (resolvedRendererIndex < 0)
+            {
+                return null;
+            }
+
+            if (rendererDataList[resolvedRendererIndex] == null)
+            {
+                rendererDataList[resolvedRendererIndex] =
+                    CreateDefaultRendererData();
+            }
+
+            return rendererDataList[resolvedRendererIndex];
+        }
+
+        private int ResolveSelectedRendererIndex()
+        {
+            return ResolveRendererIndex(defaultRendererIndex);
+        }
+
         private int ResolveRendererIndex(
             int rendererIndex)
         {