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
+64
View File
@@ -0,0 +1,64 @@
using System.Collections.Generic;
namespace XericUI.XChart
{
/// <summary>
/// 维度表的<b>下标口径</b>:表里一行是"一列"(键、种类、显示名、范围覆盖),而每条记录的
/// 值数组只装<b>数值列</b>——中间夹一个 Label/Time 列时,"表里第几行"和"值是第几格"会错开。
///
/// <para>这条映射以前在数据模型里数一遍、在数据窗口里再数一遍,两处各数各的就会出现
/// "窗口把刚填过数的格子显示成 <c>-</c>,导出里那两个数却还在"。规则收在这里,
/// 模型与界面都调它,判据也只需要盯这一处(见规范 §21.7)。</para>
/// </summary>
public static class XChartColumnMath
{
/// <summary>数值列的个数=每条记录值数组的长度(非数值列不占格)</summary>
public static int ValueCount(IReadOnlyList<XChartDimensionDefinition> dimensions)
{
if (dimensions == null) return 0;
int count = 0;
for (int i = 0; i < dimensions.Count; i++)
if (dimensions[i] != null && dimensions[i].Kind == XChartDimensionKind.Number) count++;
return count;
}
/// <summary>
/// 表里第 <paramref name="tableIndex"/> 行对应的<b>值下标</b>;
/// 那一列不占值(种类不是 Number)或行号越界时返回 <c>-1</c>(调用方据此显示"没有数值"而不是猜)。
/// </summary>
public static int ValueSlot(IReadOnlyList<XChartDimensionDefinition> dimensions, int tableIndex)
{
if (dimensions == null || tableIndex < 0 || tableIndex >= dimensions.Count) return -1;
var target = dimensions[tableIndex];
if (target == null || target.Kind != XChartDimensionKind.Number) return -1;
int slot = 0;
for (int i = 0; i < tableIndex; i++)
if (dimensions[i] != null && dimensions[i].Kind == XChartDimensionKind.Number) slot++;
return slot;
}
/// <summary>
/// 反方向:值下标 <paramref name="valueSlot"/> 属于表里哪一列(拿到那一列的定义)。
///
/// <para>工具绑的"第几维"是<b>值下标</b>(它按 <c>GetValueAt(record, dimension)</c> 取数),
/// 而范围覆盖存在<b>表里那一列</b>上。两边都按下标直接查就会在混合种类的表上错位:
/// 表是 <c>x, tag, y</c> 时,工具的"第 1 维"是 <c>y</c>,而表里第 1 行是 <c>tag</c>。
/// 这条函数把那一次换算固定下来(规范 §21.7)。</para>
/// </summary>
public static XChartDimensionDefinition DefinitionOfValueSlot(
IReadOnlyList<XChartDimensionDefinition> dimensions, int valueSlot)
{
if (dimensions == null || valueSlot < 0) return null;
int slot = 0;
for (int i = 0; i < dimensions.Count; i++)
{
var candidate = dimensions[i];
if (candidate == null || candidate.Kind != XChartDimensionKind.Number) continue;
if (slot == valueSlot) return candidate;
slot++;
}
return null;
}
}
}