此前整个 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/,未入本仓库。)
90 lines
4.2 KiB
C#
90 lines
4.2 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
|
||
namespace XericUI.XChart.Editor
|
||
{
|
||
/// <summary>
|
||
/// 折叠层级的判定:<b>纯数据,不碰 UIElements</b>。
|
||
///
|
||
/// <para>为什么单独一支:面板要"互斥标记只打在最深那一层",而"谁是谁的父级"是装配完才定的
|
||
/// (<c>GroupFor</c> 的同名合并、跨父级不合并都会改挂接位置)。这段规则要是散在控件代码里,
|
||
/// 就只能靠眼睛验收;抽出来之后它能离线跑(引擎的 mono 造不出真 <c>VisualElement</c>——
|
||
/// 它的静态构造要撞 <c>UIElementsRuntimeUtilityNative</c>,所以这里对树一无所知,
|
||
/// 只接两条注入的访问器:<c>parentOf</c> 往上一格、<c>keyOf</c> 读一个格子带的 key)。</para>
|
||
///
|
||
/// <para><b>离线能看见的与看不见的</b>:能看见父级识别、深度、叶子判定这三步算术;
|
||
/// 看不见真控件的 <c>parent</c>/<c>userData</c> 到底填没填——那一层由面板自己在报表里印
|
||
/// <c>groups/deepest/depth</c> 三个读数作证(数错了会在 <c>HIERARCHY-NO-PARENT</c> 这类
|
||
/// 判决行里点名,不是"没打印所以没事")。</para>
|
||
/// </summary>
|
||
public static class XChartPanelHierarchy
|
||
{
|
||
/// <summary>一块折叠板。Box 是它的盒子根(key 钉在盒子根上,不是钉在标题上)。</summary>
|
||
public sealed class Node<T> where T : class
|
||
{
|
||
public string Key;
|
||
public T Box;
|
||
|
||
public string ParentKey;
|
||
public int Depth;
|
||
public bool IsLeaf;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 就地算出每个节点的 <see cref="Node{T}.ParentKey"/> / <see cref="Node{T}.Depth"/> /
|
||
/// <see cref="Node{T}.IsLeaf"/>。
|
||
///
|
||
/// <para><b>父级 = 沿 parent 往上走,第一个 key 在本轮清单里的格子</b>。中途那些没有 key 的
|
||
/// 容器(Body、装字段的临时壳)直接跳过——所以深度按"折叠块"数,不按控件层数。</para>
|
||
///
|
||
/// <para><b>最深的一层 = 不是任何块的父级的那些块</b>(叶子)。注意这不是"全局最大深度":
|
||
/// 一条分支只有一层(基础 → 调试),另一条有两条(基础 → 数据 → 维度 0),两边的叶子都算
|
||
/// "它那条分支里最深的一层",都要打标记;按全局最大深度挑就会把"调试"漏成自由块。</para>
|
||
/// </summary>
|
||
public static void Compute<T>(IList<Node<T>> nodes, Func<T, T> parentOf, Func<T, string> keyOf)
|
||
where T : class
|
||
{
|
||
var byKey = new Dictionary<string, Node<T>>();
|
||
foreach (var node in nodes) byKey[node.Key] = node;
|
||
|
||
var parents = new HashSet<string>();
|
||
foreach (var node in nodes)
|
||
{
|
||
node.ParentKey = NearestAncestorKey(node.Box, parentOf, keyOf, byKey);
|
||
if (node.ParentKey != null) parents.Add(node.ParentKey);
|
||
}
|
||
|
||
foreach (var node in nodes)
|
||
{
|
||
node.Depth = DepthOf(node, byKey);
|
||
node.IsLeaf = !parents.Contains(node.Key);
|
||
}
|
||
}
|
||
|
||
private static string NearestAncestorKey<T>(T box, Func<T, T> parentOf,
|
||
Func<T, string> keyOf, Dictionary<string, Node<T>> byKey) where T : class
|
||
{
|
||
for (T node = box == null ? null : parentOf(box); node != null; node = parentOf(node))
|
||
{
|
||
string key = keyOf(node);
|
||
if (key != null && byKey.ContainsKey(key)) return key;
|
||
}
|
||
return null;
|
||
}
|
||
|
||
private static int DepthOf<T>(Node<T> node, Dictionary<string, Node<T>> byKey) where T : class
|
||
{
|
||
int depth = 0;
|
||
string key = node.ParentKey;
|
||
Node<T> parent;
|
||
// 父级先全部算完才走到这里,所以沿 ParentKey 往上爬是有限步(挂接是棵树,不会绕圈)
|
||
while (key != null && byKey.TryGetValue(key, out parent))
|
||
{
|
||
depth++;
|
||
key = parent.ParentKey;
|
||
}
|
||
return depth;
|
||
}
|
||
}
|
||
}
|