From cb759fe58390d52ca32481c10d46fc029d1aeb11 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Mon, 26 Oct 2026 10:17:37 +0800 Subject: [PATCH] =?UTF-8?q?XChart=20P21=EF=BC=9A=E7=9F=A2=E9=87=8F?= =?UTF-8?q?=E5=9C=BA=E6=B2=A1=E6=B8=B2=E6=9F=93=E7=9A=84=E6=A0=B9=E5=9B=A0?= =?UTF-8?q?=E6=98=AF=E7=AE=AD=E5=A4=B4=E6=8A=8A=E6=95=B0=E6=8D=AE=E5=80=BC?= =?UTF-8?q?=E5=BD=93=E7=AB=8B=E6=96=B9=E4=BD=93=E5=8D=95=E4=BD=8D=E7=94=A8?= =?UTF-8?q?=E4=BA=86=E2=80=94=E2=80=94=E7=8E=B0=E5=9C=A8=E5=AE=83=E4=B9=9F?= =?UTF-8?q?=E6=8A=98=E8=BF=9B=E7=9B=92=E5=AD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 他报"矢量场现在没有在渲染"。我先从他自己的资产里取状态,不猜: SP_盾构机掘进姿态 Variant.prefab 里那份表是 x/y/z 三个数值维、记录值量级 -100..50(三条以上), 箭头元素 m_Enabled=1、VectorMode=Absolute、Continuous=0、UseColorDimensions=0、MaxArrowCount=512。 ⇒ 形状是够的(需要 3、现有 3,面板那句"一条都不画"不会亮),问题在**尺度**。 根因(我这边的缺陷,不是 P20 改坏的):ChartToolVectorArrows.ReadPoint 把 GetValueAt 的原始值 **直接当立方体单位**(±1=盒子边界)用,一份 -100..50 的表就把每支箭头投到一万多像素之外—— 支数在算、面在提交、画面什么都没有。散点与圆柱一直是"按各维显示范围折进盒子" (context.TryResolveDomain + XChartBindingMath.TryNormalize),只有箭头这一条路径漏了: 同一件事两套口径,坏的那一套不报错,只是看不见。P20 那次提交 33/17 行全在属性形状上, 他的 Editor.log 里这次导入只有一条无关的 CS0414,也排除了"是我刚改坏的"。 修法: - 纯算术新增 XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube):每一维按自己的范围 映到 [-1,1];**任何一维折不出来(跨度 ≤0、值或端点非有限)就整体拒答**——半归一化的坐标比不 归一化的更难查,它会画出"看着像个箭头但方向不对"的东西。折法放纯算术里才离线钉得住。 - 工具每帧现问三条轴的范围(范围不归元素存,与散点同一条规矩);读点改 TryReadPoint, 读不出来的点计入 skipped=,不静默少画。 - 报表多了两个读数:dom=x[..] y[..] z[..](折不出来印 dom=-,那时一支都不画,原因当场可见)、 skipped=。他那份表应当印出 dom=x[-100..50] ... 且 arrows=记录数-1。 判据:探针 458 项 0 失败(新增 8 条 vector field cube:域两端落 ±1、域中落 0、他表里那种量级的 记录 (-93.5, 10.1, 49.0) 在给定域下折进盒子内、域外**保持成比例而不是被夹住**、零跨度拒答、非有限拒答、坏一轴整体拒答); p4_control 新增 3 支臂(不折、坏一轴也答、偷偷夹住)各红在自己点名的断言上(分别 5/3/1 条), 全套 64 支 CONTROL PASSED:"arms 0-63 of 64 went red on their named assertions"; dirty_gate 新增 claim F(箭头的坐标必须经 TryCubePoint;原始值直接进 Vector3 就红)并配一支变异 M8, **八支全红**、正本 knobs=132 takesEffect=132 findings=0;编译门 runtime+player+editor+3 对照 GATE PASSED(chain_p21.txt)。 一条"判据的判据"本轮现形:M8 第一版**是绿的**——不是判据太弱,是 claim F 用来认文件的参数 被 claim C 的 `for name in names` 循环重新绑定了(judge(lines, name) 里 name 既是文件名又当旋钮名, 循环跑完它就变成最后一个旋钮的名字 ⇒ F 支永远不执行)。"臂能红"这件事第一次是靠它自己抓到的: 不红 ⇒ 追下去 ⇒ 抓到参数遮蔽。规矩:给"按文件生效的判据"传参,参数名不许与函数体内的循环变量同名 (这次改成 source)。另记一条 py2 的:门脚本声明 coding: ascii,我把中文写进注释就直接 SyntaxError(中文只进仓内文档,不进脚本)。 如实留给现场/下一轮的两条,我没偷改: ① Absolute 下"方向=下一条记录的坐标",他那串姿态点用 **Relative** 才对(首尾相接=轨迹方向); ② XMeshPreviewChart 的示例数据还是**旧的"一条记录 6 维"口径**(方向存第 4~6 维), 新口径下那三列是死数据——要按"相邻两条"重造那份 demo,得先确认它还想不想同时喂散点元素。 --- CHANGELOG.md | 1 + Documentation/XChart-RenderFramework.md | 60 +++++++++++++++++ Runtime/XChart/Mesh/ChartToolVectorArrows.cs | 71 +++++++++++++++++--- Runtime/XChart/Mesh/XChartVectorFieldMath.cs | 28 ++++++++ 4 files changed, 152 insertions(+), 8 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e086451..c7a543f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -96,6 +96,7 @@ P17 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规 P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确口径重写):① **序号不是给人设的**——*注册序*由**类型**定好(定义几何的那一类天然靠前、数据呈现那一类靠后),面板**只显示、不给输入控件**;*绘制序*与**元素在表里的位置**绑定(上移/下移就是改绘制顺序),也不再有第二个手填的序号——序号能手填就会出现两条口径(位置 vs 数字)指向不同事实,"上移之后绘制顺序变没变"就没人回答得了。第一版我把 `R… D…` 做成了两个窄输入框,他现场否掉("我根本不想给它设置这个序号"),而且那对输入框还会露出拖拽光标、窄到数字看不见 ⇒ 改成**文本读数**并就地刷新(面板树在值变化时不重建)。② **矢量场的数据口径写错了**:正确是**前三维=坐标 x/y/z**(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4~7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。 P18 矢量场收尾:两端各自的颜色 + 连续绘制走曲线渲染器 + 箭头位置可调(规范 §26,2026-10-26):① 填充四边形多一档**线性渐变**(`AddFaceLinear`:`00/10` 一对边一色、`01/11` 一对边一色),箭头**杆走渐变(起点色→终点色)、头走终点色**——两端颜色来自相邻两条记录各自的颜色维,所以"这条与下条颜色不同"直接看得出来;每面花几个顶点收成**单一定义** `XChartMeshBudget.VerticesPerFace(kind)`(预算侧与写顶点侧同源,否则"预算以为 4 个、实际发 5 个"会在卡线时撞 65535,§10.3 那一族);**杆的四角绕序有判据**(a/d 在起点一侧、b/c 在末端一侧;配错画面上是"杆两侧各一色"而不是"沿杆渐变",最容易看漏)。② 连续绘制改走**曲线渲染器**(库里 `UICurveRenderer`,圆柱弧段同一件):途经点 → **Catmull-Rom 转三次贝塞尔**(张力 1/6,新纯算术 `XChartArrowPathMath`),曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置;`entry` 自带起止色 ⇒ 沿程渐变是它本来的能力;不再逐段提交折线(§10.4 的转角断口)。③ **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给段号+段内参数 ⇒ 该段 `Split` 剪断、只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪);**必须剪**,否则路径从箭头底下穿出去、看着像"箭头朝里长"。④ 互斥显示又用一次:`HeadPosition`/`PathSegments` 只在连续绘制下出现,`相对/绝对` 反过来只在非连续下出现。⑤ 读数与退路:报表带 `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=`——曲线渲染器不在位时退回直线段(形状仍读得出来),但**退没退在 `path=` 上一个字说清**,不是悄悄换个画法还报一样的数。判据:编译门三臂 + 3 对照绿;探针 **450** 项 0 失败(新增 `arrow path:` 9 条——全是**性质**判据:过数据点、端点切线=弦的一半、剪开再接回逐点一致、共线仍是直的、位置 0/0.5/1 落在哪一段,不写手算的中间点坐标)+ `arrow shaft:` 配对 1 条 + 顶点数 1 条;`p4_control` **61** 支臂各红在点名断言上(新增 4 支:起点侧角取成末端、所有面按平坦算顶点、控制柄拉成 /3 张力、剪开不共用剪口点);`p2` / `family` / `generator_gate` / `hierarchy_gate` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。 P20 外部数据驱动访问(规范 §27,2026-10-26 他问"我能不能直接拿到圆柱渲染器,改属性就自动置脏"):**入口本来就有**(`ToolManager.FindTool()`),缺的是第二半——9 个工具的参数全是裸自动属性,**写进去值在、画面不动**,必须再补一句 `MarkDirty()`(`XMeshPreviewChart.ApplyVolume` 手工补的那个样子)。落法:① `XChartToolBase` 新增 **`public abstract void MarkDirty()`**——不给基类空实现,因为空实现通过基类引用调用时**静默什么都不做**(参数改了、画面不动、报表看不出错,"零要说出它零在哪一层"那一族),抽象让编译器逼 9 个工具各自说清"我的脏位是哪个字段";7 个已有 `public void MarkDirty()` 的必须逐个补 `override`(少了就是 **CS0108 隐藏**:编译只出警告、基类调用失效),`ChartToolSpace` 没有独立脏位⇒转发 `MarkProjectionDirty()`(投影就是它唯一要重算的东西),`ChartToolScatterPoints` 只有 `MarkDataDirty()`⇒override 接 `m_PointsDirty`、旧名转发(同一字段两个名字)。② **132 个旋钮全部改成"设了就生效"**:`public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }`(122 支走 `MarkDirty`,**10 支走 `SyncShapeParams`——这 10 支是门查出来的,不是我原本知道的**:散点外观早就自带生效路径,于是判据从"必须调 MarkDirty"改成"必须调到本文件里定义的 `MarkDirty` 或 `Sync*/Push*/Apply*/Rebuild*`")。③ `XChartBase` 加两个入口:`Tool(toolName)`(`FindTool` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element()`(走 `XChartElementTable.FirstOfKind`,与默认元素去重同一个答法)。④ **权威只有一处这件事写明**:外部写进工具的值会活到下一次 `ReapplyElements()`/`RebuildElements()`(面板动任一字段、增删/停用元素、脚本重载、进 Play、`ResetRender()`),那一次把配置整份重灌 ⇒ 外部的写被静默覆盖;要活得过重建就得写配置,而配置的公开写入口本轮**没开**(字段仍 private,面板走 `SerializedProperty`),列为下一步。判据:新门 `.ximage-gate/dirty_gate.py`——清单**两侧都数**(`TOOLS` 9 个 vs 磁盘 `ChartTool*.cs` 9 个,多一个少一个都红)、终态 `knobs=132 takesEffect=132 findings=0` 才算绿;另立两条同门判据:**D** 工具不许在 setter 之外给自己的旋钮赋值(那会在自己渲染的过程中把自己重新置脏 ⇒ 每帧重建),**E** 靠 `Sync` 生效的必须 `OnInitialize` 里也有那一句(否则 `if (IsInitialized) Sync()` 把初始化之前的写全丢);**七支变异各红在自己点名的那条**(M1 抹掉一个 setter 的 `MarkDirty()`、M2 拿掉 `override`、M3 新增一个裸自动属性、M4 工具自赋值、M5 把一个工具从路径上挪走、M6 `Sync` 调用改成不存在的名字、M7 从 `OnInitialize` 删掉那句 `Sync`)。**本轮自己的三处错都被门/编译门抓住(不是现场)**:批量改写脚本把字段行的**等号漏了**(`private float m_Radius 0.22f;`,121 处全中);判据把标识符里的字母当关键字(`Offset` 含 "set" ⇒ 只读的 `Offset` 被读成"从不置脏的 setter",改词边界 `\bset\b`);`{ get; private set; }` 没先归类成 views 时 D 支报出 **26 处**"自赋值"全是渲染器属性的初始化写盘(**分类之后真违规 0 处——写了判据才知道有没有**)。`ChartToolSpace.Rotation` 的初始化式跨两行,脚本按"同一行没闭合就拒绝整份文件"跳过整个文件、那 4 个旋钮手改(**拒绝写比写一半好**)。编译门 runtime+player+editor+3 对照 `GATE PASSED`(`chain_p20a.txt`/`chain_p20b.txt` rc=0);mono 数学探针本轮不重跑——改的全是 MonoBehaviour 侧工具的 setter,纯算文件一个没动。**覆盖不到**:画面观感归他现场判。 +P21 矢量场没渲染的根因与修法(规范 §28,2026-10-26 他报"矢量场现在没有在渲染"):**读数先从他自己的资产里取**——`SP_盾构机掘进姿态 Variant.prefab` 那份表是 x/y/z 三维、记录值量级 **−100..50**、三条以上记录,箭头元素 `m_Enabled=1 / VectorMode=Absolute / Continuous=0 / UseColorDimensions=0`,所以形状够(需要 3、现有 3,面板那句"一条都不画"不会亮),问题不在 §25.1 那一层而在**尺度**。根因:`ChartToolVectorArrows.ReadPoint` 把 `GetValueAt` 的**原始值直接当立方体单位**(±1=盒子边界)用 ⇒ 每支箭头被投到**一万多像素之外**:支数在算、面在提交、计数全对,画面上什么都没有;而散点与圆柱一直是"按各维显示范围折进盒子"(`TryResolveDomain` + `XChartBindingMath.TryNormalize`)——**只有箭头这一条路径没折**,同一件事两套口径,坏的那套不抛不报错、只是看不见(§22 格线双作者、§24.5 序号双口径的同族)。排除"P20 改坏"用的是 diff 形状:那次提交 33 增 17 删全在属性形状上、编译门绿、他 `Editor.log` 里这次导入只有一条无关的 `CS0414`。落法:① 纯算术新增 `XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube)`(每维按自己的范围映到 [-1,1];**任何一维折不出来——跨度 ≤0、值或端点非有限——就整体拒答**,因为半归一化的坐标比不归一化的更难查,它会画出"看着像个箭头、方向却不对"的东西;折法进纯算术才离线钉得住);② 工具**每帧现问**三条轴的范围(范围不归元素存,与散点同规矩),读点改 `TryReadPoint`,读不出的点计入 `skipped=` 而不是静默少画;③ 报表加 `dom=x[..] y[..] z[..]` 与 `skipped=`,**折不出来印 `dom=-` 且一支都不画**——"为什么没有"当场说话(他那份表应印 `dom=x[-100..50] …`、`arrows=记录数−1`)。判据:探针 **458** 项 0 失败(新增 8 条 `vector field cube:`:域两端落 ±1、域中落 0、他那种量级的记录折进盒子内、**域外保持成比例而不是被夹住**(夹住=把数据改了)、零跨度拒答、非有限拒答、坏一轴整体拒答——全是性质判据,不写手算中间值)+ `p4_control` 新增 **3** 支臂(不折 / 坏一轴也照答 / 偷偷 `Clamp`)各红在点名断言上 + `dirty_gate` 新增 **claim F**(箭头这条路径的坐标必须经 `TryCubePoint`,原始值直接进 `new Vector3(` 就红;只挂这个文件,因为它判的是"形状对、画面空"这一类)并配变异 **M8_rawcoord**——**八支全红**、正本 `knobs=132 takesEffect=132 findings=0`;编译门三臂 + 3 对照绿(`chain_p21.txt rc=0`)。**两条判据自身的错记档**:① M8 第一版是**绿的**——不是判据弱,是 claim F 用来认文件的参数被 claim C 的 `for name in names` 重新绑定了(`judge(lines, name)` 里 `name` 既是文件名又当旋钮名,循环跑完它就等于最后一个旋钮名 ⇒ F 支永远不执行),**"臂能不能红"第一次是靠它自己抓到的** ⇒ 规矩:给"按文件生效的判据"传参,参数名不许与函数体内循环变量同名(这次改成 `source`);② 门脚本声明 `coding: ascii`,中文写进注释就直接 `SyntaxError`(中文只进仓内文档,不进脚本)。**留给现场/下一轮、没偷改的两条**:他这串姿态点的正确读法是 `Relative`(首尾相接=轨迹方向,`Absolute` 是给"点一行、方向一行"分开存的表用的);`XMeshPreviewChart` 的示例数据仍是**旧的"一条记录 6 维"口径**(方向存第 4~6 维),新口径下那三列是**死数据**,画出来的是"每条记录位置 → 0.25×下一条记录位置"——重造那份 demo 之前要先确认它还想不想同时喂散点元素(一对记录里的第二条也会成为一个点)。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index 13dffe8..1d1dcee 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -1865,3 +1865,63 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最 2. `chart.Space.HalfEdge = 260f;` —— 整张图的尺度跟着走(空间的脏就是投影脏,其余工具靠 `ProjectionVersion` 跟着重算)。 3. `chart.DataModel.TryAddRecord(t, values)` —— 和以前一样;数据这条路一直是自动的。 4. 做完第 1 条后去面板动**任意**一个元素字段 ⇒ 圆柱回到配置里的值。这就是 27.3 说的覆盖,属预期,不是回归。 + +## 28. P21:矢量场没渲染——根因是"数据值被当成立方体单位"(2026-10-26) + +### 28.1 现场与读数(读数取自他自己的资产,不是猜的) + +他报"矢量场现在没有在渲染"。我从 `Assets/Prefabs/0n_Panel/SP_盾构机掘进姿态 Variant.prefab` 里直接读到: + +- 数据表:**x / y / z 三个数值维**,记录值量级 **−100 .. 50**(三条以上); +- 箭头元素:`m_Enabled=1`、`m_VectorMode=0(Absolute)`、`m_Continuous=0`、`m_UseColorDimensions=0`、`m_MaxArrowCount=512`。 + +⇒ 形状是够的(需要 3、现有 3;面板那句"一条都不画"不会亮,报表 `dims=3/3` 也正常), +所以问题不在 §25.1 那一层,而在**尺度**这一层。 + +### 28.2 根因:同一件事两套口径,漏的那个不报错 + +`ChartToolVectorArrows.ReadPoint` 把 `GetValueAt` 的**原始值直接当立方体单位**用(±1=盒子边界), +于是 −100..50 这份表把每支箭头投到**一万多像素之外**:支数在算、面在提交、计数全对,画面上什么都没有。 + +散点和圆柱一直是"按各维显示范围折进盒子"的(`context.TryResolveDomain` + `XChartBindingMath.TryNormalize`) +⇒ **只有箭头这一条路径没折**。这就是本规范反复在拆的那一族的又一种形状:同一件事两套口径, +坏的那一套不抛、不报错,只是看不见(§22 的格线双作者、§24.5 的序号双口径,同族)。 + +也不是 P20 改坏的:那次提交 33 增 17 删**全在属性形状上**,编译门绿, +他的 `Editor.log` 里这次导入只有一条无关的 `CS0414`——排除归因用的是"diff 里除形状之外没有别的行"这一条。 + +### 28.3 落法:折法进纯算术,范围每帧现问,读数印在报表里 + +- 新增 `XChartVectorFieldMath.TryCubePoint(x, y, z, minX..maxZ, out cube)`:每一维按**它自己的显示范围** + 映到 `[-1,1]`。**任何一维折不出来(跨度 ≤0、值或端点非有限)就整体拒答**——半归一化的坐标比不 + 归一化的更难查:它会画出一个"看着像个箭头、方向却不对"的东西。折法放进纯算术是为了离线钉得住。 +- 工具侧:三条轴的范围**每帧现问上下文**(覆盖优先,否则该维聚合;范围不归元素存,与散点同一条规矩), + 读点改成 `TryReadPoint`,读不出来的点计入 `skipped=` 而不是静默少画。 +- 报表新增两个读数:`dom=x[..] y[..] z[..]` 与 `skipped=`。**折不出来就印 `dom=-`,那时一支都不画** + ——"为什么没有"当场说话,不用回去猜。(他这份表应当印出 `dom=x[-100..50] …`、`arrows=记录数−1`。) + +### 28.4 判据 + +- 探针 **458 项 0 失败**(新增 8 条 `vector field cube:`):域两端落 ±1、域中落 0、 + 像他表里那种量级的记录在给定域下折进盒子内、**域外保持成比例而不是被夹住**(夹住=把数据改了)、 + 零跨度拒答、非有限拒答、坏一轴整体拒答。全是性质判据,不写手算中间值。 +- `p4_control` 新增 3 支臂,各红在自己点名的断言上:不折(原始值直接当立方体单位)、 + 坏一轴也照答、偷偷 `Clamp` 住。 +- `dirty_gate.py` 新增 **claim F**:箭头这条路径的坐标必须经 `XChartVectorFieldMath.TryCubePoint`—— + 原始值直接进 `new Vector3(` 就红(这一条是"形状对、画面空"这一类的门,不是通用规则,所以只挂在这个文件上)。 + 配一支变异 `M8_rawcoord`:**八支全红**,正本 `knobs=132 takesEffect=132 findings=0`。 +- 编译门 runtime + player + editor + 3 支对照 `GATE PASSED`(`chain_p21.txt rc=0`)。 + +**两条判据自身的错,记在这里**:① `M8` 第一版是**绿的**——不是判据弱,是 claim F 用来认文件的参数 +被 claim C 的 `for name in names` 重新绑定了(`judge(lines, name)` 里 `name` 既是文件名又当旋钮名, +循环跑完它就等于最后一个旋钮的名字 ⇒ F 支永远不执行)。**"臂能不能红"这件事第一次是靠它自己抓到的**。 +规矩:给"按文件生效的判据"传参,参数名不许与函数体内的循环变量同名(这次改成 `source`)。 +② 门脚本声明 `coding: ascii`,我把中文写进注释就直接 `SyntaxError`——中文只进仓内文档,不进脚本。 + +### 28.5 留给现场与下一轮的(没偷改) + +- **他这份数据的读法**:`Absolute` 下"方向=下一条记录的坐标",一串姿态点应当用 **`Relative`** + (首尾相接=轨迹方向)。这不是 bug,是两种读法各自适配的数据形状。 +- `XMeshPreviewChart` 的示例数据仍是**旧的"一条记录 6 维"口径**(方向存第 4~6 维): + 新口径下那三列是**死数据**,画出来的是"每条记录位置 → 0.25×下一条记录位置"。 + 按"相邻两条"重造这份 demo 之前,要先确认它还想不想同时喂散点元素(一对记录里第二条也会成为一个点)。 diff --git a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs index 928523a..4f06f8c 100644 --- a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs +++ b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs @@ -117,6 +117,12 @@ namespace XericUI.XChart.Mesh private int m_DimensionsHave; private int m_DimensionsNeed; private int m_RecordsHave; + private int m_PointsSkipped; + + // 三条坐标轴各自的显示范围(每帧现问上下文要:覆盖优先、否则该维聚合)。 + // 数据值必须经它们折成立方体单位才投影——直接当立方体单位用会把整场箭头投到盒子外面(§28) + private double m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ; + private bool m_HasDomains; private struct ArrowFace { @@ -217,8 +223,10 @@ namespace XericUI.XChart.Mesh m_ArrowsBuilt = 0; m_DimensionsHave = 0; m_RecordsHave = 0; + m_PointsSkipped = 0; m_DimensionsNeed = RequiredDimensionCount; m_CurveEntries = 0; + m_HasDomains = false; m_PathRenderer = Continuous ? (CurveRenderer != null ? "curve" : "fill") : "-"; var source = Data; @@ -231,6 +239,11 @@ namespace XericUI.XChart.Mesh if (m_DimensionsHave < CoordinateDimension + RequiredDimensionCount) return; if (m_RecordsHave < RequiredRecordCount) return; + // 坐标得按各维的显示范围折进盒子(±1=盒子边界)。折不出来就一支都不画, + // 而不是拿原始值硬投影——后者是"计数全对、画面空无一物"的那条路(§28) + m_HasDomains = TryResolveDomains(); + if (!m_HasDomains) return; + // 一支箭头=相邻两条记录 ⇒ 支数由纯算术算(离线钉着:记录不够 vs 维数不够要分得清) int limit = XChartVectorFieldMath.ArrowCount(m_RecordsHave, MaxArrowCount); @@ -243,8 +256,12 @@ namespace XericUI.XChart.Mesh for (int i = 0; i < limit; i++) { - Vector3 first = ReadPoint(source, i); - Vector3 second = ReadPoint(source, i + 1); + Vector3 first, second; + if (!TryReadPoint(source, i, out first) || !TryReadPoint(source, i + 1, out second)) + { + m_PointsSkipped++; + continue; + } // 两种读法的算式在纯算术里(离线钉着):绝对=第二条的坐标就是方向;相对=它是第二个点 Vector3 tip = XChartVectorFieldMath.Tip(VectorMode, first, second, DirectionScale); if (AddArrow(space, first, tip, ColorAt(source, i), ColorAt(source, i + 1))) m_ArrowsBuilt++; @@ -264,7 +281,13 @@ namespace XericUI.XChart.Mesh { m_Pixels.Clear(); for (int i = 0; i <= limit; i++) - m_Pixels.Add(space.Project(ReadPoint(source, i), m_Composed)); + { + Vector3 cube; + // 跳过的点要报出来:曲线的位置按"活下来的点"排,颜色仍按记录号取——数据里 + // 有非有限值时这两者会错开,不印出来的话就只能靠猜(skipped= 那一读数的全部意义) + if (!TryReadPoint(source, i, out cube)) { m_PointsSkipped++; continue; } + m_Pixels.Add(space.Project(cube, m_Composed)); + } int segments = m_Pixels.Count - 1; if (segments < 1) return; @@ -390,12 +413,36 @@ namespace XericUI.XChart.Mesh return true; } - private Vector3 ReadPoint(IXChartDataSource source, int record) + /// + /// 三条坐标轴各自的显示范围——每帧现问上下文要(覆盖优先,否则该维聚合;规则在 + /// )。范围不归元素存:元素只说要哪几维,自己再存一份就是 + /// "点和轴对不上"的来路(与散点同一条规矩,§16)。 + /// + private bool TryResolveDomains() { - return new Vector3( - (float)source.GetValueAt(record, CoordinateDimension), - (float)source.GetValueAt(record, CoordinateDimension + 1), - (float)source.GetValueAt(record, CoordinateDimension + 2)); + m_MinX = m_MaxX = m_MinY = m_MaxY = m_MinZ = m_MaxZ = 0d; + var context = Context; + if (context == null) return false; + return context.TryResolveDomain(CoordinateDimension, out m_MinX, out m_MaxX) + && context.TryResolveDomain(CoordinateDimension + 1, out m_MinY, out m_MaxY) + && context.TryResolveDomain(CoordinateDimension + 2, out m_MinZ, out m_MaxZ); + } + + /// + /// 一条记录 → 立方体单位的点。原始值先按各维范围折进 [-1,1] 再投影 + /// (折法在纯算术里,离线钉着:)。 + /// 折不出来(值非有限、或那一维跨度为 0)就返回 false,调用方计入 skipped=—— + /// 不是"静默少一支",是"少几支当场说"。 + /// + private bool TryReadPoint(IXChartDataSource source, int record, out Vector3 cube) + { + cube = Vector3.zero; + if (record < 0 || record >= m_RecordsHave) return false; + return XChartVectorFieldMath.TryCubePoint( + source.GetValueAt(record, CoordinateDimension), + source.GetValueAt(record, CoordinateDimension + 1), + source.GetValueAt(record, CoordinateDimension + 2), + m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ, out cube); } /// @@ -439,7 +486,15 @@ namespace XericUI.XChart.Mesh base.AppendDebugLine(sb); sb.Append(" dims=").Append(m_DimensionsHave).Append('/').Append(m_DimensionsNeed) .Append(" records=").Append(m_RecordsHave) + // 坐标按这三个范围折进盒子;dom=- 就是"折不出来 ⇒ 一支都不画", + // 而 arrows>0 而 dom=- 不可能同时出现(那道门在算支数之前) + .Append(" dom=").Append(m_HasDomains + ? "x[" + m_MinX.ToString("0.###") + ".." + m_MaxX.ToString("0.###") + "] y[" + + m_MinY.ToString("0.###") + ".." + m_MaxY.ToString("0.###") + "] z[" + + m_MinZ.ToString("0.###") + ".." + m_MaxZ.ToString("0.###") + "]" + : "-") .Append(" arrows=").Append(m_ArrowsBuilt) + .Append(" skipped=").Append(m_PointsSkipped) .Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute")) .Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single") .Append(" path=").Append(m_PathRenderer) diff --git a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs index de4e9a9..52f52e1 100644 --- a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs +++ b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs @@ -1,4 +1,5 @@ using UnityEngine; +using XericUI.XChart; namespace XericUI.XChart.Mesh { @@ -10,6 +11,33 @@ namespace XericUI.XChart.Mesh /// public static class XChartVectorFieldMath { + /// + /// 一条记录的原始三值 → 立方体单位:每一维按它自己的显示范围映到 [-1,1] + /// (±1 就是盒子边界),与散点、圆柱走的是同一套()。 + /// + /// 为什么单独有这么一个函数:箭头以前把数据值直接当成立方体单位用了, + /// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有 + /// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归, + /// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。 + /// + /// 任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答—— + /// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。 + /// + public static bool TryCubePoint(double x, double y, double z, + double minX, double maxX, double minY, double maxY, double minZ, double maxZ, + out Vector3 cube) + { + cube = Vector3.zero; + + float nx, ny, nz; + if (!XChartBindingMath.TryNormalize(x, minX, maxX, out nx) + || !XChartBindingMath.TryNormalize(y, minY, maxY, out ny) + || !XChartBindingMath.TryNormalize(z, minZ, maxZ, out nz)) return false; + + cube = new Vector3(nx, ny, nz); + return true; + } + /// /// 末端位置。= 时 /// 是方向矢量本身(起点 + 方向×倍率);