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
+79
View File
@@ -0,0 +1,79 @@
using System.Collections.Generic;
using UnityEngine;
using XericUI.XChart.Axis;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 网格线的位置从哪儿来(P9):<b>网格是定义方</b>——按绑定的那一维的数据范围与目标条数
/// 算出一组"好看"的刻度值,再折成面参数比例发布出去;轴线以后按这些发布的线吸附,
/// 不再两边各算一遍(他 2026-10-23 的原话:"立方体网格上的分割线也都统一通过 chart 上的
/// 数据范围控制")。
///
/// <para><b>不绑数据(维度 &lt; 0)时退回等分</b>:比例 = <c>i/(count-1)</c>,与旧行为逐位相同——
/// 所以"没配维度"这件事不会改变任何画面。</para>
///
/// <para>刻度值那一套(nice step + 升序铺 + 指数/对数换算)直接复用
/// <see cref="XChartAxisMath"/>:**网格与刻度同源**,"逐条坐标相等"才有基础。</para>
/// </summary>
public static class XChartGridLines
{
/// <summary>等分(不绑数据):<paramref name="count"/> 条线,含两条边,比例 i/(count-1)。</summary>
public static int BuildUniformRatios(int count, float[] ratios)
{
if (ratios == null || count <= 0) return 0;
count = Mathf.Min(count, ratios.Length);
for (int i = 0; i < count; i++)
ratios[i] = count > 1 ? (float)i / (count - 1) : 0f;
return count;
}
/// <summary>
/// 按数据范围算线位置:用 <see cref="XChartAxisMath.BuildTicks"/> 求出刻度值,
/// 每个值经 <see cref="XChartAxisMath.ToParameter"/> 折成面参数比例并<b>夹到 [0,1]</b>
/// (范围外的刻度值不该画到面外去)。
/// </summary>
public static int BuildRatios(double min, double max, XChartAxisScale scale, double strength,
int targetCount, double manualStep, bool autoStep, float[] ratios, List<double> scratch)
{
if (ratios == null || scratch == null) return 0;
XChartAxisMath.BuildTicks(min, max, scale, manualStep, targetCount, autoStep, scratch);
int count = 0;
for (int i = 0; i < scratch.Count && count < ratios.Length; i++)
{
double ratio = XChartAxisMath.ToParameter(scratch[i], min, max, scale, strength);
if (double.IsNaN(ratio) || double.IsInfinity(ratio)) continue;
ratios[count++] = Mathf.Clamp01((float)ratio);
}
return count;
}
/// <summary>
/// 把 <paramref name="ratio"/> 吸附到<b>最近的一条格线比例</b>上(P9 的"轴线跟随"那一步)。
/// 最近那条的距离超过 <paramref name="maxDistance"/> 就<b>不吸</b>——宁可不对齐,也不要把刻度
/// 扭到老远的地方(那会让人以为数据变了)。吸不上时 <paramref name="snapped"/> 原样回填,返回 false。
/// </summary>
public static bool TrySnapToGrid(float[] ratios, int count, float ratio, float maxDistance, out float snapped)
{
snapped = ratio;
if (ratios == null || count <= 0) return false;
int best = -1;
float bestDistance = float.MaxValue;
for (int i = 0; i < count; i++)
{
float distance = Mathf.Abs(ratios[i] - ratio);
if (distance < bestDistance)
{
bestDistance = distance;
best = i;
}
}
if (best < 0 || bestDistance > maxDistance) return false;
snapped = ratios[best];
return true;
}
}
}