Files
XericUIActionVessel/Runtime/XChart/XChartBase.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

659 lines
31 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;
using XericUI.Core;
using XericUI.XChart.Pools;
using XericUI.XChart.Space;
namespace XericUI.XChart
{
/// <summary>
/// 图表主行为组件基类。
///
/// <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(XericRegistrationPaths.Chart + "/Chart Base")]
[ExecuteAlways]
public abstract partial class XChartBase : MonoBehaviour
{
[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;
/// <summary>
/// 数据访问中转口:元素(网格背景 / 轴线 / 数据图元)只认这个接口,
/// 不直接摸记录数组。默认就是 <see cref="XChartDataModel"/> 的直通实现。
/// </summary>
public IXChartDataSource DataSource => m_DataModel;
private long m_ConsumedDataVersion = -1;
private bool m_RefreshRequested = true;
// ── hideFlags ─────────────────────────────────────────────
/// <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() => EnsureInitialized();
protected virtual void OnEnable() => EnsureInitialized();
/// <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 (ToolManager != null) return;
BuildToolsRoot();
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)
{
var toolsObj = new GameObject("[XChartTools]", typeof(RectTransform));
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 = CurrentFlags;
ToolsRoot = toolsRoot;
PurgeLeftoverPoolRoots();
ToolManager = new XChartToolsManager
{
ToolsRoot = ToolsRoot,
};
// 上下文的委托读的是这个字段:重建后旧上下文不会拽着旧空间不放
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 (ToolManager == null) return;
// 工具在这里算出"这帧要几个标签"并申请(只置脏)
ToolManager.UpdateAll();
if (NeedsRefresh()) Refresh();
}
protected virtual void LateUpdate()
{
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()
{
EnsureInitialized();
return ToolManager.AddTool<T>(toolName, orderIndex);
}
public bool RemoveTool(string toolName)
{
if (ToolManager == null) return false;
return ToolManager.RemoveToolByName(toolName);
}
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)
{
if (m_HierarchyBeingDestroyed)
{
ToolManager.ReleaseBookkeeping();
}
else
{
// 池根挂在 chart 自己下面,[XChartTools] 的清理带不走它:不先拆池,
// 每回收重建一次就在场景里漏一个 GeneratedTextPool
ToolManager.DestroyTextPool();
ToolManager.Dispose();
}
ToolManager = null;
}
if (ToolsRoot != null)
{
if (!m_HierarchyBeingDestroyed)
{
if (Application.isPlaying)
Destroy(ToolsRoot.gameObject);
else
DestroyImmediate(ToolsRoot.gameObject);
}
ToolsRoot = null;
}
// "回收干净"是判据不是意图:池根要现拆现验,别留一个看不见的节点自称已清。
// 销毁窗口里这条不适用——整棵子树都在被销毁,没有"漏一个"可言。
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;
}
// ── 编辑器 ────────────────────────────────────────────────
/// <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() { }
}
}