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:
@@ -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
|
||||
Reference in New Issue
Block a user