XChart P17 口径修正:序号只读、矢量场按 3 维坐标 + 相邻两条记录一支箭头

按他 2026-10-25 的澄清(规范 §24.5 / §25 已先改对):

- **序号不再是给人设的**:标题行 `R… D…` 改成文本读数(就地刷新);Body 里不再有任何序号输入控件。
  新增 `RenumberDrawOrder()`:任何结构变化(上移/下移/加/删)之后把每个元素的 `m_DrawOrder`
  重写成它在表里的位置 ⇒ **位置更靠后=绘得更晚=盖在上面**,位置是唯一权威;
  注册序由类型定死,只显示。↑↓ 的 tooltip 也改成讲层序。
- **矢量场数据口径改对**:前三维=坐标 x/y/z(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**
  (第 i 条起点、第 i+1 条按绝对/相对解释)、**第 4~7 维=颜色**(色相 0..256 色环 / 饱和 / 明度 / 不透明,
  全可选)。需求印**三个数**(需要几个数值维 / 需要几条记录 / 表里各有多少)——
  "记录不够"与"维数不够"在画面上同形,只有这三个数分得清。
- 支数由纯算术 `XChartVectorFieldMath.ArrowCount(记录数, 上限)` 算(N 条 ⇒ N−1 支,上限裁剪,<2 条 ⇒ 0)。
- **两端各自颜色**:杆用起点色、头用终点色(读两条记录各自的颜色维);沿杆逐顶点渐变留给 P18。
- 生成器 `螺旋矢量场` 改成 **7 维**(坐标 + 色相走满一圈 + 饱和/明度/不透明),自己补列。

判据:编译门三臂 + 3 对照绿;探针 **439** 项 0 失败(新增支数一族);
`p4_control` **57/57** 支臂各红在点名断言上(新增两支:一对不再花两条记录、空表不挡而直接进算术);
`p2` / `family` / `generator_gate` / `hierarchy_gate` 在同一棵交付树上复跑全绿。
过程记录:第一版给"一对不再花两条记录"点名的清单里放了一条**被更前面的守卫挡住、这支变异体碰不到**
的判据,`did not go red` 当场抓出来 ⇒ 按实测改清单,并给零/一条记录补了它自己那支变异体(§25.7)。
This commit is contained in:
2026-10-25 21:01:53 +08:00
parent 36c1577df1
commit 0d9a3d7417
8 changed files with 201 additions and 115 deletions
+19 -4
View File
@@ -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,模板已有"径向渐变"那一档可参照)。
+50 -15
View File
@@ -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();
}
/// <summary>
/// 把每个元素的**绘制序**重写成它在表里的位置(0,1,2…):位置更靠后=绘得更晚=盖在上面。
/// 他只调位置(↑↓),不再有第二个手填的绘制序号——两条口径指向不同事实时,
/// "上移之后绘制顺序变没变"就没人回答得了(§24.5)。
/// </summary>
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;
+13 -12
View File
@@ -12,8 +12,8 @@ namespace XericUI.XChart.Editor
/// </summary>
public static class XChartDataGenerators
{
/// <summary>螺旋矢量场一条记录占的数值维:起点 3 + 第二点 3 + 颜色 3(色相/饱和/明度)</summary>
public const int VectorFieldDimensions = 9;
/// <summary>螺旋矢量场一条记录占的数值维:坐标 3 + 颜色 4(色相/饱和/明度/不透明度)</summary>
public const int VectorFieldDimensions = 7;
/// <summary>螺旋上参数 t∈[0,1] 的那个点(一圈正弦/余弦配线性 x)</summary>
private static void Spiral(float t, out float x, out float y, out float z)
@@ -41,15 +41,17 @@ namespace XericUI.XChart.Editor
}
/// <summary>
/// 螺旋矢量场:<b>一条记录 9 个数值维</b> <c>[x, y, z, nx, ny, nz, h, s, v]</c>——
/// 前三维是这一条的点,中三维是<b>下一个点</b>,后三维是颜色(色相 0..256 走色环,饱和/明度都是 1)。
/// 螺旋矢量场:一圈正弦/余弦点,**每条记录 7 个数值维** <c>[x, y, z, h, s, v, a]</c>——
/// 前三维是<b>这条记录的坐标</b>(与圆柱/散点同一套口径),后四维是颜色
/// (色相 0→256 走满一圈色环、饱和/明度 1、不透明度 1)。
///
/// <para>为什么中三维取"下一个点":两种读法都能一眼分出来(他 2026-10-25 的描述)——
/// <para>箭头由**相邻两条记录**构成(规范 §25.2),所以两种读法在这份数据上一眼可辨(他 2026-10-25):
/// <b>相对</b>:箭头由本点指向下一点 ⇒ 一串首尾相接、顺着螺旋转;
/// <b>绝对</b>:后三维当方向矢量用 ⇒ 每根朝"下一点的坐标方向"散开,看起来像一片刺猬。</para>
/// <b>绝对</b>:下一点的坐标当方向矢量 ⇒ 每根朝"下一点的坐标方向"散开,看起来像一片刺猬。
/// 又因为颜色随记录自带,一串箭头的起点色与终点色**各自不同**。</para>
///
/// <para>维数不够会先<b>把列补出来</b>(测试数据的判据是"点一下就能看到东西",
/// 而不是"提示他先去加六列");表里原有的记录会被清掉——它就是一份示例数据。</para>
/// 而不是"提示他先去加四列");表里原有的记录会被清掉——它就是一份示例数据。</para>
/// </summary>
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++;
}
+1 -1
View File
@@ -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 = "改完数据直接重画一次图,不用回界面乱点" });
+69 -57
View File
@@ -8,37 +8,40 @@ using XericUI.XChart.Space;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 向量场 / 流形箭头元素:一条记录占 <b>6 个数值维</b>——两组三维,
/// 按 <see cref="VectorMode"/> 解释成一支箭头(绝对=方向矢量 / 相对=第二个点)。
/// 后面可以再接 3~4 维颜色(色相/饱和度/明度 [+不透明度]),见 <see cref="UseColorDimensions"/>。
/// 向量场 / 流形箭头元素。**数据口径(规范 §25.2,2026-10-25 他澄清后定稿)**:
/// <b>前三维=坐标 x/y/z</b>(与圆柱、散点同一套归一化),<b>一支箭头=相邻两条记录</b>
/// (第 i 条是起点,第 i+1 条按 <see cref="VectorMode"/> 解释成"第二个点"或"方向矢量"),
/// <b>第 4~7 维是颜色</b>(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,可选)。
///
/// <para><b>两种读法</b>(他 2026-10-25 口述):
/// 绝对 ⇒ 后三维是方向本身,起点加方向乘倍率就是末端(螺旋点画出来是一片"刺猬");
/// 相对 ⇒ 后三维是第二个点,箭头是第一点指向第二点(一串首尾相接的点读起来就是"连着头转")。</para>
/// <para><b>两种读法</b>:绝对 ⇒ 第二条记录的坐标就是方向(起点 + 方向×倍率),螺旋点画出来是一片"刺猬";
/// 相对 ⇒ 它是第二个点(起点 + 差向量×倍率),一串首尾相接的点读起来就是"连着头转"。</para>
///
/// <para><b>连续绘制</b>:把所有记录的<b>第一组三维</b>按顺序连成折线(只有最后一段带箭头)。
/// <para><b>连续绘制</b>:把每条记录的坐标按顺序连成折线(只有最后一段带箭头);
/// 这时"相对/绝对"不适用 ⇒ 配置里那一项隐藏(互斥显示)。</para>
///
/// <para><b>箭头是自己拼的,没有用库里的 ArrowShape</b>:那套箭头是给曲线的屏幕空间
/// 图元用的,而这里的箭头必须跟着立方体姿态走(投影后长短和方向都在变)。做法是
/// 只让空间负责两端的投影,杆和头都在<b>像素空间</b>里量出来:杆是一段等宽四边形,
/// 头是一个退化四边形(三角形),宽度恒定所以任何姿态下都不会塌成一条线。</para>
/// <para><b>两端各自的颜色</b>:起点读第 i 条记录、终点读第 i+1 条 ⇒ 两支记录颜色不同时,
/// 杆与头**各显一色**。真正的"沿杆逐顶点渐变"要等渲染器支持逐顶点双色(P18)。</para>
///
/// <para><b>箭头是自己拼的,没有用库里的 ArrowShape</b>:那套箭头是给曲线的屏幕空间图元用的,
/// 而这里的箭头必须跟着立方体姿态走(投影后长短和方向都在变)。做法是只让空间负责两端的投影,
/// 杆和头都在<b>像素空间</b>里量出来:杆是一段等宽四边形,头是一个退化四边形(三角形),
/// 宽度恒定所以任何姿态下都不会塌成一条线。</para>
///
/// <para><b>数据只经过中转接口</b>:按维度下标 <see cref="IXChartDataSource.GetValueAt"/> 逐条取,
/// 不碰记录数组;条数由 <see cref="MaxArrowCount"/> 兜住,免得十万条记录一口气投影。</para>
/// 不碰记录数组;支数由 <see cref="MaxArrowCount"/> 兜住,免得十万条记录一口气投影。</para>
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Vector Arrow Tool")]
public sealed class ChartToolVectorArrows : XChartToolBase
{
/// <summary>起点的维度下标(矢量再占三维,颜色再往后)</summary>
public int OriginDimension { get; set; }
/// <summary>两组三维怎么读成一支箭头</summary>
/// <summary>坐标的维度下标(x/y/z 三维)</summary>
public int CoordinateDimension { get; set; }
/// <summary>第二条记录怎么读成方向</summary>
public XChartArrowVectorMode VectorMode { get; set; } = XChartArrowVectorMode.Absolute;
/// <summary>把每条记录的第一个点按顺序连成折线(此时相对/绝对不适用)</summary>
/// <summary>把每条记录的坐标按顺序连成折线(此时相对/绝对不适用)</summary>
public bool Continuous { get; set; }
/// <summary>方向向量的长度倍率(立方体单位);相对模式下作用在差向量上</summary>
public float DirectionScale { get; set; } = 0.25f;
/// <summary>最多画多少条(数据再多也只取前 N 条,避免一次性铺满)</summary>
/// <summary>最多画多少支(一支=相邻两条记录)</summary>
public int MaxArrowCount { get; set; } = 512;
/// <summary>箭头自己的变换(叠在图的空间之上)</summary>
@@ -49,7 +52,7 @@ namespace XericUI.XChart.Mesh
/// <summary>是否用额外的数值维给每支箭头上色</summary>
public bool UseColorDimensions { get; set; }
/// <summary>颜色维的起点(色相、饱和度、明度 [+不透明度])</summary>
public int ColorDimension { get; set; } = 6;
public int ColorDimension { get; set; } = 3;
/// <summary>是否多读一维不透明度</summary>
public bool HasAlphaDimension { get; set; }
@@ -69,10 +72,11 @@ namespace XericUI.XChart.Mesh
private readonly List<ArrowFace> m_Faces = new List<ArrowFace>(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;
/// <summary>
/// 这个元素要几个数值维:矢量 6 +(可选)颜色 3。
/// <b>不透明度那一维不算硬需求</b>:它多给就多读、没给就退回单色的 alpha——
/// 把它算进门槛的话,勾一下"有不透明度"会让整个元素突然一条都不画(维数不够),
/// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。
/// <b>不透明度那一维不算硬需求</b>:多给就多读、没给退回单色 alpha——
/// 把它算进门槛的话,勾一下"有不透明度"会让整个元素突然一条都不画,
/// 那是把这一个开关变成了总闸。
/// </summary>
public int RequiredDimensionCount
=> XChartArrowConfig.VectorDimensionCount + (UseColorDimensions ? 3 : 0);
=> XChartArrowConfig.CoordinateDimensionCount + (UseColorDimensions ? XChartArrowConfig.ColorDimensionCount : 0);
/// <summary>一支箭头要两条记录</summary>
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);
}
/// <summary>
/// 连续绘制:把所有记录的第一个点按顺序连成一条折线,<b>只有最后一段带箭头</b>。
/// 读的是每组的第一组三维(坐标),后面那几维(方向/第二点/颜色维)在这种模式下不参与——
/// 连起来的本来就是空间里的一条路径。
/// 连续绘制:把每条记录的坐标按顺序连成折线,<b>只有最后一段带箭头</b>。
/// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了)。
/// </summary>
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;
}
}
/// <summary>一支箭头 = 杆 +(可选)头。退化(零长度)时按开关画成一个小方块</summary>
private bool AddArrow(ChartToolSpace space, Vector3 origin, Vector3 tip, Color color, bool withHead = true)
/// <summary>
/// 一支箭头 = 杆(用起点色)+(可选)头(用终点色)。
/// <b>两端各显一色</b>是颜色维"随记录自带"的直接结果;真正的沿杆渐变要等渲染器支持逐顶点双色(P18)。
/// </summary>
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));
}
/// <summary>
@@ -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
/// <summary>
/// 报表里点名这一帧:<b>维数(现有/需要)</b>+算了几支+读法+面数/块数。
/// "加了工具什么都没显示"这件事只有这一行分得清是"维数不够"还是"算了但没提交"
/// (他 2026-10-25 现场;规范 §25)。
/// 报表里点名这一帧:<b>维数(现有/需要)与记录数</b>+算了几支+读法+颜色来源+面数/块数。
/// "加了工具什么都没显示"这件事只有这一行分得清是"维数不够"还是"记录不够"还是"算了但没提交"
/// (他 2026-10-25 现场;规范 §25.1)。
/// </summary>
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")
@@ -22,6 +22,20 @@ namespace XericUI.XChart.Mesh
return first + direction * scale;
}
/// <summary>
/// 一支箭头=相邻两条记录 ⇒ 给定记录数与上限,能画出几支(上限 ≤0 =不限)。
///
/// <para>单列出来是因为<b>"记录不够"与"维数不够"在画面上完全同形</b>(都是一条都不画),
/// 而 N−1 与 0 这两个数是唯一分得清它们的读数(规范 §25.1)。</para>
/// </summary>
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;
}
/// <summary>
/// 读一组颜色维:<paramref name="hue"/> 按 <b>0..256 的色环</b>(256 与 0 是同一个颜色,
/// 取模,所以 300 也读得动),饱和度/明度/不透明度按 0..1 夹住。
+28 -26
View File
@@ -126,45 +126,44 @@ namespace XericUI.XChart.Mesh
/// <summary>
/// 向量箭头(矢量场)元素的配置。
///
/// <para><b>一条记录怎么读</b>:前 3 维是"一个点",后 3 维是"另一个点",
/// 按 <see cref="VectorMode"/> 解释成一支箭头——</para>
/// <para><b>数据口径(2026-10-25 他澄清后定稿,规范 §25.2)</b>:</para>
/// <list type="bullet">
/// <item><see cref="XChartArrowVectorMode.Absolute"/>(绝对):后 3 维是<b>方向矢量</b>本身,
/// 起点 + 方向×倍率 = 箭头末端。螺旋点在这种读法下画出来是一片"刺猬"(每根朝外)。</item>
/// <item><see cref="XChartArrowVectorMode.Relative"/>(相对):后 3 维是<b>第二个点</b>,
/// 箭头 = 第一点指向第二点(差向量×倍率)。一串首尾相接的点在这种读法下就是"连着头往下转"。</item>
/// <item><b>前三维=坐标 x/y/z</b>(立方体单位,与圆柱、散点同一套归一化)——不是"两组三维"。</item>
/// <item><b>一支箭头=相邻两条记录</b>:第 i 条是起点,第 i+1 条按 <see cref="VectorMode"/> 解释成
/// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。</item>
/// <item><b>第 4~7 维是颜色</b>:色相(0..256 色环)/ 饱和度 / 明度 / 不透明度,全部可选。
/// 颜色随记录自带 ⇒ 一支箭头的起点色与终点色可以不同(七维信息的那个用法)。</item>
/// </list>
///
/// <para><b>连续绘制</b>(<see cref="Continuous"/>):把所有记录的点<b>按顺序连成一条折线</b>——
/// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两个选项**隐藏**
/// <para><b>连续绘制</b>(<see cref="Continuous"/>):把每条记录的坐标按顺序连成折线——
/// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两项**隐藏**
/// (互斥显示,见 <see cref="IsFieldHidden"/>)。</para>
///
/// <para><b>颜色是可选的额外维度</b>:<c>[h, s, v]</c>(可选 <c>+a</c>)接在矢量后面读,
/// 于是"给每个点标颜色"不需要往表里塞非数值列——色相走 0..256 的色环,其余三个按 0..1。</para>
/// </summary>
[Serializable]
[XChartElement("arrows", "向量箭头", 50)]
public sealed class XChartArrowConfig : XChartElementConfig
{
/// <summary>3 维起点 + 3 维方向/第二点</summary>
public const int VectorDimensionCount = 6;
/// <summary>坐标要占几个数值维(x/y/z)</summary>
public const int CoordinateDimensionCount = 3;
/// <summary>颜色要几个数值维(色相/饱和度/明度 [+不透明度])</summary>
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
/// <summary>
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
/// 不透明度那一维**不算硬需求**(多给就多读、没给退回单色 alpha)——算进去就成了
/// "勾一个开关,整个元素消失"。
/// 坐标 3 +(可选)颜色 3;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha)——
/// 算进门槛的话,勾一下"有不透明度"会让整个元素因维数不够突然消失。
/// </summary>
public override int RequiredNumericDimensions
=> VectorDimensionCount + (m_UseColorDimensions ? 3 : 0);
=> CoordinateDimensionCount + (m_UseColorDimensions ? ColorDimensionCount : 0);
/// <summary>一支箭头要两条记录 ⇒ 记录少于 2 条时一支都画不出来(面板/报表同样要印出来)</summary>
public override int RequiredRecordCount => 2;
/// <summary>
/// 互斥显示:连续绘制打开时「相对/绝对」没有意义(他 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;
+7
View File
@@ -107,6 +107,13 @@ namespace XericUI.XChart
/// </summary>
public virtual int RequiredNumericDimensions => 0;
/// <summary>
/// 这个元素要<b>几条记录</b>才画得出来(0=一条也行)。
/// 和维数是同一件事的两半:矢量场一条记录都不缺维、但只有一条记录时**一支箭头都构不成**
/// (一支=相邻两条)。两个数必须都印出来,否则"有数据但不够"又会混进"什么都没显示"里。
/// </summary>
public virtual int RequiredRecordCount => 0;
/// <summary>
/// 互斥显示:<paramref name="fieldName"/> 这个字段在当前配置下要不要从面板上<b>藏掉</b>。
///