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:
2026-10-25 20:21:28 +08:00
parent 216d157472
commit c51ab7a3c8
105 changed files with 13062 additions and 812 deletions
+563 -36
View File
@@ -1,55 +1,143 @@
using System.Collections.Generic;
using TMPro;
using UnityEngine;
using XericUI.Core;
using XericUI.XChart.Pools;
using XericUI.XChart.Space;
namespace XericUI.XChart
{
/// <summary>
/// 图表主行为组件基类。
///
/// 标记 [ExecuteAlways] 确保编辑器下生命周期正常执行。
/// 派生类在 Start() 中创建工具并配置数据模型。
/// <para><b>两条注册路径,同一个管理器</b>:</para>
/// <list type="number">
/// <item><b>脚本路径</b>:派生类重写 <see cref="RegisterTools"/>,在里面 <see cref="RegisterTool{T}"/>
/// 登记工具。写死在代码里、不进序列化,适合固定组合。</item>
/// <item><b>配置路径</b>:Inspector 的"元素"表(<see cref="XChartElementConfig"/>),
/// 每个元素自带配置、可增删、可改字段。</item>
/// </list>
/// 两条路最终都落到 <see cref="XChartToolsManager"/> 上,靠 <c>OrderIndex</c> 决定绘制顺序。
///
/// <para><b>生命周期(严格分段,钩子见下)</b></para>
/// <code>
/// ── 初始化(Awake / OnEnable,[ExecuteAlways] 下编辑期同样执行)──
/// BuildToolsRoot 建 [XChartTools] + 管理器(并把数据中转口交给它)
/// RegisterTools() ★ 脚本注册工具(唯一的集中注册点)
/// RebuildElements() 配置路径加载元素
/// EnsureSpace() 两条路都没登记空间工具就补一个默认的
/// OnChartInitialized() 通用收尾
/// OnRuntimeInitialized() / OnEditorInitialized() 按 Application.isPlaying 二选一
/// ForceRefresh() 首帧全量刷一次
///
/// ── 每帧 ──
/// Update() ToolManager.UpdateAll() + NeedsRefresh() 时走正常刷新
/// LateUpdate() ToolManager.RenderAll() (渲染只在 LateUpdate 里做)
///
/// ── 刷新 ──
/// Refresh() 脏标记驱动的正常刷新(数据版本变了,或有人 RequestRefresh())
/// ForceRefresh() 无条件刷新(编辑期改旋钮、重置之后都走它)
/// 两者都汇到 OnChartRefresh(bool force),派生类只需实现这一个
///
/// ── 重置 ──
/// ResetRender() 渲染层重建(不碰数据)
/// ResetData() 清数据 + 数据缓存,再刷新
/// RebuildAll() 回收重建:拆掉全部生成物再走一遍完整初始化(含每个工具)
/// </code>
///
/// <para><b>脏是怎么判的</b>:用<b>数据版本号</b>(<see cref="IXChartDataSource.Version"/>)与
/// "本图已消费的版本"比对,而不是共用脏标记再协调清理——版本号不需要谁来清,
/// 所以"某个消费者清了脏、另一个消费者还没看到"这类互相污染不可能发生。</para>
/// </summary>
[AddComponentMenu("Xeric/XChart/Chart Base")]
[AddComponentMenu(XericRegistrationPaths.Chart + "/Chart Base")]
[ExecuteAlways]
public abstract class XChartBase : MonoBehaviour
public abstract partial class XChartBase : MonoBehaviour
{
[Header("工具管理")]
[Header("调试")]
[SerializeField] private bool m_ShowDebug;
[SerializeField] private bool m_HideAllTools;
[SerializeField] private XChartDataModel m_DataModel = new XChartDataModel();
[Header("元素")]
// 元素配置:所有元素(网格背景 / 轴线 / 数据图元…)共用这一张表,
// [SerializeReference] 让每个元素按自己的实际类型序列化并在 Inspector 里展开。
[SerializeReference] private List<XChartElementConfig> m_Elements = new List<XChartElementConfig>();
/// <summary>
/// 这张表的元素被填过没有。<b>它存在的唯一理由</b>是:默认元素只在"从来没有元素"的图上补
/// (老场景里靠脚本注册的那批),他手工把表清空之后不该又被塞回来。
/// </summary>
[SerializeField, HideInInspector] private bool m_ElementsSeen;
public XChartToolsManager ToolManager { get; private set; }
public Transform ToolsRoot { get; private set; }
public XChartDataModel DataModel => m_DataModel;
private bool m_IsInitialized;
/// <summary>
/// 数据访问中转口:元素(网格背景 / 轴线 / 数据图元)只认这个接口,
/// 不直接摸记录数组。默认就是 <see cref="XChartDataModel"/> 的直通实现。
/// </summary>
public IXChartDataSource DataSource => m_DataModel;
private long m_ConsumedDataVersion = -1;
private bool m_RefreshRequested = true;
// ── hideFlags ─────────────────────────────────────────────
private const HideFlags k_EditorFlags = HideFlags.DontSaveInEditor;
/// <summary>
/// 编辑期生成物:<b>既不进资产(DontSaveInEditor),也不出现在 Hierarchy</b>。
/// 图是脚本画出来的,节点列表里混一堆临时物体只会让人误操作;要看就按调试按钮临时显示。
/// </summary>
private const HideFlags k_EditorFlags = HideFlags.DontSaveInEditor | HideFlags.HideInHierarchy;
private const HideFlags k_PlayFlags = HideFlags.HideAndDontSave;
internal static HideFlags CurrentFlags =>
Application.isPlaying ? k_PlayFlags : k_EditorFlags;
// ── 生命周期 ──────────────────────────────────────────────
// ══ 阶段一:初始化 ═══════════════════════════════════════
private void Awake()
{
Initialize();
}
private void Awake() => EnsureInitialized();
protected virtual void OnEnable()
{
if (!m_IsInitialized) Initialize();
}
protected virtual void OnEnable() => EnsureInitialized();
private void Initialize()
/// <summary>
/// <b>“初始化过了没有”只由 <see cref="ToolManager"/> 是否在位来判</b>,不自立一个 bool 标记。
///
/// <para>脚本重载时 Unity 会把托管字段备份再还原:普通 bool 原样回来,
/// 而 <see cref="XChartToolsManager"/> 这种纯托管引用回不来(变 null)。先前那种
/// <c>if (m_IsInitialized) return;</c> 的写法在这个时刻就成了"自称初始化完、其实什么都没有"的
/// 僵尸态——工具建不出来,后续 <c>ReapplyElements/ForceRefresh</c> 又都在
/// <c>ToolManager == null</c> 上静默 return,Inspector 里怎么改都不响应,只能拆了重挂。
/// 引用本身判空就不会和它保护的东西失联。</para>
/// </summary>
private void EnsureInitialized()
{
if (m_IsInitialized) return;
if (ToolManager != null) return;
BuildToolsRoot();
var flags = CurrentFlags;
RegisterTools();
DeclareMissingElements();
RebuildElements();
EnsureSpace();
OnChartInitialized();
if (Application.isPlaying)
{
OnRuntimeInitialized();
}
else
{
OnEditorInitialized();
}
// 重建出来的都是新节点:调试开关(显示生成物 / 隐藏全部工具)必须再过一遍,
// 否则界面上勾着、实际却没有任何效果
ApplyDebugVerbs();
ForceRefresh();
}
private void BuildToolsRoot()
{
var toolsRoot = transform.Find("[XChartTools]") as RectTransform;
if (toolsRoot == null)
{
@@ -57,41 +145,308 @@ namespace XericUI.XChart
toolsRoot = toolsObj.GetComponent<RectTransform>();
toolsRoot.SetParent(transform, false);
}
else
{
// 复用到旧根就说明上一个域的生成物还挂着:那些工具的 POCO 主人已经没了,
// 再也没人更新或清理它们,留着只会变成画不出东西的幽灵节点
PurgeLeftoverChildren(toolsRoot);
}
toolsRoot.anchorMin = Vector2.zero;
toolsRoot.anchorMax = Vector2.one;
toolsRoot.offsetMin = Vector2.zero;
toolsRoot.offsetMax = Vector2.zero;
toolsRoot.pivot = new Vector2(0.5f, 0.5f);
toolsRoot.gameObject.hideFlags = flags;
toolsRoot.gameObject.hideFlags = CurrentFlags;
ToolsRoot = toolsRoot;
PurgeLeftoverPoolRoots();
ToolManager = new XChartToolsManager
{
ToolsRoot = ToolsRoot,
};
m_IsInitialized = true;
// 上下文的委托读的是这个字段:重建后旧上下文不会拽着旧空间不放
ToolManager.Context = new XChartRenderContext(m_DataModel,
() => ToolManager != null ? ToolManager.FindTool<ChartToolSpace>() : null);
// 文本槽位池归 chart 所有:工具只申请,分配与回收在这里统一调度(规范 §5)
ToolManager.TextPool = new XChartSlotPool<TMP_Text>(
new XChartTextSlotFactory((RectTransform)transform));
}
private static void PurgeLeftoverChildren(RectTransform root)
{
for (int i = root.childCount - 1; i >= 0; i--)
{
var child = root.GetChild(i).gameObject;
if (Application.isPlaying) Object.Destroy(child);
else Object.DestroyImmediate(child);
}
}
/// <summary>
/// 清掉上个域遗留的池根。池根挂在 <b>chart 自己</b>下面(不在 <c>[XChartTools]</c> 里),
/// 所以复用旧 <c>[XChartTools]</c> 的那套孤儿清理带不走它:域重载后旧池根还在,
/// 新池再建一个,<b>每次重载攒一个</b>(验收现场报表打到 66 次 <c>POOL-ROOTS-LEAKED</c>,
/// 他重启 Unity 正好把这件事放大)。
/// </summary>
private void PurgeLeftoverPoolRoots()
{
for (int i = transform.childCount - 1; i >= 0; i--)
{
var child = transform.GetChild(i);
if (child.name != XChartTextSlotFactory.PoolRootName) continue;
if (Application.isPlaying) Destroy(child.gameObject);
else DestroyImmediate(child.gameObject);
}
}
/// <summary>
/// 图里的空间工具(<b>唯一的投影权威</b>)。两条注册路径都没有登记它时,
/// 这里补一个默认的——立方体空间的元素(背景 / 线框 / 散点 / 轴线)都靠它对齐,
/// 少了它就变成"各算各的投影"。
/// </summary>
public ChartToolSpace Space => ToolManager?.FindTool<ChartToolSpace>();
private void EnsureSpace()
{
if (ToolManager == null || ToolManager.FindTool<ChartToolSpace>() != null) return;
ToolManager.AddTool<ChartToolSpace>(ChartToolSpace.DefaultToolName, -1000);
}
/// <summary>
/// ★ <b>派生类在这里声明"这张图默认带哪些元素"</b>(规范 §22)。
///
/// <para>渲染参数挂在图上(旧版 <c>XPseudo3DScatterChart</c> 的「立方体外观」那组字段)有两个毛病:
/// 面板里它不在「工具」下,看不见是哪个东西在用;以及换一张图、加第二个背景时那份旋钮不能复用。
/// 搬进元素表之后,参数随元素走,脚本注册与配置注册是同一条路。</para>
///
/// <para><b>只在这张表"第一次被读到"时调用一次</b>(见 <see cref="m_ElementsSeen"/>),
/// 而且 <see cref="AddDefaultElement{T}"/> 按类型去重:表里已经有这一类就不再塞第二份。
/// 于是两种历史形态都照顾到了——表是空的(新图)补出整套默认元素;表里只有轴线/散点
/// (<b>老场景</b>:立方体那几件当时还是图上的字段、不在表里)只把缺的那几件补上,
/// 而不是"升级之后背景整块没了"。
/// 他之后把某个元素删掉,标记已置,<b>不会再自动补回来</b>——那是对着意愿干架。</para>
/// </summary>
protected virtual void DeclareDefaultElements() { }
/// <summary>把一份元素配置加进表(面板上的 Add 走序列化属性,不从这里走)</summary>
protected T AddElement<T>(T config) where T : XChartElementConfig
{
if (config == null || m_Elements.Contains(config)) return config;
m_Elements.Add(config);
return config;
}
/// <summary>
/// 补一份<b>默认</b>元素:这一类配置在表里已经存在时就沿用现有那条、不加第二份
/// (语义与判据见 <see cref="DeclareDefaultElements"/>)。
/// 真要"两个背景"是主动的事:面板 Add,或 <see cref="AddElement{T}"/>。
/// </summary>
protected T AddDefaultElement<T>(T config) where T : XChartElementConfig
{
int at = XChartElementTable.IndexOfKind(m_Elements, typeof(T));
if (at >= 0) return m_Elements[at] as T;
return AddElement(config);
}
/// <summary>
/// 第一次见到这张表 ⇒ 让派生类把这张图默认该有的元素补齐,并把"见过这张表"记下来。
/// 编辑器里额外打一次脏:默认元素要能存进场景、能在面板上被编辑,否则下次进来又是一张生表。
/// </summary>
private void DeclareMissingElements()
{
if (m_ElementsSeen) return;
m_ElementsSeen = true;
int before = m_Elements.Count;
DeclareDefaultElements();
#if UNITY_EDITOR
if (m_Elements.Count > before && !Application.isPlaying) UnityEditor.EditorUtility.SetDirty(this);
#endif
}
/// <summary>
/// ★ <b>脚本注册工具的唯一集中点</b>:派生类在这里登记自己要用的渲染工具。
/// 只在初始化时调用一次;配置路径(Inspector 元素表)走 <see cref="RebuildElements"/>,
/// 两条路互不冲突,都会进同一个管理器。
///
/// <para>新的预设请优先走 <see cref="DeclareDefaultElements"/>(元素表里的一条配置):
/// 那样面板上看得见、能改、能存。脚本路径留给"这张图必需的托管组件"(例如散点渲染器)。</para>
/// </summary>
protected virtual void RegisterTools() { }
/// <summary>登记一个工具(脚本路径的便捷写法,返回实例便于后续配置)</summary>
protected T RegisterTool<T>(string toolName, int orderIndex = 0)
where T : XChartToolBase, new()
=> ToolManager.AddTool<T>(toolName, orderIndex);
/// <summary>登记一个已经造好的工具实例</summary>
protected void RegisterTool(XChartToolBase tool, string toolName, int orderIndex = 0)
=> ToolManager?.AddTool(tool, toolName, orderIndex);
/// <summary>初始化全部完成(两条注册路径都已落地)后的通用钩子</summary>
protected virtual void OnChartInitialized() { }
/// <summary>仅运行时(Application.isPlaying)初始化后调用</summary>
protected virtual void OnRuntimeInitialized() { }
/// <summary>仅编辑器(编辑期,[ExecuteAlways] 下)初始化后调用</summary>
protected virtual void OnEditorInitialized() { }
// ══ 阶段二:每帧 ════════════════════════════════════════
protected virtual void Update()
{
if (!m_IsInitialized || ToolManager == null) return;
if (ToolManager == null) return;
// 工具在这里算出"这帧要几个标签"并申请(只置脏)
ToolManager.UpdateAll();
if (NeedsRefresh()) Refresh();
}
protected virtual void LateUpdate()
{
if (!m_IsInitialized || ToolManager == null) return;
if (ToolManager == null) return;
// 申请都收齐了才统一发落,然后才轮到渲染:顺序反了就会出现"这帧申请、下帧才有件"
ToolManager.DispatchTextPools();
ToolManager.RenderAll();
#if UNITY_EDITOR
EditorDumpTick();
#endif
}
// ── 工具管理 ──────────────────────────────────────────────
// ══ 阶段三:刷新 ════════════════════════════════════════
/// <summary>是否需要刷新:数据版本变了,或有人显式请求过</summary>
public bool NeedsRefresh()
=> m_RefreshRequested || m_ConsumedDataVersion != DataSource.Version;
/// <summary>请求一次刷新(脏标记):下一帧走正常刷新流程</summary>
public void RequestRefresh() => m_RefreshRequested = true;
/// <summary>正常刷新(版本比对不过就跳过,除非有人请求过)</summary>
public void Refresh()
{
if (!NeedsRefresh()) return;
m_RefreshRequested = false;
m_ConsumedDataVersion = DataSource.Version;
OnChartRefresh(false);
}
/// <summary>无条件刷新:编辑期改旋钮、重置之后都走这条</summary>
public void ForceRefresh()
{
m_RefreshRequested = false;
m_ConsumedDataVersion = DataSource.Version;
OnChartRefresh(true);
}
/// <summary>
/// 刷新钩子。<paramref name="force"/> 为 true 表示无条件刷新。
/// 派生类只需要实现这一个,正常刷新与强制刷新的差别由它自己决定。
/// </summary>
protected virtual void OnChartRefresh(bool force) { }
// ══ 阶段四:重置 ════════════════════════════════════════
/// <summary>渲染层重置:不碰数据,只让渲染重新来过</summary>
public void ResetRender()
{
OnResetRender();
ForceRefresh();
}
/// <summary>数据重置:清空数据与数据缓存,再刷新</summary>
public void ResetData()
{
m_DataModel?.Clear();
OnResetData();
ForceRefresh();
}
/// <summary>渲染层重置钩子</summary>
protected virtual void OnResetRender() { }
/// <summary>数据重置钩子(数据本身已由 <see cref="ResetData"/> 清空)</summary>
protected virtual void OnResetData() { }
/// <summary>
/// <b>回收重建</b>:把自己生成的全部节点拆掉,再走一遍完整初始化流程——chart 的初始化流程
/// 和每个工具的初始化流程依次重来(拆目录是 chart 的活,不下放给某个工具)。
/// 脚本重载、配置结构大改、或调试菜单里手动触发时用。
/// </summary>
public void RebuildAll()
{
Teardown();
EnsureInitialized();
}
/// <summary>
/// 调试开关:临时显示/隐藏生成节点。<b>只改可见位,不动保存位</b>——
/// 关掉隐藏是为了让人能选中它们看参数,绝不是让它们被存进资产或场景。
///
/// <para>遍历的是"chart 的整条生成子树":池根挂在 chart 自己下面(不在 <c>[XChartTools]</c> 里),
/// 件又在工具的宿主之下(<c>[XChartTools]/工具/GeneratedTexts/TextSlot_n</c>),
/// 所以<b>按名字认根 + 递归到底</b>,不按层数猜——按层数猜就是"按了没反应"。</para>
/// </summary>
public void SetGeneratedVisible(bool visible)
{
if (Application.isPlaying) return; // 运行期是 HideAndDontSave,没有临时显示这件事
if (ToolsRoot != null) ApplyHideFlagsDeep(ToolsRoot.gameObject, visible);
var poolRoot = transform.Find(XChartTextSlotFactory.PoolRootName);
if (poolRoot != null) ApplyHideFlagsDeep(poolRoot.gameObject, visible);
}
private static void ApplyHideFlagsDeep(GameObject target, bool visible)
{
ApplyHideFlags(target, visible);
var node = target.transform;
for (int i = 0; i < node.childCount; i++)
ApplyHideFlagsDeep(node.GetChild(i).gameObject, visible);
}
/// <summary>
/// 面板按钮的入口:同时把状态写回 <c>m_ShowDebug</c>,免得按钮和字段各说各话
/// (两个地方记同一件事,总有一个会先烂)。
/// </summary>
public void SetDebugVisibility(bool visible)
{
m_ShowDebug = visible;
SetGeneratedVisible(visible);
}
/// <summary>
/// 两个调试开关的实际效果。这两个字段原先<b>没有任何读者</b>——"开了没反应"就是这么来的:
/// <c>m_ShowDebug</c> 接到"显示生成节点",<c>m_HideAllTools</c> 接到"隐藏所有工具"。
/// 每次初始化与每次 Inspector 改值都过一遍,重建后也不会掉。
/// </summary>
public void ApplyDebugVerbs()
{
SetGeneratedVisible(m_ShowDebug);
if (ToolManager == null) return;
var tools = ToolManager.Tools;
for (int i = 0; i < tools.Count; i++)
{
if (tools[i] != null) tools[i].SetVisible(!m_HideAllTools);
}
}
private static void ApplyHideFlags(GameObject target, bool visible)
{
if (Application.isPlaying) return; // 运行期是 HideAndDontSave,没有临时显示这件事
target.hideFlags = visible
? HideFlags.DontSaveInEditor
: HideFlags.DontSaveInEditor | HideFlags.HideInHierarchy;
}
// ── 工具管理(公开 API) ──────────────────────────────────
public T AddTool<T>(string toolName, int orderIndex = 0)
where T : XChartToolBase, new()
{
if (ToolManager == null) Initialize();
EnsureInitialized();
return ToolManager.AddTool<T>(toolName, orderIndex);
}
@@ -103,30 +458,202 @@ namespace XericUI.XChart
public void RemoveAllTools() => ToolManager?.RemoveAllTools();
// ── 清理 ──────────────────────────────────────────────────
// ── 元素(配置路径) ──────────────────────────────────────
/// <summary>元素配置表([SerializeReference],Inspector 里逐项展开自己类型的字段)</summary>
public IReadOnlyList<XChartElementConfig> Elements => m_Elements;
/// <summary>当前已加载的元素实例(与配置表同序、只含启用的项)</summary>
public IReadOnlyList<XChartToolBase> ElementTools => m_ElementTools;
private readonly List<XChartToolBase> m_ElementTools = new List<XChartToolBase>();
/// <summary>
/// 元素在表里的登记名:默认名按类型给,同类加第二个就会撞(现场拍到 <c>Axis, Axis</c>),
/// 而按名字配对就会把第二条轴的字段灌进第一条。所以同名按<b>表内出现次序</b>补序号——
/// 它只由位置决定,不入库,重建后同名元素还是同一个名字。
/// </summary>
public string ElementNameFor(int index)
{
if (index < 0 || index >= m_Elements.Count) return string.Empty;
var config = m_Elements[index];
if (config == null) return string.Empty;
string baseName = config.ElementName;
for (int earlier = 0; earlier < index; earlier++)
{
var other = m_Elements[earlier];
if (other != null && other.ElementName == baseName) return baseName + " " + (index + 1);
}
return baseName;
}
/// <summary>
/// 按配置表重建全部元素:清掉旧的 → 逐个 CreateTool/AddTool/ApplyTo。
/// 轴线、网格背景、数据图元都走这一条,图表不需要为每个元素各写一段 Sync。
/// </summary>
public void RebuildElements()
{
// 管理器不在就走完整初始化(它内部会灌一遍元素表),别在这里再建第二次
if (ToolManager == null)
{
EnsureInitialized();
return;
}
for (int i = 0; i < m_ElementTools.Count; i++)
{
if (m_ElementTools[i] != null) ToolManager.RemoveTool(m_ElementTools[i]);
}
m_ElementTools.Clear();
for (int i = 0; i < m_Elements.Count; i++)
{
var config = m_Elements[i];
if (config == null || !config.Enabled) continue;
var tool = config.CreateTool();
if (tool == null) continue;
ToolManager.AddTool(tool, ElementNameFor(i), config.OrderIndex, config.DrawOrder);
config.ApplyTo(tool);
m_ElementTools.Add(tool);
}
// "图里一定有一个空间工具"这条不变量要在**每次重建后**都成立,不只是初始化那一次:
// 面板上把「空间(基变换)」这一条删掉或停用是合法动作,而投影权威一没,线框/网格/散点
// 会一起不画(现象是"整张图突然空了")。补一个默认的就是为了让"删掉它"不等于"图没了"。
EnsureSpace();
OnElementsRebuilt();
}
/// <summary>
/// 配置里改了字段:不重建实例,只把配置重灌进已存在的元素(按名字配对)。
/// 配对不上(结构变了)就退回整体重建。
/// </summary>
public void ReapplyElements()
{
// 管理器不在就直接重新初始化,不要静默 return——静默 return 正是
// "改了字段什么反应都没有"的那种死法
if (ToolManager == null)
{
EnsureInitialized();
return;
}
for (int i = 0; i < m_Elements.Count; i++)
{
var config = m_Elements[i];
if (config == null || !config.Enabled) continue;
var tool = ToolManager.FindTool<XChartToolBase>(ElementNameFor(i));
if (tool == null)
{
RebuildElements();
return;
}
config.ApplyTo(tool);
}
}
/// <summary>元素重建完成后的钩子(派生类可在此做自己的收尾)</summary>
protected virtual void OnElementsRebuilt() { }
// ══ 阶段五:销毁 ════════════════════════════════════════
/// <summary>
/// 整条层级正在被 Unity 递归销毁——<b>Undo 删 GameObject 走的也是这条路</b>。
///
/// <para>这个窗口里对<b>子孙</b>调 <c>DestroyImmediate</c> 会撞进 Unity 自己的销毁遍历,
/// 实测 SIGSEGV(2026-10-24,他的 Editor.log):栈是
/// <c>Object_CUSTOM_DestroyImmediate ← XChartToolBase.Dispose ← XChartToolsManager.RemoveAllTools
/// ← Teardown ← OnDestroy ← GameObject::WillDestroyGameObject/PreDestroyRecursive
/// ← ObjectUndo::ApplyUndo</c>;崩溃前 Unity 还连报两次
/// <c>Child GameObject 'LineChunk0' was not registered into undo system and became dangling</c>。</para>
///
/// <para>生成物(工具根 / 池根 / 分块子节点)全是本对象的子孙 ⇒ 跟着一起没。
/// 所以这窗口只做记账(清列表、丢引用、从池里注销),一个 <c>Destroy*</c> 都不调。</para>
/// </summary>
private bool m_HierarchyBeingDestroyed;
protected virtual void OnDestroy()
{
m_HierarchyBeingDestroyed = true;
Teardown();
}
private void Teardown()
{
m_DataModel?.DisposeRuntime();
m_ElementTools.Clear();
if (ToolManager != null)
{
ToolManager.Dispose();
if (m_HierarchyBeingDestroyed)
{
ToolManager.ReleaseBookkeeping();
}
else
{
// 池根挂在 chart 自己下面,[XChartTools] 的清理带不走它:不先拆池,
// 每回收重建一次就在场景里漏一个 GeneratedTextPool
ToolManager.DestroyTextPool();
ToolManager.Dispose();
}
ToolManager = null;
}
if (ToolsRoot != null)
{
if (Application.isPlaying)
Destroy(ToolsRoot.gameObject);
else
DestroyImmediate(ToolsRoot.gameObject);
if (!m_HierarchyBeingDestroyed)
{
if (Application.isPlaying)
Destroy(ToolsRoot.gameObject);
else
DestroyImmediate(ToolsRoot.gameObject);
}
ToolsRoot = null;
}
m_IsInitialized = false;
// "回收干净"是判据不是意图:池根要现拆现验,别留一个看不见的节点自称已清。
// 销毁窗口里这条不适用——整棵子树都在被销毁,没有"漏一个"可言。
if (!m_HierarchyBeingDestroyed)
{
var leftoverPoolRoot = transform.Find(XChartTextSlotFactory.PoolRootName);
if (leftoverPoolRoot != null)
{
if (Application.isPlaying) Destroy(leftoverPoolRoot.gameObject);
else DestroyImmediate(leftoverPoolRoot.gameObject);
}
}
m_ConsumedDataVersion = -1;
m_RefreshRequested = true;
}
private void OnValidate()
// ── 编辑器 ────────────────────────────────────────────────
/// <summary>
/// Inspector 里的值变了。派生类要扩展它请写 <c>protected override void OnValidate()</c>
/// 并记得 <c>base.OnValidate();</c>——Unity 按名字只调<b>最派生</b>的那一个,
/// 在派生类里另写一个 <c>private void OnValidate()</c> 会把基类这份<b>遮掉</b>,
/// 于是"改字段不刷新"(先前 XPseudo3DScatterChart 就是这么把自己的刷新弄丢的)。
/// </summary>
protected virtual void OnValidate()
{
// 由派生类按需扩展
#if UNITY_EDITOR
// Inspector 里改了配置就重灌元素,再无条件刷一次(这样编辑期就能看到实际效果)。
// 延迟一拍:避开反序列化中途(工具还没建),也避免拖数值框时同步重建。
if (!isActiveAndEnabled) return;
UnityEditor.EditorApplication.delayCall += () =>
{
if (this == null || !isActiveAndEnabled) return;
ApplyDebugVerbs();
ReapplyElements();
ForceRefresh();
};
#endif
OnChartValidated();
}
/// <summary>编辑器里参数变化后的钩子(给派生类把自己那些非元素旋钮推进工具用)</summary>
protected virtual void OnChartValidated() { }
}
}
}