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:
2026-10-25 20:21:28 +08:00
parent 216d157472
commit c51ab7a3c8
105 changed files with 13062 additions and 812 deletions
+63
View File
@@ -0,0 +1,63 @@
namespace XericUI.Core
{
/// <summary>
/// 注册路径总表:本插件里所有菜单 / 组件注册路径的<b>唯一出处</b>。
///
/// <para><b>为什么要有它</b>:路径以前散落在各文件的字面量里(<c>"Xeric UI Vessel/…"</c>、
/// <c>"Xeric/XChart/…"</c>、<c>"XericLibrary/…"</c> 三套风格并存),改名要满地找。
/// 现在统一成"<b>{根}/{产品族}/{产品名}</b>",注册时只用 族常量 + 自己的名字。</para>
///
/// <para><b>用法(属性参数必须是编译期常量,所以这里全是 const,靠拼接成串)</b></para>
/// <code>
/// // 组件菜单(Component 菜单下,不需要 "Component/" 前缀)
/// [AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Cube Mesh Background Tool")]
///
/// // 菜单栏
/// [MenuItem(XericRegistrationPaths.Chart + "/重新投影")]
///
/// // GameObject > … 创建菜单
/// [MenuItem(XericRegistrationPaths.ChartCreate + "/Scatter Chart", false, 12)]
///
/// // 组件上下文菜单(CONTEXT/&lt;组件类型&gt;/… 的前缀是绑定键,不能加根)
/// [MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", true)]
/// </code>
///
/// <para><b>新加产品时</b>:先用 <see cref="Root"/> + 你自己的族名拼一个族常量放在这里,
/// 再去调用点用"族常量 + 产品名"。不要在任何别的地方写死路径字面量。</para>
/// </summary>
public static class XericRegistrationPaths
{
/// <summary>总根:所有注册路径的公共前缀</summary>
public const string Root = "Xeric Library";
// ── 产品族(菜单栏与组件菜单共用同一套前缀) ──────────────
/// <summary>图表族(Chart / Line / Radar / Mesh / Pseudo3D …)</summary>
public const string Chart = Root + "/Chart";
/// <summary>表格族</summary>
public const string Table = Root + "/Table";
/// <summary>通用 UI 组件族(Image / Button / Toggle / Style* / Values …)</summary>
public const string UI = Root + "/UI";
/// <summary>布局族</summary>
public const string Layout = Root + "/Layout";
/// <summary>窗口(Form)族</summary>
public const string Form = Root + "/Form";
/// <summary>翻页族</summary>
public const string FlipPage = Root + "/FlipPage";
/// <summary>锚点窗口族</summary>
public const string AnchorWindow = Root + "/AnchorWindow";
// ── 其它菜单前缀 ──────────────────────────────────────────
/// <summary>GameObject 菜单前缀:创建类菜单必须从这里开始</summary>
public const string CreatePrefix = "GameObject/";
/// <summary>GameObject 菜单下的族路径</summary>
public const string ChartCreate = CreatePrefix + Chart;
public const string TableCreate = CreatePrefix + Table;
public const string UICreate = CreatePrefix + UI;
/// <summary>组件上下文菜单前缀(后接 组件类型/叶子,例如 "Image/Replace To/Xeric Image")</summary>
public const string ContextPrefix = "CONTEXT/";
}
}