Files
XericUIActionVessel/Runtime/XChart/Pools/XChartTextSlotFactory.cs
T
lrss3 c51ab7a3c8 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/,未入本仓库。)
2026-10-25 20:21:28 +08:00

137 lines
5.4 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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;
}
}
}