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
File diff suppressed because it is too large Load Diff
+56 -13
View File
@@ -1,7 +1,10 @@
using UnityEditor;
using UnityEditor.SceneManagement;
using UnityEngine;
using UnityEngine.UI;
using XericUI.Core;
using XericUI.XChart.Line;
using XericUI.XChart.Products;
using XericUI.XChart.Pseudo3D;
using XericUI.XChart.Radar;
@@ -9,33 +12,73 @@ namespace XericUI.XChart.Editor
{
internal static class XChartCreateMenu
{
[MenuItem("GameObject/Xeric/XChart/Line Chart", false, 10)]
[MenuItem(XericRegistrationPaths.ChartCreate + "/Line Chart", false, 10)]
private static void CreateLineChart() => Create<XLineChart>("XLineChart");
[MenuItem("GameObject/Xeric/XChart/Radar Chart", false, 11)]
[MenuItem(XericRegistrationPaths.ChartCreate + "/Radar Chart", false, 11)]
private static void CreateRadarChart() => Create<XRadarChart>("XRadarChart");
[MenuItem("GameObject/Xeric/XChart/Pseudo3D Scatter Chart", false, 12)]
[MenuItem(XericRegistrationPaths.ChartCreate + "/Pseudo3D Scatter Chart", false, 12)]
private static void CreateScatterChart() => Create<XPseudo3DScatterChart>("XPseudo3DScatterChart");
[MenuItem(XericRegistrationPaths.ChartCreate + "/网格渲染预览图", false, 13)]
private static void CreateMeshPreview() => Create<XMeshPreviewChart>("XMeshPreviewChart");
/// <summary>
/// 建一个图表对象。
///
/// <para><b>不替用户决定宿主结构</b>:只在当前位置放不下时给出警告,绝不自动创建 Canvas——
/// 自动建出来的 Canvas 会多出一个用户没要求的根物体,预制体里尤其碍事。
/// 没有 Canvas 祖先时的现象是"什么都画不出来",所以 <see cref="ValidateRenderingContext"/>
/// 必须把这句话说出口。</para>
///
/// <para><b>预制体编辑模式要特殊处理</b>:此时对象必须挂进预制体根,否则它建在了预制体外面,
/// 退出预制体时会被直接丢掉("组件完全不存在"就是这么来的)。</para>
/// </summary>
private static void Create<T>(string name) where T : Component
{
Canvas canvas = Selection.activeTransform == null ? null : Selection.activeTransform.GetComponentInParent<Canvas>();
if (canvas == null)
{
var canvasObject = new GameObject("Canvas", typeof(RectTransform), typeof(Canvas), typeof(CanvasScaler), typeof(GraphicRaycaster));
canvas = canvasObject.GetComponent<Canvas>();
canvas.renderMode = RenderMode.ScreenSpaceOverlay;
Undo.RegisterCreatedObjectUndo(canvasObject, "Create Canvas");
}
PrefabStage stage = PrefabStageUtility.GetCurrentPrefabStage();
Transform parent = stage != null
? stage.prefabContentsRoot.transform
: FindParentForScene();
var chart = new GameObject(name, typeof(RectTransform), typeof(T));
var rect = chart.GetComponent<RectTransform>();
rect.SetParent(canvas.transform, false);
if (parent != null) rect.SetParent(parent, false);
rect.anchorMin = rect.anchorMax = new Vector2(0.5f, 0.5f);
rect.pivot = new Vector2(0.5f, 0.5f);
rect.sizeDelta = new Vector2(600f, 360f);
Undo.RegisterCreatedObjectUndo(chart, "Create XChart");
Selection.activeGameObject = chart;
if (stage != null)
{
EditorSceneManager.MarkSceneDirty(stage.scene);
}
ValidateRenderingContext(chart);
}
/// <summary>选中项所在 Canvas 优先,其次直接挂在选中物体下;都没选中就建在场景根</summary>
private static Transform FindParentForScene()
{
Transform selection = Selection.activeTransform;
if (selection == null) return null;
Canvas canvas = selection.GetComponentInParent<Canvas>();
if (canvas != null) return canvas.transform;
return selection is RectTransform ? selection : null;
}
/// <summary>没有 Canvas 祖先时给出明确提示——否则现象是"什么都看不见",很难查</summary>
private static void ValidateRenderingContext(GameObject chart)
{
if (chart.GetComponentInParent<Canvas>() != null) return;
Debug.LogWarning(
"XChart:这个图表没有 Canvas 祖先,UGUI 图元不会渲染(现象就是什么都看不到)。" +
"把它放到某个 Canvas 下,或在它上面挂一个 Canvas 组件。", chart);
}
}
}
}
+148
View File
@@ -0,0 +1,148 @@
using System;
using System.Collections.Generic;
namespace XericUI.XChart.Editor
{
/// <summary>
/// 编辑器侧的测试数据生成器:<b>面板与数据窗口共用同一套口径</b>
/// (原来"生成 32 条示例"写死在面板里,数据窗口要同一份形状就得抄一遍——抄一遍就会分叉)。
///
/// <para>一律走 <c>TryAddRecord</c>:时间戳按上一条 +1(记录表要求时间非递减),
/// 值个数必须等于数值维数量(否则模型直接拒收),所以先补齐/截断再提交。</para>
/// </summary>
public static class XChartDataGenerators
{
/// <summary>螺旋矢量场一条记录占的数值维:起点 3 + 第二点 3 + 颜色 3(色相/饱和/明度)</summary>
public const int VectorFieldDimensions = 9;
/// <summary>螺旋上参数 t∈[0,1] 的那个点(一圈正弦/余弦配线性 x)</summary>
private static void Spiral(float t, out float x, out float y, out float z)
{
x = Lerp(-100f, 100f, t);
y = (float)Math.Sin(t * Math.PI * 2.0) * 50f;
z = (float)Math.Cos(t * Math.PI * 2.0) * 50f;
}
/// <summary>螺旋:一圈正弦/余弦配线性 x——现有"生成 32 条示例"就是它。</summary>
public static int AppendSpiral(XChartDataModel model, int count)
{
if (model == null || count <= 0) return 0;
int accepted = 0;
for (int i = 0; i < count; i++)
{
float t = count > 1 ? i / (float)(count - 1) : 0f;
float x, y, z;
Spiral(t, out x, out y, out z);
if (!TryAppend3(model, x, y, z)) break;
accepted++;
}
return accepted;
}
/// <summary>
/// 螺旋矢量场:<b>一条记录 9 个数值维</b> <c>[x, y, z, nx, ny, nz, h, s, v]</c>——
/// 前三维是这一条的点,中三维是<b>下一个点</b>,后三维是颜色(色相 0..256 走色环,饱和/明度都是 1)。
///
/// <para>为什么中三维取"下一个点":两种读法都能一眼分出来(他 2026-10-25 的描述)——
/// <b>相对</b>:箭头由本点指向下一点 ⇒ 一串首尾相接、顺着螺旋转;
/// <b>绝对</b>:后三维当方向矢量用 ⇒ 每根朝"下一点的坐标方向"散开,看起来像一片刺猬。</para>
///
/// <para>维数不够会先<b>把列补出来</b>(测试数据的判据是"点一下就能看到东西",
/// 而不是"提示他先去加六列");表里原有的记录会被清掉——它就是一份示例数据。</para>
/// </summary>
public static int AppendSpiralVectorField(XChartDataModel model, int count)
{
if (model == null || count <= 0) return 0;
EnsureNumericDimensions(model, VectorFieldDimensions);
if (model.NumericDimensionCount < VectorFieldDimensions) return 0;
model.Clear();
int accepted = 0;
var values = new float[VectorFieldDimensions];
for (int i = 0; i < count; i++)
{
float t = count > 1 ? i / (float)(count - 1) : 0f;
float tNext = count > 1 ? (i + 1) / (float)(count - 1) : 0f;
Spiral(t, out values[0], out values[1], out values[2]);
Spiral(tNext, out values[3], out values[4], out values[5]);
values[6] = 256f * t; // 色相:0..256 正好走完一圈色环
values[7] = 1f; // 饱和度
values[8] = 1f; // 明度
if (!TryAppend(model, values)) break;
accepted++;
}
return accepted;
}
/// <summary>把数值维补到至少 <paramref name="wanted"/> 个(按"数值维个数"补,不按表行数)。</summary>
private static void EnsureNumericDimensions(XChartDataModel model, int wanted)
{
if (model.NumericDimensionCount >= wanted) return;
var dimensions = new List<XChartDimensionDefinition>(model.Dimensions);
int numeric = model.NumericDimensionCount;
for (int i = numeric; i < wanted; i++)
{
dimensions.Add(new XChartDimensionDefinition("v" + i, "V" + i, XChartDimensionKind.Number));
}
model.SetDimensions(dimensions);
}
/// <summary>
/// 平方和金字塔:第 <c>k</c> 层是 <c>k×k</c> 个顶点(1、4、9、16 ⇒ 30 个),
/// 层内 x/y 铺满 <c>[-(k-1)/2, +(k-1)/2]</c>,<b>z = k 逐层升高</b>
/// ⇒ 层数越高、点越多、位置越高的阶梯金字塔。
/// </summary>
public static int AppendSquarePyramid(XChartDataModel model, int layers)
{
if (model == null || layers <= 0) return 0;
int accepted = 0;
for (int k = 1; k <= layers; k++)
{
float half = (k - 1) * 0.5f;
for (int i = 0; i < k; i++)
{
for (int j = 0; j < k; j++)
{
float x = i - half;
float y = j - half;
if (!TryAppend3(model, x, y, k)) return accepted;
accepted++;
}
}
}
return accepted;
}
/// <summary>追加一条:前三个数值维按顺序喂 x / y / z(其余补 0)。</summary>
public static bool TryAppend3(XChartDataModel model, float x, float y, float z)
{
if (model == null) return false;
int dimensions = model.NumericDimensionCount;
if (dimensions <= 0) return false;
var values = new float[dimensions];
if (dimensions > 0) values[0] = x;
if (dimensions > 1) values[1] = y;
if (dimensions > 2) values[2] = z;
return TryAppend(model, values);
}
/// <summary>追加一条:时间戳 = 上一条 +1(空表从 0 开始),其余交给模型校验。</summary>
public static bool TryAppend(XChartDataModel model, float[] values)
{
if (model == null || values == null) return false;
double timestamp = model.RecordCount > 0
? model.GetTimeAt(model.RecordCount - 1) + 1.0
: 0.0;
return model.TryAddRecord(timestamp, values);
}
private static float Lerp(float from, float to, float t) => from + (to - from) * t;
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 44cc42a4675d3ad489defb98a68854c0
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
File diff suppressed because it is too large Load Diff
+11
View File
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: c994b40d97f481e44b3c097fce84b574
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
+82
View File
@@ -0,0 +1,82 @@
using System;
using System.Collections.Generic;
using UnityEditor;
using UnityEngine;
using XericUI.XChart;
namespace XericUI.XChart.Editor
{
/// <summary>
/// 元素类型登记表(编辑器专用)。
///
/// 反射扫描所有带 <see cref="XChartElementAttribute"/> 的 <see cref="XChartElementConfig"/> 派生类,
/// 供 Inspector 的"添加元素"菜单列出。放在编辑器程序集里是刻意的:运行时不需要枚举全程序集,
/// 也避免 IL2CPP 裁剪把只在菜单里用到的类型剪掉。
/// </summary>
internal static class XChartElementRegistry
{
internal struct Entry
{
public Type ConfigType;
public XChartElementAttribute Meta;
}
private static List<Entry> s_Entries;
/// <summary>所有已注册元素(按菜单序)</summary>
internal static IReadOnlyList<Entry> GetEntries()
{
if (s_Entries != null) return s_Entries;
s_Entries = new List<Entry>();
var assemblies = AppDomain.CurrentDomain.GetAssemblies();
for (int a = 0; a < assemblies.Length; a++)
{
Type[] types;
try
{
types = assemblies[a].GetTypes();
}
catch (Exception)
{
// 动态程序集/加载失败的程序集直接跳过,不能让一个坏程序集挡住菜单
continue;
}
for (int i = 0; i < types.Length; i++)
{
var type = types[i];
if (type == null || type.IsAbstract || !typeof(XChartElementConfig).IsAssignableFrom(type))
continue;
var meta = (XChartElementAttribute)Attribute.GetCustomAttribute(
type, typeof(XChartElementAttribute), false);
if (meta == null) continue;
s_Entries.Add(new Entry { ConfigType = type, Meta = meta });
}
}
s_Entries.Sort((x, y) =>
{
int byOrder = x.Meta.MenuOrder.CompareTo(y.Meta.MenuOrder);
return byOrder != 0 ? byOrder : string.CompareOrdinal(x.Meta.DisplayName, y.Meta.DisplayName);
});
return s_Entries;
}
/// <summary>按类型造一个默认配置</summary>
internal static XChartElementConfig Create(Type configType)
{
try
{
return (XChartElementConfig)Activator.CreateInstance(configType);
}
catch (Exception exception)
{
Debug.LogError("Failed to create a chart element config: " + configType + " / " + exception.Message);
return null;
}
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 67697d7796f1432d8701b36d7d9fa4d0
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
+89
View File
@@ -0,0 +1,89 @@
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;
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: b25122dd07509f34bac3f94fb019e2c9
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant: