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:
@@ -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;
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user