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
@@ -0,0 +1,42 @@
using System;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 网格分格数的唯一算法(规范 §8.2)。
///
/// <para>立方体的线框要能和轴刻度逐线对上,分格数就不能只有一份——两条轴的范围不同,
/// 需要的格数也不同(验收现场:<c>-100..100</c> 要 4 格、<c>-40..40</c> 要 8 格,
/// 而网格当时只有一份"5")。所以按方向给:S 一份、T 一份,<b>不给(0 或负)表示跟随统一值</b>。</para>
///
/// <para><b>沿 S 的格线数由 T 方向的分格数决定</b>("沿 S 走"的线就是"每个 T 分格边界一条"),
/// 反过来也一样——这一句最容易写反,所以从绘制代码里抽出来,让离线探针钉住它。</para>
/// </summary>
public static class XChartGridDivisions
{
/// <summary>某个方向的分格数:给了正数就用它,否则回落到统一值(统一值也不正就取 1)</summary>
public static int Resolve(int perDirection, int uniform)
{
if (perDirection >= 1) return perDirection;
return uniform >= 1 ? uniform : 1;
}
/// <summary>沿 S 方向的格线数 = T 方向分格数 + 1(含两条边)</summary>
public static int LinesAlongS(int divisionsS, int divisionsT, int uniform)
{
return Resolve(divisionsT, uniform) + 1;
}
/// <summary>沿 T 方向的格线数 = S 方向分格数 + 1(含两条边)</summary>
public static int LinesAlongT(int divisionsS, int divisionsT, int uniform)
{
return Resolve(divisionsS, uniform) + 1;
}
/// <summary>统一值(不拆方向)时两个方向的格线数——留给"只有一份分格数"的旧配置用</summary>
public static int UniformLineCount(int uniform)
{
return Resolve(0, uniform) + 1;
}
}
}