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
+89
View File
@@ -0,0 +1,89 @@
using UnityEngine;
namespace XericUI.XChart
{
/// <summary>
/// 元素参数"从数据哪来"的翻译:<b>记录下标 + 维度下标</b> → 一个几何通道的值。
///
/// <para><b>顺序只有一个权威</b>(他 2026-10-24 的要求:"所有工具访问数据时,顺序、方向、索引、
/// 尺寸、内容都是一样的"):记录下标 <c>0</c> 就是表里最早的、<c>n-1</c> 是最新的,
/// 和数据窗口显示的行号<b>同一套下标</b>。这里<b>不提供</b>"往回数第几条"这种相对量——
/// 它让同一份数据在窗口里是第 1 条、在工具里变成第 n-2 条(那次现场就是它:
/// 圆柱默认取"上一条→最新",于是他改第 1 条时圆柱不动,而末两条相等时两端合并)。</para>
///
/// <para><b>多记录一图元走"编组"</b>:组 <c>g</c> 覆盖 <c>[g*size, g*size+size-1]</c>,
/// 组与组<b>严格不重叠、也不把上一组并进来</b>;凑不满一组的尾巴<b>不画</b>
/// (宁可少画一个,也不要画一个用错记录的)。这样 32 条记录、组大小 2 ⇒ 16 个图元。</para>
/// </summary>
public static class XChartBindingMath
{
/// <summary>能凑出几个完整组:<c>记录数 / 组大小</c>(向下取整,尾巴不算)。</summary>
public static int CompleteGroupCount(int recordCount, int groupSize)
{
if (groupSize < 2 || recordCount < groupSize) return 0;
return recordCount / groupSize;
}
/// <summary>
/// 组 <paramref name="groupIndex"/> 的首尾记录下标(<b>绝对下标</b>,组内 = 首…尾)。
/// 尾巴凑不满一组时返回 false。
/// </summary>
public static bool TryResolveGroup(int recordCount, int groupIndex, int groupSize,
out int firstRecord, out int lastRecord)
{
firstRecord = lastRecord = -1;
if (groupSize < 2 || groupIndex < 0) return false;
int first = groupIndex * groupSize;
int last = first + groupSize - 1;
if (last >= recordCount) return false;
firstRecord = first;
lastRecord = last;
return true;
}
/// <summary>
/// 三个维度 + <b>一条指定的记录</b> → 一个位置(原始数值,还在数据口径里)。
/// 下标越界、维度越界、值不是有限数一律 false:<b>宁可这一帧不画,也不往几何里塞 NaN</b>
/// ——NaN 进去以后是静默毁掉整条管线,不是画歪。
/// </summary>
public static bool TryResolvePosition(IXChartDataSource data, int recordIndex,
int dimensionX, int dimensionY, int dimensionZ, out Vector3 position)
{
position = Vector3.zero;
if (data == null) return false;
if (recordIndex < 0 || recordIndex >= data.RecordCount) return false;
if (dimensionX < 0 || dimensionY < 0 || dimensionZ < 0) return false;
int dimensions = data.NumericDimensionCount;
if (dimensionX >= dimensions || dimensionY >= dimensions || dimensionZ >= dimensions) return false;
double x = data.GetValueAt(recordIndex, dimensionX);
double y = data.GetValueAt(recordIndex, dimensionY);
double z = data.GetValueAt(recordIndex, dimensionZ);
if (!IsFinite(x) || !IsFinite(y) || !IsFinite(z)) return false;
position = new Vector3((float)x, (float)y, (float)z);
return true;
}
/// <summary>
/// 数据值 → 立方体单位(±1 就是盒子边界)。<b>值域退化(两个端点相等或非有限)时返回 false</b>:
/// 那一刻没有"数据在哪儿"可言,硬画出来是一个假位置,不如让调用方这一帧不画。
/// 不裁剪到 ±1——超出盒子的值是数据的事实,裁了就看不出来了。
/// </summary>
public static bool TryNormalize(double value, double minimum, double maximum, out float unit)
{
unit = 0f;
if (!IsFinite(value) || !IsFinite(minimum) || !IsFinite(maximum)) return false;
double span = maximum - minimum;
if (span <= 0d) return false;
unit = (float)((value - minimum) / span * 2d - 1d);
return true;
}
private static bool IsFinite(double value) => !double.IsNaN(value) && !double.IsInfinity(value);
}
}