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
+106
View File
@@ -0,0 +1,106 @@
using System;
using UnityEngine;
using XericUI.XChart.Mesh;
namespace XericUI.XChart.Space
{
/// <summary>
/// 空间(基变换)元素的配置——<b>整张图的坐标系就是这一份</b>。
///
/// <para>图表在初始化时会保证图里一定有一个 <see cref="ChartToolSpace"/>:两条注册路径
/// 都没登记时自动补一个默认的。想调它就在层级面板里加这个元素(<b>加出来的是同一个名字
/// "Space",所以不会和默认的那个并存</b>),或者在脚本里直接改 <c>chart.Space</c>。</para>
///
/// <para><b>渲染只看一个量:四元数 <see cref="Rotation"/></b>。没有相机、没有焦距、没有第二处
/// 输入;尺寸也只有一个量(半边长)。理由与换算见 <see cref="XChartCubeView"/>。</para>
///
/// <para><b>预设是按钮不是模式</b>:选一次预设 = 把那个四元数写进 <see cref="Rotation"/>,
/// 选择器随即回到"手动"。所以不存在"选了预设,Rotation 字段就失效"这种事——
/// 想在等距基础上再拧一点,直接改 Rotation 就行。</para>
/// </summary>
[Serializable]
[XChartElement("space", "空间(基变换)", -1000)]
public sealed class XChartSpaceConfig : XChartElementConfig
{
[Header("基变换")]
[SerializeField, Tooltip("立方体半边长(UI 像素):真实边长的一半,也等于面心到中心的距离")]
private float m_HalfEdge = 120f;
[SerializeField, Tooltip("视角预设:<b>一次性动作,不是模式</b>。选它在写入的那一刻把预设四元数灌进下面的 Rotation," +
"然后自己回到\"手动\"。渲染永远只读 Rotation。")]
private XChartCubeViewPreset m_ViewPreset = XChartCubeViewPreset.Manual;
[SerializeField, Tooltip("姿态四元数(x,y,z,w)——<b>唯一的旋转权威量</b>:没有相机、没有第二处输入")]
private Quaternion m_Rotation = XChartCubeView.RotationOf(XChartCubeViewPreset.Isometric);
[SerializeField, Tooltip("尺寸口径:半边长(尺度与旋转无关)/ 视口适配(铺满固定矩形,转起来会变小)")]
private XChartCubeSizeMode m_SizeMode = XChartCubeSizeMode.HalfEdgeLength;
[SerializeField, Tooltip("立方体中心在图表局部像素里的偏移")]
private Vector2 m_CenterOffset = Vector2.zero;
/// <summary>元素在 ToolsRoot 下的名字(和图表自动补的那个是同一个,所以不会并存)</summary>
public override string ElementName => ChartToolSpace.DefaultToolName;
/// <summary>当前姿态(渲染唯一权威)。写它=放弃预设、手动定角度(与面板上直接改四元数同一条路)</summary>
public Quaternion Rotation
{
get => m_Rotation;
set { m_Rotation = value; m_ViewPreset = XChartCubeViewPreset.Manual; }
}
/// <summary>半边长(UI 像素)</summary>
public float HalfEdge { get => m_HalfEdge; set => m_HalfEdge = Mathf.Max(0.01f, value); }
/// <summary>尺寸口径(半边长 / 视口适配)</summary>
public XChartCubeSizeMode SizeMode { get => m_SizeMode; set => m_SizeMode = value; }
/// <summary>中心偏移(图表局部像素)</summary>
public Vector2 CenterOffset { get => m_CenterOffset; set => m_CenterOffset = value; }
/// <summary>一步跳到某个预设视角:等价于把那个四元数写进 <see cref="Rotation"/></summary>
public void ApplyViewPreset(XChartCubeViewPreset preset)
{
if (preset == XChartCubeViewPreset.Manual) return;
m_Rotation = XChartCubeView.RotationOf(preset);
m_ViewPreset = XChartCubeViewPreset.Manual;
}
/// <summary>
/// 把预设当按钮用:非"手动"时把预设四元数写进 <see cref="m_Rotation"/>,随即把选择器复位。
/// 这样"改一下当前视角"和"从某个预设起步"用的是同一个字段,不存在"预设挡着 Rotation 让它失效"。
/// </summary>
private void ConsumeViewPreset()
{
if (m_ViewPreset == XChartCubeViewPreset.Manual) return;
m_Rotation = XChartCubeView.RotationOf(m_ViewPreset);
m_ViewPreset = XChartCubeViewPreset.Manual;
}
public override XChartToolBase CreateTool() => new ChartToolSpace();
public override void ApplyTo(XChartToolBase tool)
{
ConsumeViewPreset();
if (!(tool is ChartToolSpace space)) return;
space.Rotation = m_Rotation;
space.HalfEdge = m_HalfEdge;
space.SizeMode = m_SizeMode;
space.CenterOffset = m_CenterOffset;
// 基变换变了要立刻让版本号走,下游元素下次渲染就会重投影
space.MarkProjectionDirty();
}
public override void CaptureFrom(XChartToolBase tool)
{
if (!(tool is ChartToolSpace space)) return;
m_HalfEdge = space.HalfEdge;
m_SizeMode = space.SizeMode;
m_CenterOffset = space.CenterOffset;
m_Rotation = space.Rotation;
}
}
}