Files
XericUIActionVessel/Runtime/XChart/XChartElementConfig.cs
T
lrss3 0d9a3d7417 XChart P17 口径修正:序号只读、矢量场按 3 维坐标 + 相邻两条记录一支箭头
按他 2026-10-25 的澄清(规范 §24.5 / §25 已先改对):

- **序号不再是给人设的**:标题行 `R… D…` 改成文本读数(就地刷新);Body 里不再有任何序号输入控件。
  新增 `RenumberDrawOrder()`:任何结构变化(上移/下移/加/删)之后把每个元素的 `m_DrawOrder`
  重写成它在表里的位置 ⇒ **位置更靠后=绘得更晚=盖在上面**,位置是唯一权威;
  注册序由类型定死,只显示。↑↓ 的 tooltip 也改成讲层序。
- **矢量场数据口径改对**:前三维=坐标 x/y/z(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**
  (第 i 条起点、第 i+1 条按绝对/相对解释)、**第 4~7 维=颜色**(色相 0..256 色环 / 饱和 / 明度 / 不透明,
  全可选)。需求印**三个数**(需要几个数值维 / 需要几条记录 / 表里各有多少)——
  "记录不够"与"维数不够"在画面上同形,只有这三个数分得清。
- 支数由纯算术 `XChartVectorFieldMath.ArrowCount(记录数, 上限)` 算(N 条 ⇒ N−1 支,上限裁剪,<2 条 ⇒ 0)。
- **两端各自颜色**:杆用起点色、头用终点色(读两条记录各自的颜色维);沿杆逐顶点渐变留给 P18。
- 生成器 `螺旋矢量场` 改成 **7 维**(坐标 + 色相走满一圈 + 饱和/明度/不透明),自己补列。

判据:编译门三臂 + 3 对照绿;探针 **439** 项 0 失败(新增支数一族);
`p4_control` **57/57** 支臂各红在点名断言上(新增两支:一对不再花两条记录、空表不挡而直接进算术);
`p2` / `family` / `generator_gate` / `hierarchy_gate` 在同一棵交付树上复跑全绿。
过程记录:第一版给"一对不再花两条记录"点名的清单里放了一条**被更前面的守卫挡住、这支变异体碰不到**
的判据,`did not go red` 当场抓出来 ⇒ 按实测改清单,并给零/一条记录补了它自己那支变异体(§25.7)。
2026-10-25 21:01:53 +08:00

168 lines
8.3 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 System;
using System.Collections.Generic;
using UnityEngine;
namespace XericUI.XChart
{
/// <summary>
/// 元素注册标记:凡是带它的 <see cref="XChartElementConfig"/> 派生类,都会被编辑器的
/// "添加元素"菜单列出来(<paramref name="id"/> 是稳定标识,改名不改 id)。
/// </summary>
[AttributeUsage(AttributeTargets.Class, Inherited = false)]
public sealed class XChartElementAttribute : Attribute
{
/// <summary>稳定标识(序列化无关,供菜单/查找用)</summary>
public string Id { get; }
/// <summary>Inspector 菜单里显示的名字</summary>
public string DisplayName { get; }
/// <summary>菜单排序</summary>
public int MenuOrder { get; }
public XChartElementAttribute(string id, string displayName, int menuOrder = 0)
{
Id = id;
DisplayName = string.IsNullOrEmpty(displayName) ? id : displayName;
MenuOrder = menuOrder;
}
}
/// <summary>
/// 元素配置基类——<b>元素的作者数据</b>。
///
/// <para><b>它同时是三样东西</b>:</para>
/// <list type="number">
/// <item>图表的序列化内容:由图表用 <c>[SerializeReference]</c> 列表持有,所以每个元素
/// 自带自己的配置,图表组件不必再为每个元素声明一堆字段并逐个 Sync。</item>
/// <item>Inspector 上的界面:Unity 对 <c>[SerializeReference]</c> 的支持本身就是"接口协议"——
/// 列表里每个元素按实际类型展开、显示它自己的字段,派生类不需要写自定义 Editor。</item>
/// <item>元素的工厂与装配点:<see cref="CreateTool"/> 造元素实例,<see cref="ApplyTo"/>
/// 把配置灌进去。轴线、网格背景、以后任何东西都走这一条路。</item>
/// </list>
///
/// <para><b>方向是单向的</b>:配置是作者数据,元素是运行时实例。所以主流程只走
/// 配置 -> 元素(<see cref="ApplyTo"/>);<see cref="CaptureFrom"/> 只给编辑器做
/// "把当前元素状态收回配置"的可选操作,运行时不需要。</para>
/// </summary>
[Serializable]
public abstract class XChartElementConfig
{
[SerializeField] private bool m_Enabled = true;
/// <summary>
/// 注册序:谁先建、谁先更新(§11.4 的"注册 order")。<b>它不再是绘制序</b>——
/// 想让某个元素"先算但后画"(比如轴线的线画在点上面)用 <see cref="DrawOrder"/>。
/// </summary>
[SerializeField] private int m_OrderIndex;
/// <summary>绘制序(画家序):小者先画、大者盖在上面;只在同一分组内比较(分组见 XChartToolCategory)</summary>
[SerializeField] private int m_DrawOrder;
/// <summary>是否参与加载(关掉后元素不创建,但配置留在图表上)</summary>
public bool Enabled
{
get => m_Enabled;
set => m_Enabled = value;
}
/// <summary>注册序(越小越先建、越先更新;与绘制序分开)</summary>
public int OrderIndex
{
get => m_OrderIndex;
set => m_OrderIndex = value;
}
/// <summary>绘制序(越小越先画;同分组内比较)</summary>
public int DrawOrder
{
get => m_DrawOrder;
set => m_DrawOrder = value;
}
/// <summary>元素在 ToolsRoot 下的名字,默认取类型名</summary>
public virtual string ElementName => GetType().Name;
/// <summary>
/// 造一个元素实例。基类拿不到具体类型,所以由每个配置自己 new 出对应的元素;
/// 这里不接触 ToolsManager,也不做初始化(初始化由图表按统一流程完成)。
/// </summary>
public abstract XChartToolBase CreateTool();
/// <summary>
/// 把配置灌进元素。调用时机:元素已 <c>AddTool</c> 完成(子节点/渲染器都已建好)。
/// </summary>
public abstract void ApplyTo(XChartToolBase tool);
/// <summary>从元素回读当前状态(编辑器里的"拾取",可选实现)</summary>
public virtual void CaptureFrom(XChartToolBase tool) { }
/// <summary>
/// 这个元素要<b>几个数值维</b>才画得出来(0=无所谓,比如几何是常量的元素)。
///
/// <para>面板拿它跟表里现有的数值维数对一下印出来:向量箭头要 6 维,而表里只有 x/y/z 三列时它
/// <b>一条都不画</b>——那时画面上什么都没有,报表里也只是几个 0,人只能猜
/// (他 2026-10-25:"我把它添加进来了,之后它并没有显示出来,我现在是有默认数据在里面的")。
/// 需求是多少、现有是多少,两个数一起印才分得清"没数据"和"数据形状不对"。</para>
/// </summary>
public virtual int RequiredNumericDimensions => 0;
/// <summary>
/// 这个元素要<b>几条记录</b>才画得出来(0=一条也行)。
/// 和维数是同一件事的两半:矢量场一条记录都不缺维、但只有一条记录时**一支箭头都构不成**
/// (一支=相邻两条)。两个数必须都印出来,否则"有数据但不够"又会混进"什么都没显示"里。
/// </summary>
public virtual int RequiredRecordCount => 0;
/// <summary>
/// 互斥显示:<paramref name="fieldName"/> 这个字段在当前配置下要不要从面板上<b>藏掉</b>。
///
/// <para>他 2026-10-25 要的用法:"我勾选'连续绘制',配置里就失去'相对还是绝对'那个选项;
/// 取消勾选,那个选项又回来"。判据写在配置自己身上(它读的是自己的字段),
/// 面板只负责照着藏——不在面板里给某个元素写特例,也不做两套开关防止互相矛盾。</para>
/// </summary>
public virtual bool IsFieldHidden(string fieldName) => false;
}
/// <summary>
/// 元素表的<b>纯算</b>部分(离线可验,不碰 Unity 对象)。
/// </summary>
public static class XChartElementTable
{
/// <summary>
/// 表里第一份<b>这一类</b>(含派生)配置的下标,没有则 -1。
///
/// <para><b>为什么单独拎出来</b>:默认元素按类型去重就靠它。图表初始化会跑很多遍
/// (域重载、预制体开合、进 Play),<c>DeclareDefaultElements</c> 每遍都被问一次;
/// 不去重的结果是"每重载一次多一个背景"——同一批格线画两遍、边越描越粗,
/// 而他看到的只是"图好像越来越糊"。这类"多出来的那一份"必须在能算的地方算清,
/// 而不是留在 MonoBehaviour 里等现场撞见。</para>
/// </summary>
public static int IndexOfKind(IReadOnlyList<XChartElementConfig> elements, Type kind)
{
if (elements == null || kind == null) return -1;
for (int i = 0; i < elements.Count; i++)
{
// 空槽(被清掉的那一条)跳过,不算命中:它既不是这一类,也不该把这一类挡在外面
var element = elements[i];
if (element != null && kind.IsInstanceOfType(element)) return i;
}
return -1;
}
/// <summary>表里已经有这一类了吗(<see cref="IndexOfKind"/> 的是/否写法)</summary>
public static bool HasKind(IReadOnlyList<XChartElementConfig> elements, Type kind)
=> IndexOfKind(elements, kind) >= 0;
/// <summary>
/// 这一类配置的<b>第一条</b>,没有则 null。
/// "哪一条是这一类"只许有这一个答法:判重用下标、脚本入口用实例,两条查找各写一遍
/// 迟早答得不同(本轮拆掉的正是"两处存同一件事"这一族)。
/// </summary>
public static XChartElementConfig FirstOfKind(IReadOnlyList<XChartElementConfig> elements, Type kind)
{
int at = IndexOfKind(elements, kind);
return at >= 0 ? elements[at] : null;
}
}
}