Files
XericUIActionVessel/Runtime/XChart/XChartElementConfig.cs
T
lrss3 084591d104 P26:标签按"标签列"1:1 落到记录、窗口、元素、文本四处(规范 §35)
- XChartColumnMath 补标签半边(LabelCount / LabelSlotOf / DefinitionOfLabelSlot / SizedLabels),
  记录的标签长度只由这一处定;TryAddRecord 在 labels 长度≠标签列数时整条拒收
- 导入按标签字段个数校验并点名行号;记录行少到连时间戳都没有时点名拒绝(不再抛异常)
- 数据窗口:一个显示序两个读者(标签列在前),格子身份 CellRef{IsLabel,Slot},
  标签格走 TrySetLabel 的字符串分支,「+标签」走 SetDimensions 这唯一定长路径
- 新标签元素 ChartToolLabels + XChartLabelConfig:13 旋钮全自动置脏、位置/折法同散点、
  文本走池且多余槽位必须擦、锚点与对齐出自同一张表(anchorMin/Max 不写)
- 面板把"要几个标签列、表里有几个"与数值维、记录数一起印(§25.1 第三半 RequiredLabelColumns)
- 探针先红的两个真缺陷:SizedLabels(null,n) 补 null 不是空串;锚点表漏 MiddleRight 与 Center 重合
- 雷达 AddSeries 带系列名,两个 SetDimensions 重载都声明 series 标签列(否则新门口整条拒收)
- 判据:探针 492/0、label_gate 15 claim/15 臂全红、dirty_gate 149/149、slot_reset PASS、
  编译门三臂+3 对照绿(source present 点名四个新文件)、p4_control 78 支各红在点名断言
  (同一棵树指纹 478727e6748c67cddda40995874b20968e9eae3706f2a21c24726d3412059747)
2026-11-09 06:58:39 +08:00

175 lines
8.8 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>
/// 这个元素要<b>几个标签列</b>才画得出来(0=不需要)。标签元素读的是那一列在每一行上的那一格:
/// 表里没有标签列时它一条都不画,而这在画面上和"没数据"长得一模一样——所以"要几个、表里有几个"
/// 必须和数值维、记录数一起印出来(§25.1 的第三半)。
/// </summary>
public virtual int RequiredLabelColumns => 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;
}
}
}