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
+239
View File
@@ -0,0 +1,239 @@
#if UNITY_EDITOR
using System;
using System.IO;
using System.Text;
using UnityEditor;
using UnityEngine;
using XericUI.XChart.Pools;
using XericUI.XChart.Space;
namespace XericUI.XChart
{
/// <summary>
/// 编辑器期的自述报表(规范 §6 的调试入口,整份文件包在 <c>#if UNITY_EDITOR</c> 里,
/// 运行时构建看不到它——作用域纪律见 §3)。
///
/// <para>开关是工程根下一个文件 <c>xchart.dump.on</c>:它存在时每 0.4 秒把这张图的关键内部状态
/// 追加进 <c>xchart.dump.txt</c>;删掉就不再写。LateUpdate 里只按节流做一次 <c>File.Exists</c>,
/// 不在绘制路径上反复做 IO。</para>
///
/// <para>为什么走文件而不是 Console:面板(元素行)与渲染(图形)同时出问题时,需要同一个时刻
/// 两边的读数,而 Console 会滚掉、也看不见"这一帧到底有没有算出范围"。</para>
/// </summary>
public abstract partial class XChartBase
{
private const float k_DumpInterval = 0.4f;
private const int k_DumpCap = 300;
/// <summary>开关文件名(面板的"自述报表 开/关"按钮和这边必须同一份口径)</summary>
public const string DumpFlagName = "xchart.dump.on";
/// <summary>输出文件名(追加)</summary>
public const string DumpFileName = "xchart.dump.txt";
/// <summary>工程根(报表开关与输出都放这里);拿不到就返回 null。</summary>
public static string ProjectRoot()
{
try
{
return Directory.GetParent(Application.dataPath).FullName;
}
catch (Exception)
{
return null;
}
}
private float m_NextDumpCheck;
private int m_DumpCount;
private void EditorDumpTick()
{
if (Time.realtimeSinceStartup < m_NextDumpCheck) return;
m_NextDumpCheck = Time.realtimeSinceStartup + k_DumpInterval;
var root = ProjectRoot();
if (root == null) return;
var flag = Path.Combine(root, DumpFlagName);
if (!File.Exists(flag)) return;
if (m_DumpCount >= k_DumpCap) return;
m_DumpCount++;
try
{
var sb = new StringBuilder();
BuildDump(sb);
File.AppendAllText(Path.Combine(root, DumpFileName), sb.ToString());
}
catch (Exception error)
{
// 报表自己炸了就说清楚,并停止再来(别每帧抛)
m_NextDumpCheck = float.MaxValue;
Debug.LogWarning("XChart 调试报表写入失败,已停止:" + error.Message);
}
}
private void BuildDump(StringBuilder sb)
{
sb.Append("==== dump #").Append(m_DumpCount)
.Append(" ").Append(DateTime.Now.ToString("HH:mm:ss.fff"))
.Append(" chart=\"").Append(name).Append("\" id=").Append(GetInstanceID())
.Append(" type=").Append(GetType().Name).Append('\n');
sb.Append(" chart: activeSelf=").Append(gameObject.activeSelf)
.Append(" activeInHierarchy=").Append(gameObject.activeInHierarchy)
.Append(" hideFlags=").Append(hideFlags)
.Append(" enabled=").Append(enabled).Append('\n');
var rect = transform as RectTransform;
if (rect == null) sb.Append(" rect: NOT-A-RECTTRANSFORM\n");
else
{
sb.Append(" rect: size=").Append(rect.rect.width.ToString("0.#")).Append('x')
.Append(rect.rect.height.ToString("0.#"))
.Append(" anchored=").Append(rect.anchoredPosition.x.ToString("0.#")).Append(',')
.Append(rect.anchoredPosition.y.ToString("0.#"))
.Append(" lossy=").Append(rect.lossyScale.x.ToString("0.###")).Append('\n');
sb.Append(" ancestry: ").Append(Chain(rect)).Append('\n');
}
var canvas = GetComponentInParent<Canvas>();
if (canvas == null) sb.Append(" canvas: NO-CANVAS(这条子树里任何 Graphic 都不可能出图)\n");
else
{
sb.Append(" canvas: \"").Append(canvas.name).Append("\" mode=").Append(canvas.renderMode)
.Append(" scale=").Append(canvas.scaleFactor.ToString("0.###"))
.Append(" rootChildCount=").Append(canvas.transform.childCount).Append('\n');
}
var tools = ToolsRoot;
if (tools == null) sb.Append(" toolsRoot: NULL\n");
else
{
var toolsRect = tools as RectTransform;
sb.Append(" toolsRoot: children=").Append(tools.childCount)
.Append(" active=").Append(tools.gameObject.activeSelf)
.Append(" sibling=").Append(toolsRect != null ? toolsRect.GetSiblingIndex() : -1)
.Append(" hideFlags=").Append(tools.gameObject.hideFlags).Append('\n');
}
var space = Space;
if (space == null) sb.Append(" space: NULL(工具会全部判空跳过,画面就是空的)\n");
else
{
var offset = space.Offset;
sb.Append(" space: version=").Append(space.ProjectionVersion)
.Append(" halfEdge=").Append(space.HalfEdge.ToString("0.###"))
.Append(" sizeMode=").Append(space.SizeMode)
.Append(" cubeToPixel=").Append(space.CubeToPixel.ToString("0.###"))
.Append(" offset=").Append(offset.x.ToString("0.#")).Append(',').Append(offset.y.ToString("0.#"))
.Append(" euler=").Append(space.Rotation.eulerAngles.x.ToString("0.#")).Append(',')
.Append(space.Rotation.eulerAngles.y.ToString("0.#")).Append(',')
.Append(space.Rotation.eulerAngles.z.ToString("0.#")).Append('\n');
}
sb.Append(" elements: count=").Append(Elements.Count).Append('\n');
for (int i = 0; i < Elements.Count; i++)
{
var config = Elements[i];
if (config == null)
{
sb.Append(" [").Append(i).Append("] NULL-CONFIG\n");
continue;
}
sb.Append(" [").Append(i).Append("] ").Append(config.GetType().Name)
.Append(" enabled=").Append(config.Enabled)
.Append(" name=\"").Append(config.ElementName).Append("\"")
.Append(" order=").Append(config.OrderIndex).Append('\n');
}
var pool = ToolManager != null ? ToolManager.TextPool : null;
if (pool == null) sb.Append(" pool: NULL(申请会被静默丢掉,标签永远不出现)\n");
else
{
sb.Append(" pool: owners=").Append(pool.OwnerCount)
.Append(" dispatches=").Append(pool.DispatchCount)
.Append(" acquire=").Append(pool.AcquireCount)
.Append(" reuse=").Append(pool.ReuseCount)
.Append(" release=").Append(pool.ReleaseCount)
.Append(" dropped=").Append(pool.DroppedCount)
.Append(" idle=").Append(pool.IsIdle).Append('\n');
}
if (ToolManager == null) { sb.Append(" tools: manager NULL\n"); return; }
// 池根是"回收干净"的判据对象:RebuildAll 之后它要么不在,要么只剩空闲件,不该越重建越多
var poolRoot = transform.Find(XChartTextSlotFactory.PoolRootName);
sb.Append(" poolRoot: ").Append(poolRoot == null ? "absent"
: "present children=" + poolRoot.childCount + " active=" + poolRoot.gameObject.activeSelf).Append('\n');
int poolRoots = 0;
for (int i = 0; i < transform.childCount; i++)
if (transform.GetChild(i).name == XChartTextSlotFactory.PoolRootName) poolRoots++;
if (poolRoots > 1) sb.Append(" POOL-ROOTS-LEAKED: ").Append(poolRoots).Append(" 个池根\n");
// 显隐开关的判据读数:隐藏位是"要不要在 Hierarchy 里露脸",与保存位是两件事,
// 所以这里既印隐藏位分布,也印有没有人把 DontSave 弄丢(那才会写进资产)
int hiddenNodes = 0, visibleNodes = 0, noDontSave = 0;
CountHideFlags(ToolsRoot != null ? ToolsRoot.gameObject : null, ref hiddenNodes, ref visibleNodes, ref noDontSave);
CountHideFlags(poolRoot != null ? poolRoot.gameObject : null, ref hiddenNodes, ref visibleNodes, ref noDontSave);
sb.Append(" hideFlags: hidden=").Append(hiddenNodes)
.Append(" shown=").Append(visibleNodes)
.Append(" missing-DontSave=").Append(noDontSave).Append('\n');
sb.Append(" tools: count=").Append(ToolManager.ToolCount).Append('\n');
var list = ToolManager.Tools;
for (int i = 0; i < list.Count; i++)
{
var tool = list[i];
if (tool == null) { sb.Append(" [").Append(i).Append("] NULL-TOOL\n"); continue; }
sb.Append(" [").Append(i).Append("] \"").Append(tool.ToolName).Append("\" ");
tool.AppendDebugLine(sb);
sb.Append('\n');
var root = tool.RootTransform;
if (root == null) sb.Append(" rootRect: NULL\n");
else
{
sb.Append(" rootRect: size=").Append(root.rect.width.ToString("0.#")).Append('x')
.Append(root.rect.height.ToString("0.#"))
.Append(" sibling=").Append(root.GetSiblingIndex())
.Append(" parent=\"").Append(root.parent != null ? root.parent.name : "NULL").Append("\"")
.Append(" children=").Append(root.childCount).Append('\n');
}
string failure = ToolManager.LastFailureOf(tool.ToolName);
if (!string.IsNullOrEmpty(failure)) sb.Append(" LAST-FAILURE: ").Append(failure).Append('\n');
}
var dispatchFailure = ToolManager.LastDispatchFailure;
if (!string.IsNullOrEmpty(dispatchFailure)) sb.Append(" pool-dispatch-failure: ").Append(dispatchFailure).Append('\n');
}
private static void CountHideFlags(GameObject node, ref int hidden, ref int shown, ref int noDontSave)
{
if (node == null) return;
if ((node.hideFlags & HideFlags.HideInHierarchy) != 0) hidden++;
else shown++;
if ((node.hideFlags & HideFlags.DontSaveInEditor) == 0) noDontSave++;
var t = node.transform;
for (int i = 0; i < t.childCount; i++)
CountHideFlags(t.GetChild(i).gameObject, ref hidden, ref shown, ref noDontSave);
}
private static string Chain(RectTransform node)
{
var sb = new StringBuilder();
var current = node;
for (int depth = 0; current != null && depth < 6; depth++)
{
if (depth > 0) sb.Append(" < ");
sb.Append(current.name);
if (current.GetComponent<Canvas>() != null) { sb.Append("[CANVAS]"); break; }
current = current.parent as RectTransform;
}
return sb.ToString();
}
}
}
#endif