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
@@ -0,0 +1,68 @@
using UnityEngine;
using XericUI.XChart.Mesh;
namespace XericUI.XChart.Space
{
/// <summary>
/// 工具级变换:<b>作用在立方体局部空间里</b>的一个仿射(缩放 → 旋转 → 平移)。
///
/// <para><b>单位</b>:立方体局部空间是"半边长 1"的归一化域(顶点在 ±1),所以
/// <see cref="Position"/> 的 1 就是立方体边界、<see cref="Scale"/> 的 1 就是原尺寸。
/// 这样工具自己不用关心像素,也不用关心图表当前多大。</para>
///
/// <para><b>和基变换的关系</b>:投影时算的是 <c>Base ∘ Tool</c>(先工具、后基),
/// 由 <see cref="XericUI.XChart.Mesh.XChartCubeView.Compose"/> 复合,
/// 结果仍然是一个仿射矩阵,所以面帧依旧落在平行四边形那一档(协议见
/// <see cref="XChartFaceFrame"/>)。</para>
/// </summary>
[System.Serializable]
public struct XChartToolTransform
{
[SerializeField] private Vector3 m_Position;
[SerializeField] private Quaternion m_Rotation;
[SerializeField] private Vector3 m_Scale;
/// <summary>
/// 结构体不能有字段初始化器,所以<b>单位变换只能由 <see cref="Identity"/> 或这个构造给</b>。
/// 直接 <c>new XChartToolTransform()</c> 会得到 scale=0(整个塌成一个点),
/// 现象很扎眼但不是语义——所有配置字段都写成 <c>= XChartToolTransform.Identity</c>。
/// </summary>
public XChartToolTransform(Vector3 position, Quaternion rotation, Vector3 scale)
{
m_Position = position;
m_Rotation = rotation;
m_Scale = scale;
}
/// <summary>立方体局部空间里的平移(1 = 到立方体边界)</summary>
public Vector3 Position { get => m_Position; set => m_Position = value; }
/// <summary>工具自身的旋转(四元数,和基变换同样不拆角度)</summary>
public Quaternion Rotation { get => m_Rotation; set => m_Rotation = value; }
/// <summary>各轴缩放(1 = 原尺寸)</summary>
public Vector3 Scale { get => m_Scale; set => m_Scale = value; }
public static XChartToolTransform Identity
=> new XChartToolTransform { Scale = Vector3.one };
/// <summary>是否等于不做任何事(用来走"省掉复合"的快速路径)</summary>
public bool IsIdentity => m_Position == Vector3.zero
&& m_Rotation == new Quaternion(0f, 0f, 0f, 1f)
&& m_Scale == Vector3.one;
/// <summary><c>T * R * S</c>(线性 + 平移,最后一行恒 0,0,0,1)</summary>
public Matrix4x4 Build()
{
Matrix4x4 r = XChartCubeView.ToMatrix(m_Rotation);
var m = new Matrix4x4
{
m00 = r.m00 * m_Scale.x, m01 = r.m01 * m_Scale.y, m02 = r.m02 * m_Scale.z, m03 = m_Position.x,
m10 = r.m10 * m_Scale.x, m11 = r.m11 * m_Scale.y, m12 = r.m12 * m_Scale.z, m13 = m_Position.y,
m20 = r.m20 * m_Scale.x, m21 = r.m21 * m_Scale.y, m22 = r.m22 * m_Scale.z, m23 = m_Position.z,
m30 = 0f, m31 = 0f, m32 = 0f, m33 = 1f,
};
return m;
}
}
}