XChart 图表框架落地(P0–P17):格线单一作者、面板一行状态、矢量场
此前整个 XChart 特性一直没有提交(分期 P0–P12 的代码与素材都还在工作区里)。这一批一并入库, 并含本轮 P13–P17 的改动(规范 Documentation/XChart-RenderFramework.md 新增 §22–§25): - P13:格线只剩一个作者——线框工具不再有"画格线 / 发布格线插槽"的代码路径;BG Cube Grid(原 MeshBg) 是唯一作者,且"画上去的线=发布给轴线的那份比例数组";插槽板新增 Unpublish(说得出"这里不再有线", 否则掩码筛掉的面会把上一轮的值留着被消费者吸走);渲染参数搬进元素表 (DeclareDefaultElements / AddDefaultElement + XChartElementTable 按类型去重,只在第一次读到表时补); 图上「立方体外观」那组字段删除、公共属性转发到元素表;面板逐行点名脚本注册的工具。 - P14 / P15:数据窗口文案收敛(行末 `-`、标题 `X [0]`、长说明退回 tooltip、范围页三行不再被压扁); 元素块收成一行状态 `▼ 名称 √ R… D… [↑][↓][-]`;**注册序由类型定死、只显示不给输入控件, 绘制序与元素在表里的位置绑定**(§24.5,他 2026-10-25 澄清);默认元素让删也让关; EnsureSpace 改成每次重建后都跑(删掉"空间"不再等于整张图空掉)。 - P17:矢量场——维数不够时不再静默不画(元素配置报需求,面板与报表同时印"需求/现有"); 相对/绝对两种读法收进纯算术 XChartVectorFieldMath;连续绘制(互斥显示把"相对/绝对"藏起来); 颜色维(色相走 0..256 色环,饱和/明度/不透明 0..1,不透明度不算硬需求);新增螺旋矢量场测试数据。 数据口径按他澄清修正为:前三维=坐标、一支箭头=相邻两条记录、第 4~7 维是颜色(§25、CHANGELOG 修正行)。 判据:编译门三臂 + 3 支对照绿;离线探针 436 项 0 失败;p4_control 55 支臂各红在自己点名的断言上; p2_control / pool_family / generator_gate / hierarchy_gate 在同一棵交付树上复跑。 (证据脚本与日志在包外的 .ximage-gate/,未入本仓库。)
This commit is contained in:
@@ -0,0 +1,136 @@
|
||||
using System.Collections.Generic;
|
||||
using TMPro;
|
||||
using UnityEngine;
|
||||
|
||||
namespace XericUI.XChart.Pools
|
||||
{
|
||||
/// <summary>
|
||||
/// 文本槽位工厂:运行时里<b>唯一</b>造 TMP 标签的地方(规范 §5)。
|
||||
///
|
||||
/// <para>空闲的槽位停在池根(chart 根下的 <c>GeneratedTextPool</c> 节点)上并停用;
|
||||
/// 发落出去时挂到该 owner 自己的宿主节点。"父节点必须等于宿主"是有效性判据的一部分——
|
||||
/// 域重载后宿主是新实例,旧标签还挂在旧父节点上,这种必须丢弃重补,
|
||||
/// 不能让它带着上一轮的父子关系继续画。</para>
|
||||
///
|
||||
/// <para>池根整块没了(chart 被销毁又重建)不抛异常:<see cref="EnsurePoolRoot"/> 直接重建。</para>
|
||||
/// </summary>
|
||||
public sealed class XChartTextSlotFactory : IXChartSlotFactory<TMP_Text>
|
||||
{
|
||||
/// <summary>池根节点名。chart 的回收校验和调试报表都按这个名字找它,所以只此一份。</summary>
|
||||
public const string PoolRootName = "GeneratedTextPool";
|
||||
|
||||
private readonly RectTransform m_ChartRoot;
|
||||
private readonly Stack<TMP_Text> m_Free = new Stack<TMP_Text>();
|
||||
private RectTransform m_PoolRoot;
|
||||
private int m_SlotIndex;
|
||||
|
||||
public XChartTextSlotFactory(RectTransform chartRoot)
|
||||
{
|
||||
m_ChartRoot = chartRoot;
|
||||
}
|
||||
|
||||
/// <summary>池里闲置的槽位数(调试判据用:调度收敛后应当等于"曾经发落过又还回来的")</summary>
|
||||
public int FreeCount => m_Free.Count;
|
||||
|
||||
public TMP_Text Acquire()
|
||||
{
|
||||
var poolRoot = EnsurePoolRoot();
|
||||
if (poolRoot == null) return null;
|
||||
|
||||
while (m_Free.Count > 0)
|
||||
{
|
||||
TMP_Text slot = m_Free.Pop();
|
||||
// 空闲表里也可能有域重载留下的僵尸件:验不过就当场销毁,别发出去
|
||||
if (!IsAlive(slot)) { DestroySlot(slot); continue; }
|
||||
slot.gameObject.SetActive(true);
|
||||
return slot;
|
||||
}
|
||||
|
||||
var go = new GameObject("TextSlot_" + m_SlotIndex, typeof(RectTransform));
|
||||
m_SlotIndex++;
|
||||
go.transform.SetParent(poolRoot, false);
|
||||
go.hideFlags = XChartBase.CurrentFlags;
|
||||
|
||||
var tmp = go.AddComponent<TextMeshProUGUI>();
|
||||
tmp.text = string.Empty;
|
||||
tmp.enableWordWrapping = false;
|
||||
tmp.alignment = TextAlignmentOptions.Center;
|
||||
var rect = tmp.rectTransform;
|
||||
rect.anchorMin = new Vector2(0.5f, 0.5f);
|
||||
rect.anchorMax = new Vector2(0.5f, 0.5f);
|
||||
rect.pivot = new Vector2(0.5f, 0.5f);
|
||||
return tmp;
|
||||
}
|
||||
|
||||
public void Release(TMP_Text slot)
|
||||
{
|
||||
if (!IsAlive(slot)) return;
|
||||
slot.text = string.Empty;
|
||||
slot.gameObject.SetActive(false);
|
||||
var poolRoot = EnsurePoolRoot();
|
||||
if (poolRoot != null) slot.transform.SetParent(poolRoot, false);
|
||||
m_Free.Push(slot);
|
||||
}
|
||||
|
||||
public void Assign(TMP_Text slot, object host)
|
||||
{
|
||||
if (!IsAlive(slot)) return;
|
||||
var parent = host as RectTransform;
|
||||
if (parent == null) return;
|
||||
slot.transform.SetParent(parent, false);
|
||||
slot.gameObject.SetActive(true);
|
||||
}
|
||||
|
||||
public bool IsUsable(TMP_Text slot, object host)
|
||||
{
|
||||
var parent = host as RectTransform;
|
||||
if (parent == null) return false;
|
||||
if (!IsAlive(slot)) return false;
|
||||
return slot.transform.parent == parent && slot.gameObject.activeSelf;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 存在性合取判据(§5.3 的前半):件还在、GameObject 还在、保存位仍然带 DontSave。
|
||||
/// 父节点与激活状态因 owner 而异,交给 <see cref="IsUsable"/>。
|
||||
/// </summary>
|
||||
private static bool IsAlive(TMP_Text slot)
|
||||
{
|
||||
if (slot == null) return false;
|
||||
if (slot.gameObject == null) return false;
|
||||
return (slot.hideFlags & HideFlags.DontSave) != 0;
|
||||
}
|
||||
|
||||
private static void DestroySlot(TMP_Text slot)
|
||||
{
|
||||
if (slot == null) return;
|
||||
if (slot.gameObject == null) return;
|
||||
UnityEngine.Object.DestroyImmediate(slot.gameObject);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 拆池:把池根连同池内件一起硬销毁。<b>必须有这一步</b>——池根挂在 chart 自己下面而
|
||||
/// 工具清理只拆 <c>[XChartTools]</c>,不拆它就等于每回收重建一次漏一个池根在场景里。
|
||||
/// 已经发落出去的件不归这里:它们在各工具的宿主下,随工具根一起销毁。
|
||||
/// </summary>
|
||||
public void DestroyAll()
|
||||
{
|
||||
m_Free.Clear();
|
||||
if (m_PoolRoot == null) return;
|
||||
var rootObject = m_PoolRoot.gameObject;
|
||||
m_PoolRoot = null;
|
||||
if (rootObject != null) UnityEngine.Object.DestroyImmediate(rootObject);
|
||||
}
|
||||
|
||||
private RectTransform EnsurePoolRoot()
|
||||
{
|
||||
if (m_PoolRoot != null) return m_PoolRoot;
|
||||
if (m_ChartRoot == null) return null;
|
||||
|
||||
var go = new GameObject(PoolRootName, typeof(RectTransform));
|
||||
go.transform.SetParent(m_ChartRoot, false);
|
||||
go.hideFlags = XChartBase.CurrentFlags;
|
||||
m_PoolRoot = go.GetComponent<RectTransform>();
|
||||
return m_PoolRoot;
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user