From 0d9a3d7417eed0a9382a53f4ade6331247c644c8 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Sun, 25 Oct 2026 21:01:53 +0800 Subject: [PATCH] =?UTF-8?q?XChart=20P17=20=E5=8F=A3=E5=BE=84=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3=EF=BC=9A=E5=BA=8F=E5=8F=B7=E5=8F=AA=E8=AF=BB=E3=80=81?= =?UTF-8?q?=E7=9F=A2=E9=87=8F=E5=9C=BA=E6=8C=89=203=20=E7=BB=B4=E5=9D=90?= =?UTF-8?q?=E6=A0=87=20+=20=E7=9B=B8=E9=82=BB=E4=B8=A4=E6=9D=A1=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=E4=B8=80=E6=94=AF=E7=AE=AD=E5=A4=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 按他 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)。 --- Documentation/XChart-RenderFramework.md | 23 +++- Editor/XChart/XChartBaseEditor.cs | 65 +++++++--- Editor/XChart/XChartDataGenerators.cs | 25 ++-- Editor/XChart/XChartDataWindow.cs | 2 +- Runtime/XChart/Mesh/ChartToolVectorArrows.cs | 126 ++++++++++--------- Runtime/XChart/Mesh/XChartVectorFieldMath.cs | 14 +++ Runtime/XChart/Mesh/XChartVolumeConfigs.cs | 54 ++++---- Runtime/XChart/XChartElementConfig.cs | 7 ++ 8 files changed, 201 insertions(+), 115 deletions(-) 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; + /// /// 互斥显示: 这个字段在当前配置下要不要从面板上藏掉。 ///