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