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

240 lines
11 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.
#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