update 0.6.3.7

This commit is contained in:
2026-07-30 09:18:26 +08:00
parent 54644a9f15
commit 46560ea78f
49 changed files with 1126 additions and 1325 deletions
@@ -1,341 +1,134 @@
using System;
using System.Collections.Generic;
using UnityEngine;
using XericLibrary.Runtime.MacroLibrary;
namespace XericLibrary.Runtime.Blueprint
namespace XericLibrary.Runtime.Blueprint.Render
{
/// <summary>
/// 蓝图画布渲染工具的抽象基类。
/// <para>
/// 职责:
/// 1. 管理 Viewport Transform — 平移/缩放改为驱动 Transform,不触发 Mesh 重建。
/// 2. 管理网格区块(Chunk)— 按画布坐标分块,每块一个渲染器,避开 65535 顶点限制。
/// 3. 数据分组 — 脏元素的坐标 ÷ chunkSize → Spiral2DEncode → 按 Chunk 写入渲染器。
/// </para>
/// <para>
/// 派生类只需实现三个抽象方法:
/// <list type="bullet">
/// <item><see cref="BuildChunkRenderer"/> — 在 Chunk GameObject 上创建渲染器组件</item>
/// <item><see cref="AppendElementData"/> — 把元素数据写入该 Chunk 的渲染器</item>
/// <item><see cref="ClearChunk"/> — 清空 Chunk 渲染器,准备下一帧重写</item>
/// </list>
/// </para>
/// </summary>
/// <typeparam name="TChildRenderer">Chunk 使用的渲染器组件类型</typeparam>
public abstract class BlueprintCanvasRenderTool<TChildRenderer> : BlueprintTool
where TChildRenderer : MonoBehaviour
/// <summary>Chunk renderer 后端基类:仅消费 Graph.ChunkState 的提交,不计算归属或可见性。</summary>
public abstract class BlueprintCanvasRenderTool<TChildRenderer> : BlueprintTool where TChildRenderer : MonoBehaviour
{
// ====================================================================
// 配置
// ====================================================================
/// <summary>网格区块大小(画布空间单位)。一个 Chunk 覆盖 chunkSize × chunkSize 区域。</summary>
protected int ChunkSize = 400;
/// <summary>Chunk 池的最大缓存数量</summary>
protected int MaxPoolSize = 100;
// ====================================================================
// Chunk 数据
// ====================================================================
/// <summary>活跃区块:Spiral2DEncode ID → 渲染器实例</summary>
protected Dictionary<ulong, TChildRenderer> ActiveChunks = new();
/// <summary>缓存池,减少创建/销毁</summary>
protected Stack<TChildRenderer> ChunkPool = new();
/// <summary>Chunk 的父级 Transform(通常在 Viewport 下)</summary>
protected readonly Dictionary<ulong, TChildRenderer> ActiveChunks = new Dictionary<ulong, TChildRenderer>();
protected readonly Stack<TChildRenderer> ChunkPool = new Stack<TChildRenderer>();
protected Transform ChunksParent;
// ====================================================================
// Viewport 状态
// ====================================================================
/// <summary>当前同步到的 Viewport Transform</summary>
protected RectTransform ViewportRect;
private Vector2 _prevPan;
private float _prevZoom;
// ====================================================================
// 抽象方法(派生类实现)
// ====================================================================
/// <summary>在 Chunk GameObject 上创建渲染器组件并返回。</summary>
protected abstract TChildRenderer BuildChunkRenderer(GameObject chunkGo);
/// <summary>将元素数据写入指定 Chunk 的渲染器。</summary>
protected abstract void AppendElementData(TChildRenderer renderer, IBlueprintElement element);
/// <summary>清空 Chunk 渲染器的数据,准备下一帧重写。</summary>
/// <summary>当前模板方法提交;子类不得重新计算 chunk 本地偏移。</summary>
protected BlueprintElementRenderSubmission CurrentElementSubmission { get; private set; }
protected abstract void AppendElementData(TChildRenderer renderer, IBlueprintElement element, ulong chunkID);
protected abstract void ClearChunkData(TChildRenderer renderer);
/// <summary>触发 Chunk 渲染器的脏标记,使其重建 Mesh。</summary>
protected abstract void SetChunkDirty(TChildRenderer renderer);
protected abstract bool AcceptsElement(IBlueprintElement element);
/// <summary>每个非退出 Chunk 提交的开始钩子。</summary>
protected virtual void BeginChunkSubmission(ulong chunkID, TChildRenderer renderer) { }
/// <summary>每个非退出 Chunk 提交的结束钩子。</summary>
protected virtual void EndChunkSubmission(ulong chunkID, TChildRenderer renderer) { }
protected virtual void OnChunkRecycled(ulong chunkID, TChildRenderer renderer) { }
/// <summary>获取元素用于 Chunk 分组的坐标(通常是 Position 或中心点)。</summary>
protected abstract Vector2 GetElementPosition(IBlueprintElement element);
/// <summary>检查元素是否需要被剔除(例如不在视口内)。</summary>
protected abstract bool IsElementCulled(IBlueprintElement element);
// ====================================================================
// 生命周期
// ====================================================================
public override void OnInitialize()
{
EnsureViewport();
}
public override void OnInitialize() => EnsureViewport();
public override void OnConfigChanged() => Graph?.MarkAllElementsDirty();
public override void OnRender()
{
if (Graph?.Canvas == null) return;
// 1. 确保层级存在
if (Graph?.Canvas == null || Graph.ChunkState == null) return;
EnsureViewport();
// 2. 同步 Viewport Transform(O(1),不重建 Mesh)
if (ViewportRect == null) return;
SyncViewportTransform();
// 3. 检查是否有脏元素
if (Graph.DirtyFlags == null || !Graph.DirtyFlags.HasDirty)
return;
// 4. 收集并分组脏元素
var groups = GroupDirtyElements();
if (groups.Count == 0) return;
// 5. 写入 Chunk 渲染器
foreach (var kvp in groups)
foreach (var submission in Graph.ChunkState.Submissions)
{
var renderer = GetOrCreateChunk(kvp.Key);
if (submission.Kind == ChunkSubmissionKind.Exited) { RecycleChunk(submission.ChunkId); continue; }
var renderer = GetOrCreateChunk(submission.ChunkId);
if (renderer == null) continue;
ClearChunkData(renderer);
foreach (var element in kvp.Value)
AppendElementData(renderer, element);
BeginChunkSubmission(submission.ChunkId, renderer);
var session = new RenderSession(Graph, submission);
if (submission.Elements != null)
foreach (var element in submission.Elements)
if (AcceptsElement(element)) { CurrentElementSubmission = session.CreateElementSubmission(element); AppendElementData(renderer, element, submission.ChunkId); }
CurrentElementSubmission = null;
EndChunkSubmission(submission.ChunkId, renderer);
SetChunkDirty(renderer);
}
// 6. 清理空 Chunk
CleanupInactiveChunks(groups.Keys);
}
public override void OnDestroy()
{
DestroyAllChunks();
ViewportRect = null;
ChunksParent = null;
DestroyAllChunks(); ViewportRect = null; ChunksParent = null;
}
// ====================================================================
// Viewport
// ====================================================================
/// <summary>获取或创建 Viewport Transform。</summary>
protected virtual void EnsureViewport()
{
if (ViewportRect != null) return;
if (Graph?.Canvas == null) return;
if (ViewportRect != null || Graph?.Canvas == null) return;
var root = Graph.Canvas.GetRootTransform();
if (root == null) return;
// 查找已有的 __Bp_Viewport
var existing = root.Find("__Bp_Viewport");
if (existing != null)
ViewportRect = root.Find("__Bp_Viewport") as RectTransform;
if (ViewportRect == null)
{
ViewportRect = existing.GetComponent<RectTransform>();
ChunksParent = existing;
return;
var go = new GameObject("__Bp_Viewport", typeof(RectTransform)); go.hideFlags = HideFlags.HideAndDontSave;
ViewportRect = go.GetComponent<RectTransform>(); ViewportRect.SetParent(root, false);
}
// 创建 Viewport
var vpGo = new GameObject("__Bp_Viewport", typeof(RectTransform));
vpGo.hideFlags = HideFlags.HideAndDontSave;
vpGo.transform.SetParent(root, false);
vpGo.transform.SetAsFirstSibling(); // 在 GridBackground 之下
ViewportRect = vpGo.GetComponent<RectTransform>();
ViewportRect.anchorMin = Vector2.zero;
ViewportRect.anchorMax = Vector2.one;
ViewportRect.offsetMin = Vector2.zero;
ViewportRect.offsetMax = Vector2.zero;
ChunksParent = ViewportRect;
// 记录初始状态
_prevPan = Graph.Canvas.PanOffset;
_prevZoom = Graph.Canvas.ZoomLevel;
ViewportRect.anchoredPosition = -_prevPan;
ViewportRect.localScale = Vector3.one * _prevZoom;
var rootRect = root as RectTransform;
var pivot = rootRect != null ? rootRect.pivot : new Vector2(.5f, .5f);
ViewportRect.anchorMin = pivot; ViewportRect.anchorMax = pivot; ViewportRect.pivot = pivot;
ViewportRect.anchoredPosition = Vector2.zero; ViewportRect.sizeDelta = rootRect != null ? rootRect.rect.size : Vector2.zero;
ChunksParent = ViewportRect; _prevPan = Graph.Canvas.PanOffset; _prevZoom = Graph.Canvas.ZoomLevel;
ViewportRect.anchoredPosition = _prevPan; ViewportRect.localScale = Vector3.one * _prevZoom;
}
/// <summary>将画布的 Pan/Zoom 同步到 Viewport Transform。</summary>
protected virtual void SyncViewportTransform()
{
if (ViewportRect == null) return;
var pan = Graph.Canvas.PanOffset;
var zoom = Graph.Canvas.ZoomLevel;
if (_prevPan != pan)
{
ViewportRect.anchoredPosition = -pan;
_prevPan = pan;
}
if (!Mathf.Approximately(_prevZoom, zoom))
{
ViewportRect.localScale = Vector3.one * zoom;
_prevZoom = zoom;
}
var pan = Graph.Canvas.PanOffset; var zoom = Graph.Canvas.ZoomLevel;
if (_prevPan != pan) { ViewportRect.anchoredPosition = pan; _prevPan = pan; }
if (!Mathf.Approximately(_prevZoom, zoom)) { ViewportRect.localScale = Vector3.one * zoom; _prevZoom = zoom; }
}
// ====================================================================
// Chunk 管理
// ====================================================================
protected Vector2 ChunkOrigin(ulong id) => Graph.ChunkState.GetChunkOrigin(id);
/// <summary>将画布空间坐标转为 Chunk 坐标。</summary>
protected (int cx, int cy) PositionToCoord(Vector2 canvasPos)
/// <summary>一次 chunk 提交的标准化坐标、LOD 与版本上下文。</summary>
protected sealed class RenderSession
{
return (
Mathf.FloorToInt(canvasPos.x / ChunkSize),
Mathf.FloorToInt(canvasPos.y / ChunkSize)
);
private readonly BlueprintGraph _graph; private readonly ChunkSubmission _submission; private readonly Vector2 _origin; private readonly Rect _bounds;
public RenderSession(BlueprintGraph graph, ChunkSubmission submission) { _graph=graph; _submission=submission; _origin=graph.ChunkState.GetChunkOrigin(submission.ChunkId); _bounds=graph.ChunkState.GetChunkRect(submission.ChunkId); }
public BlueprintElementRenderSubmission CreateElementSubmission(IBlueprintElement element) => new BlueprintElementRenderSubmission(element, element.BoundingBox.center, element.BoundingBox, _origin, _bounds, _graph.CurrentLod, _submission.ContentRevision, _submission.LodRevision);
}
/// <summary>Chunk 坐标 → 螺旋曲线 ID。</summary>
protected ulong CoordToID(int cx, int cy)
public sealed class BlueprintElementRenderSubmission
{
return MacroCurveMapping.Spiral2DEncode(cx, cy);
public readonly IBlueprintElement Element; public readonly Vector2 CanvasPosition, ChunkOrigin, ChunkLocalPosition; public readonly Rect CanvasBounds, ChunkLocalBounds; public readonly BlueprintLodLevel LOD; public readonly int ContentRevision, LodRevision;
public BlueprintElementRenderSubmission(IBlueprintElement element, Vector2 canvasPosition, Rect canvasBounds, Vector2 chunkOrigin, Rect chunkBounds, BlueprintLodLevel lod, int contentRevision, int lodRevision)
{ Element=element; CanvasPosition=canvasPosition; CanvasBounds=canvasBounds; ChunkOrigin=chunkOrigin; ChunkLocalPosition=canvasPosition-chunkOrigin; ChunkLocalBounds=new Rect(canvasBounds.position-chunkOrigin, canvasBounds.size); LOD=lod; ContentRevision=contentRevision; LodRevision=lodRevision; }
/// <summary>将提交元素相关的 Canvas 空间数据转换为当前 Chunk 局部空间。</summary>
public Vector2 ToChunkLocal(Vector2 canvasPosition) => canvasPosition - ChunkOrigin;
public Rect ToChunkLocal(Rect canvasBounds) => new Rect(canvasBounds.position - ChunkOrigin, canvasBounds.size);
}
/// <summary>螺旋曲线 ID → Chunk 坐标。</summary>
protected void IDToCoord(ulong id, out int cx, out int cy)
protected TChildRenderer GetOrCreateChunk(ulong id)
{
MacroCurveMapping.Spiral2DDecode(id, out cx, out cy);
}
/// <summary>获取或创建坐标对应的 Chunk 渲染器。</summary>
protected TChildRenderer GetOrCreateChunk(ulong chunkID)
{
if (ActiveChunks.TryGetValue(chunkID, out var renderer) && renderer != null)
return renderer;
IDToCoord(chunkID, out int cx, out int cy);
if (ActiveChunks.TryGetValue(id, out var renderer) && renderer != null) return renderer;
BlueprintChunkState.DecodeCoord(id, out int x, out int y);
GameObject go;
// 从池中取或新建
if (ChunkPool.Count > 0)
{
go = ChunkPool.Pop().gameObject;
go.SetActive(true);
}
else
{
go = new GameObject($"Chunk_{cx}_{cy}", typeof(RectTransform));
go.hideFlags = HideFlags.HideAndDontSave;
go.transform.SetParent(ChunksParent, false);
}
// 定位 Chunk
var rt = go.GetComponent<RectTransform>();
rt.pivot = Vector2.zero; // 左下角为原点
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.zero; // 不拉伸,绝对定位
rt.anchoredPosition = new Vector2(cx * ChunkSize, cy * ChunkSize);
rt.sizeDelta = new Vector2(ChunkSize, ChunkSize);
// 获取或创建渲染器
renderer = go.GetComponent<TChildRenderer>();
if (renderer == null)
renderer = BuildChunkRenderer(go);
ActiveChunks[chunkID] = renderer;
return renderer;
if (ChunkPool.Count > 0) { go = ChunkPool.Pop().gameObject; go.SetActive(true); }
else { go = new GameObject("Chunk_" + x + "_" + y, typeof(RectTransform)); go.hideFlags = HideFlags.HideAndDontSave; go.transform.SetParent(ChunksParent, false); }
var rt = go.GetComponent<RectTransform>(); var pivot = ViewportRect.pivot;
rt.anchorMin = pivot; rt.anchorMax = pivot; rt.pivot = pivot; rt.anchoredPosition = ChunkOrigin(id);
rt.sizeDelta = new Vector2(Graph.ChunkState.ChunkSize, Graph.ChunkState.ChunkSize);
renderer = go.GetComponent<TChildRenderer>() ?? BuildChunkRenderer(go); ActiveChunks[id] = renderer; return renderer;
}
/// <summary>收集脏元素并按 Chunk 分组。</summary>
protected virtual Dictionary<ulong, List<IBlueprintElement>> GroupDirtyElements()
private void RecycleChunk(ulong id)
{
var groups = new Dictionary<ulong, List<IBlueprintElement>>();
var dirtyList = Graph.DirtyFlags.FlushDirty();
foreach (var element in dirtyList)
{
if (element == null) continue;
// 剔除
if (IsElementCulled(element)) continue;
var pos = GetElementPosition(element);
var (cx, cy) = PositionToCoord(pos);
ulong id = CoordToID(cx, cy);
if (!groups.TryGetValue(id, out var list))
{
list = new List<IBlueprintElement>();
groups[id] = list;
}
list.Add(element);
}
return groups;
if (!ActiveChunks.TryGetValue(id, out var renderer) || renderer == null) { ActiveChunks.Remove(id); return; }
OnChunkRecycled(id, renderer);
if (ChunkPool.Count < MaxPoolSize) { renderer.gameObject.SetActive(false); ChunkPool.Push(renderer); }
else UnityEngine.Object.Destroy(renderer.gameObject);
ActiveChunks.Remove(id);
}
/// <summary>清理不再包含脏元素的 Chunk。</summary>
protected virtual void CleanupInactiveChunks(Dictionary<ulong, List<IBlueprintElement>>.KeyCollection activeIDs)
{
var toRemove = new List<ulong>();
foreach (var kvp in ActiveChunks)
{
if (!System.Linq.Enumerable.Contains(activeIDs, kvp.Key))
toRemove.Add(kvp.Key);
}
foreach (var id in toRemove)
{
if (!ActiveChunks.TryGetValue(id, out var renderer) || renderer == null)
continue;
// 入池或销毁
if (ChunkPool.Count < MaxPoolSize)
{
renderer.gameObject.SetActive(false);
ChunkPool.Push(renderer);
}
else
{
UnityEngine.Object.Destroy(renderer.gameObject);
}
ActiveChunks.Remove(id);
}
}
/// <summary>销毁所有 Chunk。</summary>
protected virtual void DestroyAllChunks()
{
foreach (var kvp in ActiveChunks)
{
if (kvp.Value != null)
UnityEngine.Object.Destroy(kvp.Value.gameObject);
}
foreach (var pair in ActiveChunks) if (pair.Value != null) UnityEngine.Object.Destroy(pair.Value.gameObject);
ActiveChunks.Clear();
while (ChunkPool.Count > 0)
{
var pooled = ChunkPool.Pop();
if (pooled != null)
UnityEngine.Object.Destroy(pooled.gameObject);
}
while (ChunkPool.Count > 0) { var item = ChunkPool.Pop(); if (item != null) UnityEngine.Object.Destroy(item.gameObject); }
}
}
}
}