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
+122 -4
View File
@@ -1,4 +1,6 @@
using System;
using System.Collections.Generic;
using TMPro;
using UnityEngine;
namespace XericUI.XChart
@@ -20,7 +22,7 @@ namespace XericUI.XChart
{
// ── 编辑器/运行时统一 hideFlags ────────────────────────────
private const HideFlags k_EditorFlags = HideFlags.DontSaveInEditor;
private const HideFlags k_EditorFlags = HideFlags.DontSaveInEditor | HideFlags.HideInHierarchy;
private const HideFlags k_PlayFlags = HideFlags.HideAndDontSave;
protected static HideFlags CurrentFlags =>
@@ -29,13 +31,44 @@ namespace XericUI.XChart
// ── 基础属性 ──────────────────────────────────────────────
protected XChartToolsManager Manager { get; private set; }
/// <summary>
/// 注册序(越小越先建、越先更新)。<b>它不是绘制序</b>——绘制序看 <see cref="DrawOrder"/>:
/// 以前一个值同时管两件事,于是"想让轴先算但后画"根本表达不出来(§11.4)。
/// </summary>
public int OrderIndex { get; set; }
/// <summary>
/// 绘制序(画家序):小者先画、大者盖在上面。只在<b>同一分组内</b>比较——
/// 定义/背景/前景三组之间永远按分组先后画(否则前景的散点会被背景的网格盖住)。
/// </summary>
public int DrawOrder { get; set; }
/// <summary>
/// 生命周期分组:<b>类型标记</b>(由工具自己声明),不入序列化。
/// 定义几何/范围/插槽的工具报 <see cref="XChartToolCategory.Definition"/>,它们先跑,
/// 别的工具当帧就能取到插槽(§11.4)。
/// </summary>
public virtual XChartToolCategory Category => XChartToolCategory.Foreground;
public GameObject RootObject { get; private set; }
public RectTransform RootTransform { get; private set; }
public string ToolName { get; private set; }
public bool IsEnabled { get; set; } = true;
public bool IsInitialized { get; protected set; }
/// <summary>
/// 渲染上下文(chart 提供)。空间、数据、显示范围都只从这里拿:
/// <c>Context?.Space</c> / <c>Context?.Data</c> / <c>Context.TryResolveDomain(...)</c>。
///
/// <para>可能为 null(初始化早期),工具必须判空跳过这一帧——不去找邻居、也不拿旧引用凑数。
/// 规范见 <c>Documentation/XChart-RenderFramework.md</c> §2。</para>
/// </summary>
protected IXChartRenderContext Context => Manager?.Context;
/// <summary>数据中转口的简写(<c>Context.Data</c>)。可能为 null,用之前判。</summary>
protected IXChartDataSource Data => Manager?.Context?.Data;
// ── 构造 ──────────────────────────────────────────────────
protected XChartToolBase() { }
@@ -64,17 +97,81 @@ namespace XericUI.XChart
public virtual void OnRender() { }
protected virtual void OnDispose() { }
public void Dispose()
public void Dispose() => Dispose(true);
/// <summary>
/// <paramref name="destroyRoot"/>=false:整条层级正在被 Unity 销毁(Undo 删 GameObject 也走这条路),
/// 自己的根会跟着一起没——而那个窗口里调 DestroyImmediate 会撞进 Unity 的销毁遍历
/// (实测 SIGSEGV,见 <c>XChartBase.Teardown</c>)。该记的账照记,只是不拆对象。
/// </summary>
public void Dispose(bool destroyRoot)
{
// 先从池里注销,再拆自己的根:顺序反了就会把随根一起销毁的标签当成"可归还"塞回空闲表
Manager?.ForgetTextOwner(this);
OnDispose();
if (RootObject != null)
if (destroyRoot && RootObject != null)
{
UnityEngine.Object.DestroyImmediate(RootObject);
RootObject = null;
}
RootObject = null;
IsInitialized = false;
}
// ── 文本槽位(申请与读取;发落在 chart 的池调度里)────────────
private static readonly IReadOnlyList<TMP_Text> k_NoTexts = new TMP_Text[0];
private RectTransform m_TextHost;
private int m_RequestedTexts;
/// <summary>
/// 标签的宿主节点(第一次申请时惰性建,挂在工具自己的根下)。
/// 工具根随立方体走,所以标签天然跟着转。
/// </summary>
protected RectTransform TextHost => m_TextHost ?? (m_TextHost = CreateStretchChild("GeneratedTexts"));
/// <summary>
/// 已发落的文本槽位。<b>长度可以短于申请数</b>(申请到发落之间隔一次调度),
/// 所以取值一律 <c>i &lt; Texts.Count</c> 并跳过 null——不 NRE,也不静默画错。
/// 每次现问池要:池换回列表时旧引用就作废了,缓存它等于读一份没人维护的副本。
/// </summary>
protected IReadOnlyList<TMP_Text> Texts
{
get
{
var pool = Manager != null ? Manager.TextPool : null;
return pool != null ? pool.SlotsOf(this) : k_NoTexts;
}
}
/// <summary>还欠着件(手上的数量不等于申请数量)</summary>
protected bool TextSlotsPending
{
get
{
var pool = Manager != null ? Manager.TextPool : null;
return pool == null ? m_RequestedTexts > 0 : pool.HeldCount(this) != m_RequestedTexts;
}
}
/// <summary>本工具申请到的数量(报表用:want 与 have 的差就是欠的件)</summary>
protected int RequestedTextCount => m_RequestedTexts;
/// <summary>
/// 申请<b>一批</b>文本槽位:<paramref name="count"/> 是总数而不是增量,而且只登记需求(置脏),
/// 不当场给件(规范 §5.1)。没变且已经发落到位时直接跳过,不重复打扰池。
/// </summary>
protected void RequestTextSlots(int count)
{
if (count < 0) count = 0;
// 宿主一旦建起来就一直带着:否则 count 归 0 时池会读到 host==null,
// 把手上的件当"无效"丢弃而不是回收归还。
var host = count > 0 ? TextHost : m_TextHost;
if (count == m_RequestedTexts && ReferenceEquals(host, m_TextHost) && !TextSlotsPending) return;
m_RequestedTexts = count;
Manager?.RequestTextSlots(this, host, count);
}
// ── 子组件管理 ────────────────────────────────────────────
protected RectTransform CreateChild(string childName)
@@ -110,5 +207,26 @@ namespace XericUI.XChart
{
if (RootObject != null) RootObject.SetActive(visible);
}
#if UNITY_EDITOR
/// <summary>
/// 调试报表里本工具的一行:只写"这一帧到底有没有画、没画的话卡在哪"的关键状态(规范 §6)。
/// 派生类接上去补自己的判据;基类这份只报通用的可见性。
/// </summary>
internal virtual void AppendDebugLine(System.Text.StringBuilder sb)
{
sb.Append("enabled=").Append(IsEnabled)
.Append(" init=").Append(IsInitialized)
.Append(" root=");
if (RootObject == null) sb.Append("NULL");
else sb.Append(RootObject.activeSelf ? "active" : "inactive");
// 顺序的三个读数必须分开印:"谁先算"(分组+注册序)、"谁盖谁"(分组+绘制序+兄弟序)
sb.Append(" category=").Append(Category)
.Append(" reg=").Append(OrderIndex)
.Append(" draw=").Append(DrawOrder)
.Append(" sibling=").Append(RootTransform != null ? RootTransform.GetSiblingIndex().ToString() : "NULL");
}
#endif
}
}