Files
XericUIActionVessel/Runtime/XChart/XChartToolOrder.cs
T
lrss3 c51ab7a3c8 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/,未入本仓库。)
2026-10-25 20:21:28 +08:00

71 lines
3.6 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
namespace XericUI.XChart
{
/// <summary>
/// 工具的<b>生命周期分组</b>(他 2026-10-23 的口径:"背景(背景网格)/ 前景(参数点位、轴线标尺、
/// tooltip、其他可互动元素)")。<b>定义 → 背景 → 前景</b> 依次跑更新:定义网格的那个工具先算出
/// 各维范围、把插槽发布出去,同一帧里轴线和数据图元就能取到——这是"注册先后不影响正确性"的前提。
///
/// <para><b>分组不是绘制序</b>:画家序由 <see cref="XChartToolBase.DrawOrder"/> 决定(§11.4:
/// "轴线的线可以绘制在点的上面")。两者分开,是因为"谁先算"和"谁盖住谁"是两件事。</para>
///
/// <para>分组是<b>类型标记</b>(工具自己声明),不入序列化——省得又多一个要调的旋钮。</para>
/// </summary>
public enum XChartToolCategory
{
/// <summary>定义几何/范围/插槽的工具(空间、网格背景、立方体背景):最先跑</summary>
Definition = 0,
/// <summary>只画背景、不定义几何的工具(今天还没有工具落在这里,位置先留着)</summary>
Background = 1,
/// <summary>数据图元与可交互元素(散点、箭头、圆柱、轴线、tooltip 之类):最后跑</summary>
Foreground = 2,
}
/// <summary>
/// 工具顺序的<b>唯一规则</b>:先按分组(定义→背景→前景),再按各自的值,值相等时按<b>注册序</b>
/// (先注册的在前)——最后这一条是稳定性的来源,缺了它"值相同"的两个工具的相对次序就看运气,
/// 而"看运气"的次序在画面上就是"有时点在上面、有时轴在上面"。
///
/// <para>抽成纯算术是为了离线判:次序错了不会报错,只是有人被别人盖住。</para>
/// </summary>
public static class XChartToolOrder
{
/// <summary><paramref name="a"/> 是否应该排在 <paramref name="b"/> 前面(−1 前,0 同序,1 后)</summary>
public static int Compare(XChartToolCategory aCategory, int aOrder, int aRegistration,
XChartToolCategory bCategory, int bOrder, int bRegistration)
{
if (aCategory != bCategory) return (int)aCategory < (int)bCategory ? -1 : 1;
if (aOrder != bOrder) return aOrder < bOrder ? -1 : 1;
if (aRegistration != bRegistration) return aRegistration < bRegistration ? -1 : 1;
return 0;
}
/// <summary>
/// 按 <see cref="Compare"/> 做<b>稳定插入排序</b>(就地,不分配):条目数有上限(工具几十个),
/// 且它跑在渲染/初始化路径上。返回是否真的动过(报表读数用:动没动能看出旋钮生效没)。
/// </summary>
public static bool Sort(int count, XChartToolCategory[] categories, int[] orders, int[] registrations,
int[] output)
{
if (count <= 0) return false;
for (int i = 0; i < count; i++) output[i] = i;
bool moved = false;
for (int i = 1; i < count; i++)
{
int key = output[i];
int j = i - 1;
while (j >= 0 && Compare(categories[output[j]], orders[output[j]], registrations[output[j]],
categories[key], orders[key], registrations[key]) > 0)
{
output[j + 1] = output[j];
moved = true;
j--;
}
output[j + 1] = key;
}
return moved;
}
}
}