XChart P21:矢量场没渲染的根因是箭头把数据值当立方体单位用了——现在它也折进盒子

他报"矢量场现在没有在渲染"。我先从他自己的资产里取状态,不猜:
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,得先确认它还想不想同时喂散点元素。
This commit is contained in:
2026-10-26 10:17:37 +08:00
parent db4a6fc3b9
commit cb759fe583
4 changed files with 152 additions and 8 deletions
+1
View File
@@ -96,6 +96,7 @@ P17 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规
P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确口径重写):① **序号不是给人设的**——*注册序*由**类型**定好(定义几何的那一类天然靠前、数据呈现那一类靠后),面板**只显示、不给输入控件**;*绘制序*与**元素在表里的位置**绑定(上移/下移就是改绘制顺序),也不再有第二个手填的序号——序号能手填就会出现两条口径(位置 vs 数字)指向不同事实,"上移之后绘制顺序变没变"就没人回答得了。第一版我把 `R… D…` 做成了两个窄输入框,他现场否掉("我根本不想给它设置这个序号"),而且那对输入框还会露出拖拽光标、窄到数字看不见 ⇒ 改成**文本读数**并就地刷新(面板树在值变化时不重建)。② **矢量场的数据口径写错了**:正确是**前三维=坐标 x/y/z**(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4~7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。 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` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。 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<T>()`),缺的是第二半——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<T>(toolName)`(`FindTool<T>` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element<T>()`(走 `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,纯算文件一个没动。**覆盖不到**:画面观感归他现场判。 P20 外部数据驱动访问(规范 §27,2026-10-26 他问"我能不能直接拿到圆柱渲染器,改属性就自动置脏"):**入口本来就有**(`ToolManager.FindTool<T>()`),缺的是第二半——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<T>(toolName)`(`FindTool<T>` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element<T>()`(走 `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 ## [0.1.6] - 2026-07-01
+60
View File
@@ -1865,3 +1865,63 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
2. `chart.Space.HalfEdge = 260f;` —— 整张图的尺度跟着走(空间的脏就是投影脏,其余工具靠 `ProjectionVersion` 跟着重算)。 2. `chart.Space.HalfEdge = 260f;` —— 整张图的尺度跟着走(空间的脏就是投影脏,其余工具靠 `ProjectionVersion` 跟着重算)。
3. `chart.DataModel.TryAddRecord(t, values)` —— 和以前一样;数据这条路一直是自动的。 3. `chart.DataModel.TryAddRecord(t, values)` —— 和以前一样;数据这条路一直是自动的。
4. 做完第 1 条后去面板动**任意**一个元素字段 ⇒ 圆柱回到配置里的值。这就是 27.3 说的覆盖,属预期,不是回归。 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 之前,要先确认它还想不想同时喂散点元素(一对记录里第二条也会成为一个点)。
+63 -8
View File
@@ -117,6 +117,12 @@ namespace XericUI.XChart.Mesh
private int m_DimensionsHave; private int m_DimensionsHave;
private int m_DimensionsNeed; private int m_DimensionsNeed;
private int m_RecordsHave; 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 private struct ArrowFace
{ {
@@ -217,8 +223,10 @@ namespace XericUI.XChart.Mesh
m_ArrowsBuilt = 0; m_ArrowsBuilt = 0;
m_DimensionsHave = 0; m_DimensionsHave = 0;
m_RecordsHave = 0; m_RecordsHave = 0;
m_PointsSkipped = 0;
m_DimensionsNeed = RequiredDimensionCount; m_DimensionsNeed = RequiredDimensionCount;
m_CurveEntries = 0; m_CurveEntries = 0;
m_HasDomains = false;
m_PathRenderer = Continuous ? (CurveRenderer != null ? "curve" : "fill") : "-"; m_PathRenderer = Continuous ? (CurveRenderer != null ? "curve" : "fill") : "-";
var source = Data; var source = Data;
@@ -231,6 +239,11 @@ namespace XericUI.XChart.Mesh
if (m_DimensionsHave < CoordinateDimension + RequiredDimensionCount) return; if (m_DimensionsHave < CoordinateDimension + RequiredDimensionCount) return;
if (m_RecordsHave < RequiredRecordCount) return; if (m_RecordsHave < RequiredRecordCount) return;
// 坐标得按各维的显示范围折进盒子(±1=盒子边界)。折不出来就一支都不画,
// 而不是拿原始值硬投影——后者是"计数全对、画面空无一物"的那条路(§28)
m_HasDomains = TryResolveDomains();
if (!m_HasDomains) return;
// 一支箭头=相邻两条记录 ⇒ 支数由纯算术算(离线钉着:记录不够 vs 维数不够要分得清) // 一支箭头=相邻两条记录 ⇒ 支数由纯算术算(离线钉着:记录不够 vs 维数不够要分得清)
int limit = XChartVectorFieldMath.ArrowCount(m_RecordsHave, MaxArrowCount); int limit = XChartVectorFieldMath.ArrowCount(m_RecordsHave, MaxArrowCount);
@@ -243,8 +256,12 @@ namespace XericUI.XChart.Mesh
for (int i = 0; i < limit; i++) for (int i = 0; i < limit; i++)
{ {
Vector3 first = ReadPoint(source, i); Vector3 first, second;
Vector3 second = ReadPoint(source, i + 1); if (!TryReadPoint(source, i, out first) || !TryReadPoint(source, i + 1, out second))
{
m_PointsSkipped++;
continue;
}
// 两种读法的算式在纯算术里(离线钉着):绝对=第二条的坐标就是方向;相对=它是第二个点 // 两种读法的算式在纯算术里(离线钉着):绝对=第二条的坐标就是方向;相对=它是第二个点
Vector3 tip = XChartVectorFieldMath.Tip(VectorMode, first, second, DirectionScale); Vector3 tip = XChartVectorFieldMath.Tip(VectorMode, first, second, DirectionScale);
if (AddArrow(space, first, tip, ColorAt(source, i), ColorAt(source, i + 1))) m_ArrowsBuilt++; 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(); m_Pixels.Clear();
for (int i = 0; i <= limit; i++) 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; int segments = m_Pixels.Count - 1;
if (segments < 1) return; if (segments < 1) return;
@@ -390,12 +413,36 @@ namespace XericUI.XChart.Mesh
return true; return true;
} }
private Vector3 ReadPoint(IXChartDataSource source, int record) /// <summary>
/// 三条坐标轴各自的显示范围——<b>每帧现问上下文要</b>(覆盖优先,否则该维聚合;规则在
/// <see cref="XChartDomainMath"/>)。范围不归元素存:元素只说要哪几维,自己再存一份就是
/// "点和轴对不上"的来路(与散点同一条规矩,§16)。
/// </summary>
private bool TryResolveDomains()
{ {
return new Vector3( m_MinX = m_MaxX = m_MinY = m_MaxY = m_MinZ = m_MaxZ = 0d;
(float)source.GetValueAt(record, CoordinateDimension), var context = Context;
(float)source.GetValueAt(record, CoordinateDimension + 1), if (context == null) return false;
(float)source.GetValueAt(record, CoordinateDimension + 2)); 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);
}
/// <summary>
/// 一条记录 → <b>立方体单位</b>的点。原始值先按各维范围折进 [-1,1] 再投影
/// (折法在纯算术里,离线钉着:<see cref="XChartVectorFieldMath.TryCubePoint"/>)。
/// 折不出来(值非有限、或那一维跨度为 0)就返回 false,调用方计入 <c>skipped=</c>——
/// <b>不是"静默少一支",是"少几支当场说"</b>。
/// </summary>
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);
} }
/// <summary> /// <summary>
@@ -439,7 +486,15 @@ namespace XericUI.XChart.Mesh
base.AppendDebugLine(sb); base.AppendDebugLine(sb);
sb.Append(" dims=").Append(m_DimensionsHave).Append('/').Append(m_DimensionsNeed) sb.Append(" dims=").Append(m_DimensionsHave).Append('/').Append(m_DimensionsNeed)
.Append(" records=").Append(m_RecordsHave) .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(" arrows=").Append(m_ArrowsBuilt)
.Append(" skipped=").Append(m_PointsSkipped)
.Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute")) .Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute"))
.Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single") .Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single")
.Append(" path=").Append(m_PathRenderer) .Append(" path=").Append(m_PathRenderer)
@@ -1,4 +1,5 @@
using UnityEngine; using UnityEngine;
using XericUI.XChart;
namespace XericUI.XChart.Mesh namespace XericUI.XChart.Mesh
{ {
@@ -10,6 +11,33 @@ namespace XericUI.XChart.Mesh
/// </summary> /// </summary>
public static class XChartVectorFieldMath public static class XChartVectorFieldMath
{ {
/// <summary>
/// 一条记录的原始三值 → <b>立方体单位</b>:每一维按<b>它自己的显示范围</b>映到 [-1,1]
/// (±1 就是盒子边界),与散点、圆柱走的是同一套(<see cref="XChartBindingMath.TryNormalize"/>)。
///
/// <para><b>为什么单独有这么一个函数</b>:箭头以前把数据值<b>直接当成立方体单位</b>用了,
/// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有
/// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归,
/// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。</para>
///
/// <para><b>任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答</b>——
/// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。</para>
/// </summary>
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;
}
/// <summary> /// <summary>
/// 末端位置。<paramref name="mode"/>=<see cref="XChartArrowVectorMode.Absolute"/> 时 /// 末端位置。<paramref name="mode"/>=<see cref="XChartArrowVectorMode.Absolute"/> 时
/// <paramref name="second"/> 是<b>方向矢量</b>本身(起点 + 方向×倍率); /// <paramref name="second"/> 是<b>方向矢量</b>本身(起点 + 方向×倍率);