Files
XericUIActionVessel/Runtime/XChart/XChartDomainMath.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

140 lines
6.2 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.
using UnityEngine;
namespace XericUI.XChart
{
/// <summary>
/// 一维的<b>覆盖请求</b>:哪几端被钉住、钉成多少。
///
/// <para>为什么要分侧(<see cref="HasMin"/> / <see cref="HasMax"/> 各一个):验收时他要的是
/// "最小值必须得是 0,最大值让它自由发挥"——一个总的开关只能表达"两端都钉住"或"两端都自由",
/// 而"钉一端"是常见形态(把轴的原点按住,让另一端跟数据走)。</para>
/// </summary>
public readonly struct XChartDomainOverride
{
public readonly bool HasMin;
public readonly double Min;
public readonly bool HasMax;
public readonly double Max;
public XChartDomainOverride(bool hasMin, double min, bool hasMax, double max)
{
HasMin = hasMin;
Min = min;
HasMax = hasMax;
Max = max;
}
/// <summary>两端都没钉(=完全跟着该维聚合走)</summary>
public static XChartDomainOverride None => new XChartDomainOverride(false, 0.0, false, 0.0);
}
/// <summary>
/// 显示范围(domain)解析的<b>纯函数</b>:只吃标量,不碰 Unity 对象,
/// 所以编译门里的 mono 探针能把这几条规则逐条当断言跑(含反向变异对照)。
///
/// <para>规则(顺序就是优先级):</para>
/// <list type="number">
/// <item><b>钉住的端优先</b>:每一端各问各的——钉了就用填的值,没钉就用该维聚合。</item>
/// <item>只钉了一端、而另一端<b>连聚合都没有</b>时,以钉住的那端为中心展开 ±<see cref="DegeneratePad"/>:
/// 这跟"两端都钉住但填成同一个值"同一处理,都是为了避开零宽域上的除零。</item>
/// <item>钉住的一端比自由端的聚合还靠外(或写反了)⇒ <b>自动排序</b>。手滑填反不该让整条轴什么都不画,
/// 也不该画出一段反向的轴。</item>
/// <item>什么都没钉、聚合也没有 → false,调用者这帧什么都不画(不是画在 0 上)。</item>
/// </list>
///
/// <para><b>入口只有一个</b>:拿数据源问范围请走 <see cref="TryResolve(IXChartDataSource,int,out double,out double)"/>
/// (它读维度行的覆盖 + 该维聚合,再调下面这条纯规则)。渲染上下文、面板、数据窗口都从这里问,
/// 于是"这条轴现在画哪一段"这件事全图只有一份算法。</para>
/// </summary>
public static class XChartDomainMath
{
/// <summary>退化范围的中心展开半径(数据全是同一个值、或只钉了一端又没有聚合时用)</summary>
public const double DegeneratePad = 0.5;
/// <summary>这一维现在要钉住什么:覆盖请求就存在 chart 的维度行里("范围归数据、工具只呈现")</summary>
public static XChartDomainOverride OverrideOf(IXChartDataSource data, int dimension)
{
XChartDimensionDefinition definition;
if (data == null || !data.TryGetDimension(dimension, out definition) || definition == null)
return XChartDomainOverride.None;
return definition.DomainOverride;
}
/// <summary>
/// 解析某维的显示范围(<b>所有人问范围的同一扇门</b>):覆盖来自维度行,
/// 自由端来自该维的聚合。规则明细见类型注释。
/// </summary>
public static bool TryResolve(IXChartDataSource data, int dimension, out double min, out double max)
{
min = 0.0;
max = 1.0;
if (data == null) return false;
XChartAggregates aggregates = default;
bool has = data.TryGetAggregates(dimension, XChartAggregateMask.Range, out aggregates)
&& aggregates.Has(XChartAggregateKind.Minimum)
&& aggregates.Has(XChartAggregateKind.Maximum);
return TryResolve(OverrideOf(data, dimension), has,
has ? aggregates.Minimum : 0.0, has ? aggregates.Maximum : 0.0, out min, out max);
}
public static bool TryResolve(XChartDomainOverride over, bool hasAggregates, double aggregateMin,
double aggregateMax, out double min, out double max)
{
min = 0.0;
max = 0.0;
bool aggregatesUsable = hasAggregates
&& !double.IsNaN(aggregateMin) && !double.IsNaN(aggregateMax)
&& !double.IsInfinity(aggregateMin) && !double.IsInfinity(aggregateMax);
// 两端都没钉:纯聚合口径
if (!over.HasMin && !over.HasMax)
{
if (!aggregatesUsable) return false;
if (aggregateMax > aggregateMin)
{
min = aggregateMin;
max = aggregateMax;
return true;
}
min = aggregateMin - DegeneratePad;
max = aggregateMin + DegeneratePad;
return true;
}
// 钉住的一端用填的值,自由的一端用聚合(聚合没有就是 NaN,下面按"没有依据"处理)
double lower = over.HasMin ? over.Min : (aggregatesUsable ? aggregateMin : double.NaN);
double upper = over.HasMax ? over.Max : (aggregatesUsable ? aggregateMax : double.NaN);
if (double.IsNaN(lower) || double.IsNaN(upper))
{
// 只钉了一端,另一端没有任何依据 ⇒ 以钉住的这端为中心展开(零宽的域画不出东西)
double anchor = over.HasMin ? over.Min : over.Max;
min = anchor - DegeneratePad;
max = anchor + DegeneratePad;
return true;
}
if (upper < lower)
{
double swap = lower;
lower = upper;
upper = swap;
}
if (upper == lower)
{
min = lower - DegeneratePad;
max = lower + DegeneratePad;
return true;
}
min = lower;
max = upper;
return true;
}
}
}