diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md
index 07d5c8b..bd2a428 100644
--- a/Documentation/XChart-RenderFramework.md
+++ b/Documentation/XChart-RenderFramework.md
@@ -1611,6 +1611,10 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
**为什么这比"可编辑"更强**:序号一旦能手填,就会出现两条口径(位置 vs 数字)指向不同的事实,
"上移之后绘制顺序到底变没变"这个问题就没人回答得了。绑定之后**位置是唯一权威**。
+**落法(代码侧,2026-10-25 同日)**:面板的 `AfterStructureChange()` 里调 `RenumberDrawOrder()`——
+任何结构变化(上移/下移/加/删)之后把表内每个元素的 `m_DrawOrder` 重写成它的位置(0,1,2…)。
+于是"位置更靠后=绘得更晚=盖在上面"。面板上 `R… D…` 只是这两个数的**读数**(`RefreshOrderReadouts` 就地刷新)。
+
**终态(2026-10-25,交付树上复跑那一跑)**:`p4_control` **52/52** 支臂各红在自己点名的断言上;
探针 **424** 项 **0** 失败;`p2_control` 4 臂、`pool_family`、`generator_gate` 2 变异、`hierarchy_gate` 5 变异全绿;
编译门三臂 + 3 支对照绿。产物:`.ximage-gate/` 下 `gate_p15b.txt`、`probe_p15.txt`、`p4_p15.txt`、
@@ -1699,12 +1703,22 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
### 25.7 判据与账(初版实现随 25 小节口径一起改)
-- 探针:`vector field` / `vector field colour` 一族(末端算式、两种读法必须分开、色环 0..256、门口拒 NaN)。
-- `p4_control`:新增三支臂(相对被读成绝对、色环按 0..1 读、颜色门口放 NaN 进来)各红在点名断言上。
+- 探针:`vector field` / `vector field colour` 一族(末端算式、两种读法必须分开、色环 0..256、门口拒 NaN,
+ 以及**支数** `ArrowCount`:N 条记录 N−1 支、上限裁剪、0/1 条记录⇒0 支)。
+- `p4_control`:新增五支臂(相对被读成绝对、色环按 0..1 读、颜色门口放 NaN 进来、
+ 一对不再花两条记录、空表不挡而直接进算术)各红在点名断言上。
- 编译门三臂绿;`p2` / `family` / `generator_gate` / `hierarchy_gate` 在交付树上复跑。
+- **终态(2026-10-25,口径修正后的交付树那一跑)**:探针 **439** 项 **0** 失败;`p4_control` **57/57** 支臂
+ 各红在自己点名的断言上;`p2_control` 4 臂 / `pool_family` / `generator_gate` 2 变异 /
+ `hierarchy_gate` 5 变异全绿;编译门三臂 + 3 支对照绿。产物:`.ximage-gate/chain_p17fix.txt`(每套一行 rc)。
- **覆盖不到什么**:箭头在画面上长什么样、两种读法看起来是不是"刺猬/首尾相接"、互斥那一项藏没藏对——
离线一条都判不了(mono 造不出真 `VisualElement`,§13.2),归他现场判。
+**判据的判据(本轮第三次同类现形)**:我给"一对不再花两条记录"那支臂点名的清单里放了两条,
+其中"一条记录⇒0 支"这条**在这支变异体下根本碰不到**——它被更前面的 `recordCount < 2` 守卫挡住了,
+于是 `did not go red` 当场把这条假点名抓了出来。⇒ 规矩不变:**点名清单按实测改**;
+给每条判据配**它自己那支**变异体(这次补了"空表不挡而直接进算术"那一支专门管零/一条记录)。
+
### 25.8 他侧验收(Ctrl+R 后)
1. `工具 → Add → 向量箭头`,数据窗口 `测试 → 螺旋矢量场`:立刻看到箭头。
@@ -1716,5 +1730,6 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
- **曲线渲染器**:现在是直线段(他给的默认)。库里那个带矢量标签的曲线渲染器 + "箭头位置可调"
排下一轮(`UICurveRenderer`,注意 §10.4:整条一次提交,别逐段 `DrawLine`)。
-- **两端各自颜色**的渲染侧支持:现在每支一个色(读起始记录的颜色维),
- 要做到"起点色 ≠ 终点色、沿杆渐变"需要填充渲染器支持逐顶点双色。
+- **两端各自颜色**的渲染侧支持:**现在杆用起点色、头用终点色**(读第 i 与第 i+1 两条记录各自的颜色维)
+ ⇒ 两条记录颜色不同时,一支箭头上就能看到两种颜色。真正的"沿杆逐顶点渐变"要等填充渲染器支持
+ 逐顶点双色(P18,模板已有"径向渐变"那一档可参照)。
diff --git a/Editor/XChart/XChartBaseEditor.cs b/Editor/XChart/XChartBaseEditor.cs
index 534768c..49e20ca 100644
--- a/Editor/XChart/XChartBaseEditor.cs
+++ b/Editor/XChart/XChartBaseEditor.cs
@@ -217,30 +217,41 @@ namespace XericUI.XChart.Editor
};
head.Add(orderText);
m_OrderReadouts.Add(new OrderReadout { Order = order, Draw = drawOrder, Text = orderText });
- head.Add(MakeTinyButton("↑", () => MoveElement(index, -1), "上移(与上一项交换注册位置)"));
- head.Add(MakeTinyButton("↓", () => MoveElement(index, 1), "下移(与下一项交换注册位置)"));
+ head.Add(MakeTinyButton("↑", () => MoveElement(index, -1),
+ "上移一位:它在表里更靠前 ⇒ 绘得更早,会被后面的元素盖住"));
+ head.Add(MakeTinyButton("↓", () => MoveElement(index, 1),
+ "下移一位:它在表里更靠后 ⇒ 绘得更晚,盖住前面的元素"));
head.Add(MakeTinyButton("-", () => RemoveElement(index),
"删除这个元素。默认元素(空间 / BG Cube Wire / BG Cube Grid)**也能删**——"
+ "删了就是不要它;预设不会在之后又把它补回来(只在第一次读到这张表时补齐缺的那几件)"));
- // 序号的**写入口**在 Body 里(标题行只读):改完标题那一行就地跟着变(见 OnValueChanged)
- var orderRow = new VisualElement { style = { flexDirection = FlexDirection.Row } };
- if (order != null) orderRow.Add(MakeField(order, "注册序"));
- if (drawOrder != null) orderRow.Add(MakeField(drawOrder, "绘制序"));
- block.Body.Add(orderRow);
+ // ★ 序号没有写入口(他 2026-10-25):注册序由类型定好、绘制序跟元素在表里的位置走(§24.5)。
+ // 位置是唯一权威——再多两个手填的格子,就会出现"位置与数字各说一套",
+ // 而"上移之后绘制顺序到底变没变"这个问题就没人回答得了。
- // 这个元素要几个数值维、表里现在有几个——两个数一起印(§25)。
- // "加了工具但什么都没显示"最常见的原因就是这一对不上,而画面上两者长得一模一样。
+ // 这个元素要几个数值维、几条记录,表里现在各有多少——**三个数一起印**(§25.1)。
+ // "加了工具但什么都没显示"最常见的原因就是形状不够,而画面上两者长得一模一样。
if (config.RequiredNumericDimensions > 0)
{
- int have = chart != null && chart.DataModel != null
+ int haveDims = chart != null && chart.DataModel != null
? chart.DataModel.NumericDimensionCount
: 0;
- int need = config.RequiredNumericDimensions;
- block.Body.Add(MakeReadonly(have < need
- ? "需要 " + need + " 个数值维,表现在有 " + have + " 个 ⇒ 一条都不画(报表里 dims="
- + have + "/" + need + ")"
- : "需要 " + need + " 个数值维,表现在有 " + have + " 个"));
+ int haveRecords = chart != null && chart.DataModel != null
+ ? chart.DataModel.RecordCount
+ : 0;
+ int needDims = config.RequiredNumericDimensions;
+ int needRecords = config.RequiredRecordCount;
+
+ string dimsPart = "需要 " + needDims + " 个数值维,表现在有 " + haveDims + " 个";
+ string recordsPart = needRecords > 0
+ ? ";需要 " + needRecords + " 条记录,表现在有 " + haveRecords + " 条"
+ : string.Empty;
+ bool shortOfShape = haveDims < needDims || haveRecords < needRecords;
+ block.Body.Add(MakeReadonly(dimsPart + recordsPart
+ + (shortOfShape
+ ? " ⇒ 画不出来(报表里 dims=" + haveDims + "/" + needDims
+ + " records=" + haveRecords + ")"
+ : string.Empty)));
}
AppendHeaderGroups(block.Body, elementProp, elementProp.propertyPath);
@@ -1079,6 +1090,9 @@ namespace XericUI.XChart.Editor
private void AfterStructureChange()
{
+ // 结构一变就把**绘制序按表内位置重排**(他 2026-10-25 的政策:位置就是层序,§24.5)
+ serializedObject.Update();
+ RenumberDrawOrder();
m_ElementSignature = ComputeSignature(ElementsProp());
var chart = target as XChartBase;
if (chart != null) chart.RebuildElements();
@@ -1086,6 +1100,27 @@ namespace XericUI.XChart.Editor
Repaint();
}
+ ///
+ /// 把每个元素的**绘制序**重写成它在表里的位置(0,1,2…):位置更靠后=绘得更晚=盖在上面。
+ /// 他只调位置(↑↓),不再有第二个手填的绘制序号——两条口径指向不同事实时,
+ /// "上移之后绘制顺序变没变"就没人回答得了(§24.5)。
+ ///
+ private void RenumberDrawOrder()
+ {
+ var list = ElementsProp();
+ if (list == null) return;
+
+ bool changed = false;
+ for (int i = 0; i < list.arraySize; i++)
+ {
+ var drawOrder = list.GetArrayElementAtIndex(i).FindPropertyRelative("m_DrawOrder");
+ if (drawOrder == null || drawOrder.intValue == i) continue;
+ drawOrder.intValue = i;
+ changed = true;
+ }
+ if (changed) serializedObject.ApplyModifiedProperties();
+ }
+
private static string ComputeSignature(SerializedProperty list)
{
if (list == null) return string.Empty;
diff --git a/Editor/XChart/XChartDataGenerators.cs b/Editor/XChart/XChartDataGenerators.cs
index 1475ab7..ea4cfb5 100644
--- a/Editor/XChart/XChartDataGenerators.cs
+++ b/Editor/XChart/XChartDataGenerators.cs
@@ -12,8 +12,8 @@ namespace XericUI.XChart.Editor
///
public static class XChartDataGenerators
{
- /// 螺旋矢量场一条记录占的数值维:起点 3 + 第二点 3 + 颜色 3(色相/饱和/明度)
- public const int VectorFieldDimensions = 9;
+ /// 螺旋矢量场一条记录占的数值维:坐标 3 + 颜色 4(色相/饱和/明度/不透明度)
+ public const int VectorFieldDimensions = 7;
/// 螺旋上参数 t∈[0,1] 的那个点(一圈正弦/余弦配线性 x)
private static void Spiral(float t, out float x, out float y, out float z)
@@ -41,15 +41,17 @@ namespace XericUI.XChart.Editor
}
///
- /// 螺旋矢量场:一条记录 9 个数值维 [x, y, z, nx, ny, nz, h, s, v]——
- /// 前三维是这一条的点,中三维是下一个点,后三维是颜色(色相 0..256 走色环,饱和/明度都是 1)。
+ /// 螺旋矢量场:一圈正弦/余弦点,**每条记录 7 个数值维** [x, y, z, h, s, v, a]——
+ /// 前三维是这条记录的坐标(与圆柱/散点同一套口径),后四维是颜色
+ /// (色相 0→256 走满一圈色环、饱和/明度 1、不透明度 1)。
///
- /// 为什么中三维取"下一个点":两种读法都能一眼分出来(他 2026-10-25 的描述)——
+ /// 箭头由**相邻两条记录**构成(规范 §25.2),所以两种读法在这份数据上一眼可辨(他 2026-10-25):
/// 相对:箭头由本点指向下一点 ⇒ 一串首尾相接、顺着螺旋转;
- /// 绝对:后三维当方向矢量用 ⇒ 每根朝"下一点的坐标方向"散开,看起来像一片刺猬。
+ /// 绝对:下一点的坐标当方向矢量 ⇒ 每根朝"下一点的坐标方向"散开,看起来像一片刺猬。
+ /// 又因为颜色随记录自带,一串箭头的起点色与终点色**各自不同**。
///
/// 维数不够会先把列补出来(测试数据的判据是"点一下就能看到东西",
- /// 而不是"提示他先去加六列");表里原有的记录会被清掉——它就是一份示例数据。
+ /// 而不是"提示他先去加四列");表里原有的记录会被清掉——它就是一份示例数据。
///
public static int AppendSpiralVectorField(XChartDataModel model, int count)
{
@@ -64,12 +66,11 @@ namespace XericUI.XChart.Editor
for (int i = 0; i < count; i++)
{
float t = count > 1 ? i / (float)(count - 1) : 0f;
- float tNext = count > 1 ? (i + 1) / (float)(count - 1) : 0f;
Spiral(t, out values[0], out values[1], out values[2]);
- Spiral(tNext, out values[3], out values[4], out values[5]);
- values[6] = 256f * t; // 色相:0..256 正好走完一圈色环
- values[7] = 1f; // 饱和度
- values[8] = 1f; // 明度
+ values[3] = 256f * t; // 色相:0..256 正好走完一圈色环
+ values[4] = 1f; // 饱和度
+ values[5] = 1f; // 明度
+ values[6] = 1f; // 不透明度
if (!TryAppend(model, values)) break;
accepted++;
}
diff --git a/Editor/XChart/XChartDataWindow.cs b/Editor/XChart/XChartDataWindow.cs
index 234e273..41cd1a5 100644
--- a/Editor/XChart/XChartDataWindow.cs
+++ b/Editor/XChart/XChartDataWindow.cs
@@ -129,7 +129,7 @@ namespace XericUI.XChart.Editor
toolbar.Add(MakeMenu("清空", ("清空全部记录", (Action)ClearData)));
toolbar.Add(MakeMenu("测试",
("螺旋 32(一圈正弦/余弦)", AppendTestSpiral),
- ("螺旋矢量场 32(9 维:起点+第二点+色相/饱和/明度)", AppendTestVectorField),
+ ("螺旋矢量场 32(7 维:坐标 + 色相/饱和/明度/不透明)", AppendTestVectorField),
("平方和金字塔 30(1+4+9+16)", AppendTestPyramid)));
toolbar.Add(new ToolbarButton(ForceRefreshNow) { text = "强制刷新", tooltip = "改完数据直接重画一次图,不用回界面乱点" });
diff --git a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs
index 232262d..dc20c7b 100644
--- a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs
+++ b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs
@@ -8,37 +8,40 @@ using XericUI.XChart.Space;
namespace XericUI.XChart.Mesh
{
///
- /// 向量场 / 流形箭头元素:一条记录占 6 个数值维——两组三维,
- /// 按 解释成一支箭头(绝对=方向矢量 / 相对=第二个点)。
- /// 后面可以再接 3~4 维颜色(色相/饱和度/明度 [+不透明度]),见 。
+ /// 向量场 / 流形箭头元素。**数据口径(规范 §25.2,2026-10-25 他澄清后定稿)**:
+ /// 前三维=坐标 x/y/z(与圆柱、散点同一套归一化),一支箭头=相邻两条记录
+ /// (第 i 条是起点,第 i+1 条按 解释成"第二个点"或"方向矢量"),
+ /// 第 4~7 维是颜色(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,可选)。
///
- /// 两种读法(他 2026-10-25 口述):
- /// 绝对 ⇒ 后三维是方向本身,起点加方向乘倍率就是末端(螺旋点画出来是一片"刺猬");
- /// 相对 ⇒ 后三维是第二个点,箭头是第一点指向第二点(一串首尾相接的点读起来就是"连着头转")。
+ /// 两种读法:绝对 ⇒ 第二条记录的坐标就是方向(起点 + 方向×倍率),螺旋点画出来是一片"刺猬";
+ /// 相对 ⇒ 它是第二个点(起点 + 差向量×倍率),一串首尾相接的点读起来就是"连着头转"。
///
- /// 连续绘制:把所有记录的第一组三维按顺序连成折线(只有最后一段带箭头)。
+ /// 连续绘制:把每条记录的坐标按顺序连成折线(只有最后一段带箭头);
/// 这时"相对/绝对"不适用 ⇒ 配置里那一项隐藏(互斥显示)。
///
- /// 箭头是自己拼的,没有用库里的 ArrowShape:那套箭头是给曲线的屏幕空间
- /// 图元用的,而这里的箭头必须跟着立方体姿态走(投影后长短和方向都在变)。做法是
- /// 只让空间负责两端的投影,杆和头都在像素空间里量出来:杆是一段等宽四边形,
- /// 头是一个退化四边形(三角形),宽度恒定所以任何姿态下都不会塌成一条线。
+ /// 两端各自的颜色:起点读第 i 条记录、终点读第 i+1 条 ⇒ 两支记录颜色不同时,
+ /// 杆与头**各显一色**。真正的"沿杆逐顶点渐变"要等渲染器支持逐顶点双色(P18)。
+ ///
+ /// 箭头是自己拼的,没有用库里的 ArrowShape:那套箭头是给曲线的屏幕空间图元用的,
+ /// 而这里的箭头必须跟着立方体姿态走(投影后长短和方向都在变)。做法是只让空间负责两端的投影,
+ /// 杆和头都在像素空间里量出来:杆是一段等宽四边形,头是一个退化四边形(三角形),
+ /// 宽度恒定所以任何姿态下都不会塌成一条线。
///
/// 数据只经过中转接口:按维度下标 逐条取,
- /// 不碰记录数组;条数由 兜住,免得十万条记录一口气投影。
+ /// 不碰记录数组;支数由 兜住,免得十万条记录一口气投影。
///
[AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Vector Arrow Tool")]
public sealed class ChartToolVectorArrows : XChartToolBase
{
- /// 起点的维度下标(矢量再占三维,颜色再往后)
- public int OriginDimension { get; set; }
- /// 两组三维怎么读成一支箭头
+ /// 坐标的维度下标(x/y/z 三维)
+ public int CoordinateDimension { get; set; }
+ /// 第二条记录怎么读成方向
public XChartArrowVectorMode VectorMode { get; set; } = XChartArrowVectorMode.Absolute;
- /// 把每条记录的第一个点按顺序连成折线(此时相对/绝对不适用)
+ /// 把每条记录的坐标按顺序连成折线(此时相对/绝对不适用)
public bool Continuous { get; set; }
/// 方向向量的长度倍率(立方体单位);相对模式下作用在差向量上
public float DirectionScale { get; set; } = 0.25f;
- /// 最多画多少条(数据再多也只取前 N 条,避免一次性铺满)
+ /// 最多画多少支(一支=相邻两条记录)
public int MaxArrowCount { get; set; } = 512;
/// 箭头自己的变换(叠在图的空间之上)
@@ -49,7 +52,7 @@ namespace XericUI.XChart.Mesh
/// 是否用额外的数值维给每支箭头上色
public bool UseColorDimensions { get; set; }
/// 颜色维的起点(色相、饱和度、明度 [+不透明度])
- public int ColorDimension { get; set; } = 6;
+ public int ColorDimension { get; set; } = 3;
/// 是否多读一维不透明度
public bool HasAlphaDimension { get; set; }
@@ -69,10 +72,11 @@ namespace XericUI.XChart.Mesh
private readonly List m_Faces = new List(256);
- // 本帧的自述读数:算了几支 / 表里几个数值维 / 够不够
+ // 本帧的自述读数:算了几支 / 表里几个数值维 / 需要几个 / 几条记录
private int m_ArrowsBuilt;
private int m_DimensionsHave;
private int m_DimensionsNeed;
+ private int m_RecordsHave;
private struct ArrowFace
{
@@ -90,13 +94,16 @@ namespace XericUI.XChart.Mesh
public void MarkDirty() => m_Dirty = true;
///
- /// 这个元素要几个数值维:矢量 6 +(可选)颜色 3。
- /// 不透明度那一维不算硬需求:它多给就多读、没给就退回单色的 alpha——
- /// 把它算进门槛的话,勾一下"有不透明度"会让整个元素突然一条都不画(维数不够),
+ /// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。
+ /// 不透明度那一维不算硬需求:多给就多读、没给退回单色 alpha——
+ /// 把它算进门槛的话,勾一下"有不透明度"会让整个元素突然一条都不画,
/// 那是把这一个开关变成了总闸。
///
public int RequiredDimensionCount
- => XChartArrowConfig.VectorDimensionCount + (UseColorDimensions ? 3 : 0);
+ => XChartArrowConfig.CoordinateDimensionCount + (UseColorDimensions ? XChartArrowConfig.ColorDimensionCount : 0);
+
+ /// 一支箭头要两条记录
+ public int RequiredRecordCount => 2;
protected override void OnInitialize()
{
@@ -145,19 +152,21 @@ namespace XericUI.XChart.Mesh
m_Faces.Clear();
m_ArrowsBuilt = 0;
m_DimensionsHave = 0;
+ m_RecordsHave = 0;
m_DimensionsNeed = RequiredDimensionCount;
var source = Data;
if (source == null || !source.HasData) return;
m_DimensionsHave = source.NumericDimensionCount;
- // 维数不够就一条都不画(现象是"加了工具但什么都没显示")——需求与实际两个数都留在报表里,
- // 面板也会印同一对(规范 §25)
- if (m_DimensionsHave < OriginDimension + RequiredDimensionCount) return;
+ m_RecordsHave = source.RecordCount;
+ // 形状不够就一支都不画(现象是"加了工具但什么都没显示")——需求与实际几个数都留在报表里,
+ // 面板也印同一对(规范 §25.1)
+ if (m_DimensionsHave < CoordinateDimension + RequiredDimensionCount) return;
+ if (m_RecordsHave < RequiredRecordCount) return;
- int records = source.RecordCount;
- int limit = records;
- if (MaxArrowCount > 0 && MaxArrowCount < limit) limit = MaxArrowCount;
+ // 一支箭头=相邻两条记录 ⇒ 支数由纯算术算(离线钉着:记录不够 vs 维数不够要分得清)
+ int limit = XChartVectorFieldMath.ArrowCount(m_RecordsHave, MaxArrowCount);
if (Continuous)
{
@@ -168,40 +177,42 @@ namespace XericUI.XChart.Mesh
for (int i = 0; i < limit; i++)
{
- Vector3 first = ReadPoint(source, i, OriginDimension);
- Vector3 second = ReadPoint(source, i, OriginDimension + 3);
- // 两种读法的算式在纯算术里(离线钉着):绝对=后三维就是方向;相对=后三维是第二个点
+ Vector3 first = ReadPoint(source, i);
+ Vector3 second = ReadPoint(source, i + 1);
+ // 两种读法的算式在纯算术里(离线钉着):绝对=第二条的坐标就是方向;相对=它是第二个点
Vector3 tip = XChartVectorFieldMath.Tip(VectorMode, first, second, DirectionScale);
-
- if (AddArrow(space, first, tip, ColorAt(source, i))) m_ArrowsBuilt++;
+ if (AddArrow(space, first, tip, ColorAt(source, i), ColorAt(source, i + 1))) m_ArrowsBuilt++;
}
m_Faces.Sort(s_FarToNear);
}
///
- /// 连续绘制:把所有记录的第一个点按顺序连成一条折线,只有最后一段带箭头。
- /// 读的是每组的第一组三维(坐标),后面那几维(方向/第二点/颜色维)在这种模式下不参与——
- /// 连起来的本来就是空间里的一条路径。
+ /// 连续绘制:把每条记录的坐标按顺序连成折线,只有最后一段带箭头。
+ /// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了)。
///
private void BuildContinuous(IXChartDataSource source, ChartToolSpace space, int limit)
{
- if (limit < 2) return;
+ if (limit < 1) return;
- Vector3 previous = ReadPoint(source, 0, OriginDimension);
- for (int i = 1; i < limit; i++)
+ Vector3 previous = ReadPoint(source, 0);
+ for (int i = 1; i <= limit; i++)
{
- Vector3 current = ReadPoint(source, i, OriginDimension);
- bool last = i == limit - 1;
- // 段用"到达点"的颜色(最后一段的箭头也用它):一串颜色维读下来就是沿路径渐变
- AddArrow(space, previous, current, ColorAt(source, i), last);
+ Vector3 current = ReadPoint(source, i);
+ bool last = i == limit;
+ // 段用"到达点"的颜色(最后一段的箭头用终点色):一串颜色维读下来就是沿路径渐变
+ AddArrow(space, previous, current, ColorAt(source, i - 1), ColorAt(source, i), last);
m_ArrowsBuilt++;
previous = current;
}
}
- /// 一支箭头 = 杆 +(可选)头。退化(零长度)时按开关画成一个小方块
- private bool AddArrow(ChartToolSpace space, Vector3 origin, Vector3 tip, Color color, bool withHead = true)
+ ///
+ /// 一支箭头 = 杆(用起点色)+(可选)头(用终点色)。
+ /// 两端各显一色是颜色维"随记录自带"的直接结果;真正的沿杆渐变要等渲染器支持逐顶点双色(P18)。
+ ///
+ private bool AddArrow(ChartToolSpace space, Vector3 origin, Vector3 tip, Color startColor, Color endColor,
+ bool withHead = true)
{
Vector2 from = space.Project(origin, m_Composed);
Vector2 to = space.Project(tip, m_Composed);
@@ -220,30 +231,30 @@ namespace XericUI.XChart.Mesh
C = from + new Vector2(1f, 1f),
D = from + new Vector2(1f, -1f),
Depth = depth,
- Color = color,
+ Color = startColor,
});
return true;
}
m_Faces.Add(new ArrowFace
{
- A = shaftA, B = shaftB, C = shaftC, D = shaftD, Depth = depth, Color = color,
+ A = shaftA, B = shaftB, C = shaftC, D = shaftD, Depth = depth, Color = startColor,
});
if (!withHead) return true;
m_Faces.Add(new ArrowFace
{
- A = headA, B = headB, C = headC, D = headD, Depth = depth, Color = color,
+ A = headA, B = headB, C = headC, D = headD, Depth = depth, Color = endColor,
});
return true;
}
- private static Vector3 ReadPoint(IXChartDataSource source, int record, int dimension)
+ private Vector3 ReadPoint(IXChartDataSource source, int record)
{
return new Vector3(
- (float)source.GetValueAt(record, dimension),
- (float)source.GetValueAt(record, dimension + 1),
- (float)source.GetValueAt(record, dimension + 2));
+ (float)source.GetValueAt(record, CoordinateDimension),
+ (float)source.GetValueAt(record, CoordinateDimension + 1),
+ (float)source.GetValueAt(record, CoordinateDimension + 2));
}
///
@@ -255,7 +266,7 @@ namespace XericUI.XChart.Mesh
private Color ColorAt(IXChartDataSource source, int record)
{
if (!UseColorDimensions) return ArrowColor;
- if (source.NumericDimensionCount < ColorDimension + 3) return ArrowColor;
+ if (source.NumericDimensionCount < ColorDimension + XChartArrowConfig.ColorDimensionCount) return ArrowColor;
float hue = (float)source.GetValueAt(record, ColorDimension);
float saturation = (float)source.GetValueAt(record, ColorDimension + 1);
@@ -276,14 +287,15 @@ namespace XericUI.XChart.Mesh
#if UNITY_EDITOR
///
- /// 报表里点名这一帧:维数(现有/需要)+算了几支+读法+面数/块数。
- /// "加了工具什么都没显示"这件事只有这一行分得清是"维数不够"还是"算了但没提交"
- /// (他 2026-10-25 现场;规范 §25)。
+ /// 报表里点名这一帧:维数(现有/需要)与记录数+算了几支+读法+颜色来源+面数/块数。
+ /// "加了工具什么都没显示"这件事只有这一行分得清是"维数不够"还是"记录不够"还是"算了但没提交"
+ /// (他 2026-10-25 现场;规范 §25.1)。
///
internal override void AppendDebugLine(System.Text.StringBuilder sb)
{
base.AppendDebugLine(sb);
sb.Append(" dims=").Append(m_DimensionsHave).Append('/').Append(m_DimensionsNeed)
+ .Append(" records=").Append(m_RecordsHave)
.Append(" arrows=").Append(m_ArrowsBuilt)
.Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute"))
.Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single")
diff --git a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
index ad2831a..de4e9a9 100644
--- a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
+++ b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
@@ -22,6 +22,20 @@ namespace XericUI.XChart.Mesh
return first + direction * scale;
}
+ ///
+ /// 一支箭头=相邻两条记录 ⇒ 给定记录数与上限,能画出几支(上限 ≤0 =不限)。
+ ///
+ /// 单列出来是因为"记录不够"与"维数不够"在画面上完全同形(都是一条都不画),
+ /// 而 N−1 与 0 这两个数是唯一分得清它们的读数(规范 §25.1)。
+ ///
+ public static int ArrowCount(int recordCount, int maxArrows)
+ {
+ if (recordCount < 2) return 0;
+ int pairs = recordCount - 1;
+ if (maxArrows > 0 && maxArrows < pairs) return maxArrows;
+ return pairs;
+ }
+
///
/// 读一组颜色维: 按 0..256 的色环(256 与 0 是同一个颜色,
/// 取模,所以 300 也读得动),饱和度/明度/不透明度按 0..1 夹住。
diff --git a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs
index ba03791..a330586 100644
--- a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs
+++ b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs
@@ -126,45 +126,44 @@ namespace XericUI.XChart.Mesh
///
/// 向量箭头(矢量场)元素的配置。
///
- /// 一条记录怎么读:前 3 维是"一个点",后 3 维是"另一个点",
- /// 按 解释成一支箭头——
+ /// 数据口径(2026-10-25 他澄清后定稿,规范 §25.2):
///
- /// - (绝对):后 3 维是方向矢量本身,
- /// 起点 + 方向×倍率 = 箭头末端。螺旋点在这种读法下画出来是一片"刺猬"(每根朝外)。
- /// - (相对):后 3 维是第二个点,
- /// 箭头 = 第一点指向第二点(差向量×倍率)。一串首尾相接的点在这种读法下就是"连着头往下转"。
+ /// - 前三维=坐标 x/y/z(立方体单位,与圆柱、散点同一套归一化)——不是"两组三维"。
+ /// - 一支箭头=相邻两条记录:第 i 条是起点,第 i+1 条按 解释成
+ /// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。
+ /// - 第 4~7 维是颜色:色相(0..256 色环)/ 饱和度 / 明度 / 不透明度,全部可选。
+ /// 颜色随记录自带 ⇒ 一支箭头的起点色与终点色可以不同(七维信息的那个用法)。
///
///
- /// 连续绘制():把所有记录的点按顺序连成一条折线——
- /// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两个选项**隐藏**
+ /// 连续绘制():把每条记录的坐标按顺序连成折线——
+ /// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两项**隐藏**
/// (互斥显示,见 )。
- ///
- /// 颜色是可选的额外维度:[h, s, v](可选 +a)接在矢量后面读,
- /// 于是"给每个点标颜色"不需要往表里塞非数值列——色相走 0..256 的色环,其余三个按 0..1。
///
[Serializable]
[XChartElement("arrows", "向量箭头", 50)]
public sealed class XChartArrowConfig : XChartElementConfig
{
- /// 3 维起点 + 3 维方向/第二点
- public const int VectorDimensionCount = 6;
+ /// 坐标要占几个数值维(x/y/z)
+ public const int CoordinateDimensionCount = 3;
+ /// 颜色要几个数值维(色相/饱和度/明度 [+不透明度])
+ public const int ColorDimensionCount = 3;
[Header("数据")]
- [SerializeField, Tooltip("起点从第几个数值维开始(一条记录要占 6 维:起点 3 + 方向或第二点 3)")]
- private int m_OriginDimension;
+ [SerializeField, Tooltip("坐标从第几个数值维开始(一条记录 3 维:x/y/z);一支箭头由**相邻两条记录**构成")]
+ private int m_CoordinateDimension;
- [SerializeField, Tooltip("绝对:后三维是方向矢量(起点→末端)。相对:后三维是第二个点," +
- "箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
+ [SerializeField, Tooltip("绝对:第二条记录的坐标当作方向矢量(起点→末端)。" +
+ "相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
- [SerializeField, Tooltip("把每条记录的点按顺序连成一条折线(只有最后一段带箭头)。" +
+ [SerializeField, Tooltip("把每条记录的坐标按顺序连成一条折线(只有最后一段带箭头)。" +
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
private bool m_Continuous;
[SerializeField, Tooltip("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")]
private float m_DirectionScale = 0.25f;
- [SerializeField, Range(0, 100000), Tooltip("最多画多少条(0=不限);防止十万条记录一口气铺满")]
+ [SerializeField, Range(0, 100000), Tooltip("最多画多少支(0=不限);防止十万条记录一口气铺满")]
private int m_MaxArrowCount = 512;
[SerializeField, Tooltip("箭头自己的变换(叠在图的空间之上)")]
@@ -174,9 +173,9 @@ namespace XericUI.XChart.Mesh
[SerializeField, Tooltip("用额外的数值维给每支箭头上色。三个维依次是 色相(0..256 色环) / 饱和度(0..1) / 明度(0..1)")]
private bool m_UseColorDimensions;
- [SerializeField, Tooltip("颜色三维从第几维开始(默认 6=紧跟在矢量后面)。" +
- "这些维**不进**前面的数据语义,只是被读走做颜色")]
- private int m_ColorDimension = VectorDimensionCount;
+ [SerializeField, Tooltip("颜色三维从第几维开始(默认 3=紧跟在坐标后面)。" +
+ "这些维**不进**坐标语义,只是被读走做颜色;起止两端各自读自己那条记录的颜色")]
+ private int m_ColorDimension = 3;
[SerializeField, Tooltip("再加一维不透明度(0..1),读颜色起点维 +3")]
private bool m_HasAlphaDimension;
@@ -197,11 +196,14 @@ namespace XericUI.XChart.Mesh
///
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
- /// 不透明度那一维**不算硬需求**(多给就多读、没给退回单色 alpha)——算进去就成了
- /// "勾一个开关,整个元素消失"。
+ /// 坐标 3 +(可选)颜色 3;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha)——
+ /// 算进门槛的话,勾一下"有不透明度"会让整个元素因维数不够突然消失。
///
public override int RequiredNumericDimensions
- => VectorDimensionCount + (m_UseColorDimensions ? 3 : 0);
+ => CoordinateDimensionCount + (m_UseColorDimensions ? ColorDimensionCount : 0);
+
+ /// 一支箭头要两条记录 ⇒ 记录少于 2 条时一支都画不出来(面板/报表同样要印出来)
+ public override int RequiredRecordCount => 2;
///
/// 互斥显示:连续绘制打开时「相对/绝对」没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
@@ -221,7 +223,7 @@ namespace XericUI.XChart.Mesh
{
if (!(tool is ChartToolVectorArrows arrows)) return;
- arrows.OriginDimension = m_OriginDimension;
+ arrows.CoordinateDimension = m_CoordinateDimension;
arrows.VectorMode = m_VectorMode;
arrows.Continuous = m_Continuous;
arrows.DirectionScale = m_DirectionScale;
diff --git a/Runtime/XChart/XChartElementConfig.cs b/Runtime/XChart/XChartElementConfig.cs
index f864dbd..0d0a64a 100644
--- a/Runtime/XChart/XChartElementConfig.cs
+++ b/Runtime/XChart/XChartElementConfig.cs
@@ -107,6 +107,13 @@ namespace XericUI.XChart
///
public virtual int RequiredNumericDimensions => 0;
+ ///
+ /// 这个元素要几条记录才画得出来(0=一条也行)。
+ /// 和维数是同一件事的两半:矢量场一条记录都不缺维、但只有一条记录时**一支箭头都构不成**
+ /// (一支=相邻两条)。两个数必须都印出来,否则"有数据但不够"又会混进"什么都没显示"里。
+ ///
+ public virtual int RequiredRecordCount => 0;
+
///
/// 互斥显示: 这个字段在当前配置下要不要从面板上藏掉。
///