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
+104
View File
@@ -0,0 +1,104 @@
using System;
namespace XericUI.XChart
{
/// <summary>
/// 桶采样:把<b>一段记录</b>简化成 N 个点,每点取桶内一个"最有意义"的统计量。
///
/// <para><b>为什么要有它</b>:元素按记录数长几何(散点一个点一条记录、箭头一条记录两个四边形),
/// 几万条记录就会把顶点预算和帧率一起吃掉。桶采样把"这一段时间里发生了什么"压成一个点——
/// 折线要最新值就取 <c>Last</c>、要看包络就取 <c>Minimum</c>/<c>Maximum</c>、要看趋势就取 <c>Mean</c>。</para>
///
/// <para><b>分桶的硬要求</b>:整数均分,<b>不留缝、不重叠、每条记录恰好属于一个桶</b>
/// (用 <c>recordCount * i / bucketCount</c> 的整数算术,不是浮点即兴切);
/// 目标点数 ≥ 记录数或 ≤ 0 就是"不聚合",一个桶都不多。</para>
///
/// <para>纯算术 + 只读数据源 ⇒ 离线可判(见 <c>math_probe.cs</c> 的 bucket 断言与 p4 的对照臂):
/// "少一条记录""桶边界错一格"这类错误在画面上只是"点少了一个",眼睛看不出来。</para>
/// </summary>
public static class XChartBucketMath
{
/// <summary>
/// 要分几个桶。<paramref name="targetPoints"/> ≤ 0 或 ≥ 记录数=不聚合(桶数 = 记录数),
/// 记录数为 0 时返回 0。
/// </summary>
public static int BucketCount(int recordCount, int targetPoints)
{
if (recordCount <= 0) return 0;
if (targetPoints <= 0 || targetPoints >= recordCount) return recordCount;
return targetPoints;
}
/// <summary>
/// 第 <paramref name="bucketIndex"/> 个桶覆盖 <c>[firstRecord, endExclusive)</c>。
/// 整数均分:桶与桶严丝合缝(前一个的 end == 后一个的 first),全部桶并起来正好是 [0, recordCount)。
/// </summary>
public static bool TryBucketRange(int recordCount, int bucketIndex, int bucketCount,
out int firstRecord, out int endExclusive)
{
firstRecord = endExclusive = 0;
if (recordCount <= 0 || bucketCount <= 0 || bucketCount > recordCount) return false;
if (bucketIndex < 0 || bucketIndex >= bucketCount) return false;
firstRecord = (int)((long)recordCount * bucketIndex / bucketCount);
endExclusive = (int)((long)recordCount * (bucketIndex + 1) / bucketCount);
return endExclusive > firstRecord;
}
/// <summary>
/// 桶内归约:取该维在 <c>[firstRecord, endExclusive)</c> 上的一个统计量。
/// NaN/Inf 一律跳过(它们不是数据点);整桶都是坏值返回 false——**宁可少画一个点,
/// 也不要往几何里塞一个假位置**。<paramref name="scratch"/> 只给中位数用(要么给够长度、
/// 要么别选中位数),长度不够就拒收而不是内部悄悄分配。
/// </summary>
public static bool TryReduce(IXChartDataSource data, int dimension, int firstRecord, int endExclusive,
XChartAggregateKind reduce, double[] scratch, out double value)
{
value = double.NaN;
if (data == null || dimension < 0) return false;
if (firstRecord < 0 || endExclusive > data.RecordCount || endExclusive <= firstRecord) return false;
if (reduce == XChartAggregateKind.Median && scratch == null) return false;
double sum = 0d, squareSum = 0d, first = 0d, last = 0d, minimum = 0d, maximum = 0d;
int valid = 0;
for (int i = firstRecord; i < endExclusive; i++)
{
double v = data.GetValueAt(i, dimension);
if (double.IsNaN(v) || double.IsInfinity(v)) continue;
if (valid == 0) { first = minimum = maximum = v; }
last = v;
sum += v;
squareSum += v * v;
if (v < minimum) minimum = v;
if (v > maximum) maximum = v;
if (scratch != null && valid < scratch.Length) scratch[valid] = v;
valid++;
}
if (valid == 0) return false;
switch (reduce)
{
case XChartAggregateKind.Count: value = valid; return true;
case XChartAggregateKind.First: value = first; return true;
case XChartAggregateKind.Last: value = last; return true;
case XChartAggregateKind.Minimum: value = minimum; return true;
case XChartAggregateKind.Maximum: value = maximum; return true;
case XChartAggregateKind.Sum: value = sum; return true;
case XChartAggregateKind.Mean: value = sum / valid; return true;
case XChartAggregateKind.Rms: value = Math.Sqrt(squareSum / valid); return true;
case XChartAggregateKind.Median:
if (scratch.Length < valid) return false;
Array.Sort(scratch, 0, valid);
value = (valid & 1) == 1
? scratch[valid / 2]
: (scratch[valid / 2 - 1] + scratch[valid / 2]) * 0.5;
return true;
default:
return false;
}
}
}
}