P29b:方向来源删到三档(0 号档删除),资产里存的值 0 迁到 1

他 2026-11-08 从三个选项里选了"删 0 号、数据迁到 NextRecordAsPoint"。
序号 1/2/3 不许改——资产存的就是这些数(m_DirectionSource),换序号就是换含义,
所以 0 号只能空着:只有值迁移,没有重新编号。默认值两处跟着改(新元素才受默认值管),
他预制里那个 0 靠迁移脚本:先落备份、判决从读回的文件里取,不信改写。

判据跟改后照旧:探针 473 项 0 失败("方向是矢量本身"改打在 AlternatingRecords,
"点到点作差"照打 NextRecordAsPoint,两条还能在同一份数据上分开=覆盖没少)、
p4_control 73 支各红在点名断言(那支的期望断言标签同步改,否则臂红了没人认它)、
dirty_gate knobs=136 takesEffect=136 findings=0、编译门三臂 + 3 对照绿。

迁移前后的 --check 是一对:红(1 条,退出 1)→ 绿(0 条,退出 0);
被改的就是 Assets/Prefabs/0n_Panel/SP_盾构机掘进姿态 Variant.prefab 第 703 行,
画面要重导入才变。
This commit is contained in:
2026-11-08 21:52:27 +08:00
parent ae992c6bd7
commit 05b55e983f
6 changed files with 49 additions and 31 deletions
+2
View File
@@ -105,6 +105,8 @@ P28 面边插槽 6×4=24(规范 §31,2026-10-26 他数的两件事):
P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。 P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。
P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底各自在做什么(规范 §33,2026-10-26 他试完四档报"看起来完全没有意义"):先把四种现象各自算清(用他自己那张表的数字:三列 x/y/z、域约 `x[-100..100] y[-49.9..49.9] z[-49.7..50]`、`DirectionScale=0.25`)——`NextRecordAsVector` 拿"下一条记录**折好的坐标**"当方向 ⇒ 长度上限就是 0.25 个盒半径(一截短矢量);`NextRecordAsPoint` 拿相邻两点的差 ⇒ 同样短、略有区别;`ThisRecordCarriesVector` 要 6 个数值维而表里只有 3 列 ⇒ **一支都不画**(这是正确的拒绝,`dims=3/6`,缺的是数据里的方向列);`AlternatingRecords` 拿奇数行的**原始值**当方向、**没折** ⇒ `(-93.5,10.1,49.0)×0.25 ≈ 23 个立方体单位 ≈ 2700 像素` ⇒ 他看到的"一根比终点还大的矢量"。前两档的"没意义"来自他的表没有方向列(把位置当方向用本来就是凑数的一档);**第四档是真 bug**:位置除以了跨度、方向没有,同一个 `DirectionScale` 底下一套值两种单位。修法=纯算术新增 `XChartCubeFoldMath.TryFoldDelta(dx,dy,dz, 各轴 min/max, out cubeDelta)` = `delta/span×2`:**不减 min**(位置折的是"在这列数据里的位置",方向折的是"多长、朝哪",减起点会把朝向变成在哪——全表平移会挪走所有箭头);**一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度,`DirectionScale` 回到"再乘多少倍"的本分;**不吃 `OutOfRange`**(钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向);折不出来(某列跨度 ≤0 或非有限)这一条拒画,`hidden=`(尺度没用)与 `skipped=`(数据坏)分开数。判据:探针 **473** 项 0 失败,4 条打在性质上(零方向仍是零——位置折法在这里会答 −1,这条就是两套折法的分界;一个跨度=2 个单位;成比例且带符号;跨度 0/非有限拒答)+ `p4_control` **73** 支各红在点名断言(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状)+ 编译门三臂 + 3 对照绿(`chain_p29.txt`)。等他定的那一半我没动:旧 `NextRecordAsVector` 去留(他预制存的就是序号 0),三个选项与我的建议已给出,删档或改默认都会改他画面上的东西,属于待答项不是我该拍的实现细节。 P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底各自在做什么(规范 §33,2026-10-26 他试完四档报"看起来完全没有意义"):先把四种现象各自算清(用他自己那张表的数字:三列 x/y/z、域约 `x[-100..100] y[-49.9..49.9] z[-49.7..50]`、`DirectionScale=0.25`)——`NextRecordAsVector` 拿"下一条记录**折好的坐标**"当方向 ⇒ 长度上限就是 0.25 个盒半径(一截短矢量);`NextRecordAsPoint` 拿相邻两点的差 ⇒ 同样短、略有区别;`ThisRecordCarriesVector` 要 6 个数值维而表里只有 3 列 ⇒ **一支都不画**(这是正确的拒绝,`dims=3/6`,缺的是数据里的方向列);`AlternatingRecords` 拿奇数行的**原始值**当方向、**没折** ⇒ `(-93.5,10.1,49.0)×0.25 ≈ 23 个立方体单位 ≈ 2700 像素` ⇒ 他看到的"一根比终点还大的矢量"。前两档的"没意义"来自他的表没有方向列(把位置当方向用本来就是凑数的一档);**第四档是真 bug**:位置除以了跨度、方向没有,同一个 `DirectionScale` 底下一套值两种单位。修法=纯算术新增 `XChartCubeFoldMath.TryFoldDelta(dx,dy,dz, 各轴 min/max, out cubeDelta)` = `delta/span×2`:**不减 min**(位置折的是"在这列数据里的位置",方向折的是"多长、朝哪",减起点会把朝向变成在哪——全表平移会挪走所有箭头);**一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度,`DirectionScale` 回到"再乘多少倍"的本分;**不吃 `OutOfRange`**(钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向);折不出来(某列跨度 ≤0 或非有限)这一条拒画,`hidden=`(尺度没用)与 `skipped=`(数据坏)分开数。判据:探针 **473** 项 0 失败,4 条打在性质上(零方向仍是零——位置折法在这里会答 −1,这条就是两套折法的分界;一个跨度=2 个单位;成比例且带符号;跨度 0/非有限拒答)+ `p4_control` **73** 支各红在点名断言(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状)+ 编译门三臂 + 3 对照绿(`chain_p29.txt`)。等他定的那一半我没动:旧 `NextRecordAsVector` 去留(他预制存的就是序号 0),三个选项与我的建议已给出,删档或改默认都会改他画面上的东西,属于待答项不是我该拍的实现细节。
注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。 注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。
P29b 方向来源删到三档 + 资产值迁移(规范 §33.4,2026-11-08 他从三个选项里选了"删 0 号、值迁到 NextRecordAsPoint"):**序号 1/2/3 不许改**——资产存的就是这些数(`m_DirectionSource`),换序号就是换含义,所以 0 号只能空着,只有值迁移(选项 ② 被排除正是这个原因:它会把存着的 0 读成另一档)。默认值两处跟着改(`ChartToolVectorArrows` 与 `XChartVolumeConfigs`),但默认只管新建的元素,他预制里那个 0 不靠默认值救,靠迁移。迁移脚本 `.ximage-gate/migrate_direction_source.py`:扫工程 Assets 下的 .prefab/.unity,两种字段名都认(现名 `m_DirectionSource` 和 `[FormerlySerializedAs]` 的旧名 `m_VectorMode`),**先落备份再写,判决读回文件而不是信改写**——期望行 `m_DirectionSource: 1` 真出现才算通过,残留 0 就红。两份日志正好是一对:迁移前 `--check` 红(1 条,退出 1)→ 迁移后 `--check` 绿(0 条,退出 0),被改的就是 `SP_盾构机掘进姿态 Variant.prefab` 第 703 行;画面要重导入才变(改的是 YAML 本体)。**限制说清楚**:只扫了他当前工程的 Assets(1 处);别的项目/备份里存 0 的不会报错,它靠 `switch` 的 `default` 那一支跑,画出来的正是被删掉的那个含义,而面板下拉里已经没有这一项,所以 Inspector 上会显示成对不上号的值。判据跟着改:探针 **473** 照旧 0 失败("方向是矢量本身"那条从 0 号档改打在 `AlternatingRecords`、"点到点作差"照打 `NextRecordAsPoint`——两条还能在同一份数据上分开,所以覆盖没少)+ `p4_control` **73** 支照旧各红在点名断言(那支改名 "point-to-point reuses the carries-direction rule",**期望断言标签同步改**,否则臂红了却没人认它的断言)+ `dirty_gate` `knobs=136 takesEffect=136 findings=0` + 编译门三臂 + 3 对照绿。
合并他那 17 条 ShaderBake 提交(gitea/thr_dev/dev2,2026-11-05/06)到 thr_dev/dev_chart(`ae992c6`,已推):两条线从 a311c41 分叉,文件集只共用 `XericRegistrationPaths.cs`,他那侧只新增 `ToolBar` 常量、两套根都保住(工具栏 `XericLibrary/Action Vessel`、右键 `Xeric Library/Action Vessel`),入口走常量没有硬编码 ⇒ 无冲突。**门先整轮红在环境不是代码**:rsp 记录的引擎 `U:/UNITY_Engine/editor/2022.1.24f1` 已经不在(U: 上那版只剩安装包),同版本在 `G:/Unity_EngineFlie/Unity 2022.1.24f1`;给 `run_gate.py` 加"引用按引擎根重映射 + 逐臂计数 + 开头点名读的是哪个引擎根"(211 条引用全部能在那边解析),`probe_run.py` 的 mono 路径同规则。重跑三臂 + 3 对照绿,并且正向确认 ShaderBake 的 **11 runtime + 8 editor** 文件真进了被编译的清单——rsp 是快照,新文件靠 `scan_dir` 补,不补就会"绿着跳过"它们。
## [0.1.6] - 2026-07-01 ## [0.1.6] - 2026-07-01
+1 -2
View File
@@ -102,11 +102,10 @@ public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }
## 5. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算 ## 5. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算
`ChartToolVectorArrows` 是"线 + 库的原生标记",**没有填充几何**(§29)。四档方向来源决定支数和维数需求(§30): `ChartToolVectorArrows` 是"线 + 库的原生标记",**没有填充几何**(§29)。三档方向来源决定支数和维数需求(§30;序号 0 已删,资产里存过 0 的要迁移):
| `DirectionSource` | 起点 | 方向/第二量 | 支数 | 需要的数值维 | | `DirectionSource` | 起点 | 方向/第二量 | 支数 | 需要的数值维 |
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
| `NextRecordAsVector`(旧 Absolute) | 第 i 条 0~2 | 第 i+1 条 0~2 | N−1 | 3 |
| `NextRecordAsPoint`(旧 Relative,**首尾相接**) | 第 i 条 0~2 | 第 i+1 条 0~2(作差) | N−1 | 3 | | `NextRecordAsPoint`(旧 Relative,**首尾相接**) | 第 i 条 0~2 | 第 i+1 条 0~2(作差) | N−1 | 3 |
| `ThisRecordCarriesVector`(**一条记录一个箭头**) | 第 i 条 0~2 | **同一条**的 3~5(原始矢量) | N | 6 | | `ThisRecordCarriesVector`(**一条记录一个箭头**) | 第 i 条 0~2 | **同一条**的 3~5(原始矢量) | N | 6 |
| `AlternatingRecords`(**分段**:偶点奇向) | 偶数条 0~2 | 奇数条 0~2(原始矢量) | N÷2 | 3 | | `AlternatingRecords`(**分段**:偶点奇向) | 偶数条 0~2 | 奇数条 0~2(原始矢量) | N÷2 | 3 |
+31 -13
View File
@@ -1879,7 +1879,7 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
他报"矢量场现在没有在渲染"。我从 `Assets/Prefabs/0n_Panel/SP_盾构机掘进姿态 Variant.prefab` 里直接读到: 他报"矢量场现在没有在渲染"。我从 `Assets/Prefabs/0n_Panel/SP_盾构机掘进姿态 Variant.prefab` 里直接读到:
- 数据表:**x / y / z 三个数值维**,记录值量级 **−100 .. 50**(三条以上); - 数据表:**x / y / z 三个数值维**,记录值量级 **−100 .. 50**(三条以上);
- 箭头元素:`m_Enabled=1`、`m_VectorMode=0(Absolute)`、`m_Continuous=0`、`m_UseColorDimensions=0`、`m_MaxArrowCount=512`。 - 箭头元素:`m_Enabled=1`、`m_VectorMode=0(Absolute)`(这一档 2026-11-08 已删,那份资产的值当场迁成 1,见 §33.4)、`m_Continuous=0`、`m_UseColorDimensions=0`、`m_MaxArrowCount=512`。
⇒ 形状是够的(需要 3、现有 3;面板那句"一条都不画"不会亮,报表 `dims=3/3` 也正常), ⇒ 形状是够的(需要 3、现有 3;面板那句"一条都不画"不会亮,报表 `dims=3/3` 也正常),
所以问题不在 §25.1 那一层,而在**尺度**这一层。 所以问题不在 §25.1 那一层,而在**尺度**这一层。
@@ -2002,7 +2002,7 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
4. 若画面仍然什么都没有 ⇒ 读报表那一行的 `path= / arrows= / markers= / curveVerts=`。 4. 若画面仍然什么都没有 ⇒ 读报表那一行的 `path= / arrows= / markers= / curveVerts=`。
现在箭头这条路上没有"填充"那一层了,读数能给的解释比上一版窄——这正是这次改动的目的。 现在箭头这条路上没有"填充"那一层了,读数能给的解释比上一版窄——这正是这次改动的目的。
## 30. P24:方向来源四档、头的尺寸吃投影、锚点字段(2026-10-26 他三条要求) ## 30. P24:方向来源四档(0 号 2026-11-08 删,见 §33.4)、头的尺寸吃投影、锚点字段(2026-10-26 他三条要求)
### 30.1 他指出的两件事 ### 30.1 他指出的两件事
@@ -2013,23 +2013,23 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
2. **`Absolute` 下"方向的来源"应该是可选的**,而且支数要跟着一起来: 2. **`Absolute` 下"方向的来源"应该是可选的**,而且支数要跟着一起来:
他说"要让一个箭头对应两组数据,32 个点上就只该有 16 个箭头,而现在有 32 个"。 他说"要让一个箭头对应两组数据,32 个点上就只该有 16 个箭头,而现在有 32 个"。
### 30.2 四档方向来源(`XChartArrowDirectionSource`,算式全在 `XChartVectorFieldMath`) ### 30.2 方向来源(`XChartArrowDirectionSource`,算式全在 `XChartVectorFieldMath`)——三档,序号 0 是空的
| 档 | 起点 | 方向/第二量 | 支数 | 要几个数值维 | | 档 | 起点 | 方向/第二量 | 支数 | 要几个数值维 |
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
| `NextRecordAsVector`(旧 Absolute) | 第 i 条 0~2 | 第 i+1 条 0~2(折进盒子后的坐标当方向) | N−1 | 3 |
| `NextRecordAsPoint`(旧 Relative) | 第 i 条 0~2 | 第 i+1 条 0~2(**第二个点**,作差) | N−1 | 3 | | `NextRecordAsPoint`(旧 Relative) | 第 i 条 0~2 | 第 i+1 条 0~2(**第二个点**,作差) | N−1 | 3 |
| `ThisRecordCarriesVector` | 第 i 条 0~2 | **同一条**的 3~5(原始矢量) | N | 6 | | `ThisRecordCarriesVector` | 第 i 条 0~2 | **同一条**的 3~5(原始矢量) | N | 6 |
| `AlternatingRecords`(分段) | **偶数**条 0~2 | **奇数**条 0~2(原始矢量) | N÷2 | 3 | | `AlternatingRecords`(分段) | **偶数**条 0~2 | **奇数**条 0~2(原始矢量) | N÷2 | 3 |
- **支数与维数只有这一个实现**:`ArrowCount(source,…)` / `RequiredCoordinateDimensions(source)`。 - **支数与维数只有这一个实现**:`ArrowCount(source,…)` / `RequiredCoordinateDimensions(source)`。
四档的算法(`N−1 / N / N÷2`、`3 / 6`)一旦在工具里各写一遍,画面上只是"少几支",最难查。 三档的算法(`N−1 / N / N÷2`、`3 / 6`)一旦在工具里各写一遍,画面上只是"少几支",最难查。
- **方向是原始矢量,绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"—— - **方向是原始矢量,绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"——
一个 `(0,1,0)` 会被折成一个偏移量,于是整场箭头一起跑偏。它的尺度由 `DirectionScale`(每数据单位给多少立方体单位)说话。 一个 `(0,1,0)` 会被折成一个偏移量,于是整场箭头一起跑偏。它的尺度由 `DirectionScale`(每数据单位给多少立方体单位)说话。
- **兼容**:新枚举的 0/1 就是旧 `XChartArrowVectorMode` 的 Absolute/Relative,字段另加了 - **兼容**:新枚举的 1 就是旧 `XChartArrowVectorMode.Relative`,字段另加了
`[FormerlySerializedAs("m_VectorMode")]` ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改名静默丢值"的反面做法)。 `[FormerlySerializedAs("m_VectorMode")]` ⇒ 存过的值不用重设("换类型不换序号"是"改名静默丢值"的反面做法)。
序号 0 从 2026-11-08 起没有读法(那一档被删),资产里存过 0 的要跑迁移脚本(§33.4)。
- 他说"相对模式是一个点到另一个点,不用再算一次投影":这条本来就成立(两端都是投影点), - 他说"相对模式是一个点到另一个点,不用再算一次投影":这条本来就成立(两端都是投影点),
所以 `Tip` 只在 `NextRecordAsPoint` 那一档作差,其余三档第二量直接就是方向。 所以 `Tip` 只在 `NextRecordAsPoint` 那一档作差,其余两档第二量直接就是方向。
### 30.3 头的尺寸吃投影 + 锚点 ### 30.3 头的尺寸吃投影 + 锚点
@@ -2180,6 +2180,7 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
⇒ 前两档"没意义"是因为他的表里**没有方向列**(把位置当方向用,本来就是凑数的一档); ⇒ 前两档"没意义"是因为他的表里**没有方向列**(把位置当方向用,本来就是凑数的一档);
第四档才是真 bug:**位置除以了跨度、方向没有**——同一个 `DirectionScale` 底下一套值两种单位。 第四档才是真 bug:**位置除以了跨度、方向没有**——同一个 `DirectionScale` 底下一套值两种单位。
(上表是删之前的观察:2026-11-08 他把第一档删了、存的值 0 迁到 1,见 §33.4。)
### 33.2 修法:方向走"差折法",只缩不移位 ### 33.2 修法:方向走"差折法",只缩不移位
@@ -2198,9 +2199,26 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
- `p4_control` **73** 支各红在点名断言上(新 2 支:把方向按位置折(偏移混进来)/方向干脆不缩=他那根巨箭的形状)。 - `p4_control` **73** 支各红在点名断言上(新 2 支:把方向按位置折(偏移混进来)/方向干脆不缩=他那根巨箭的形状)。
- 编译门 runtime + player + editor + 3 对照绿(`chain_p29.txt`)。 - 编译门 runtime + player + editor + 3 对照绿(`chain_p29.txt`)。
### 33.4 还等他定的那一半(没擅自做) ### 33.4 0 号档的去留(2026-11-08 他定了:删档,存的值迁到 `NextRecordAsPoint`)
旧 `NextRecordAsVector` 的去留:他预制里存的就是这一档(`m_VectorMode: 0`)。三个选项与我的建议已经给他 三个选项(① 改名写明用途、② 删并把序号 0 让给 `AlternatingRecords`、③ 删、值迁到 1)里他选了 ③。落码:
(① 改名并写明"只给把方向写进位置列的表用";② 删,序号 0 迁到 `AlternatingRecords`;③ 删,迁到 `NextRecordAsPoint`——我建议这个)。
**删除或改默认都会改他画面上的东西**,所以这是待答项,不是我该替他拍的实现细节。 - **序号 1/2/3 不许改**:资产存的就是这些数(`m_DirectionSource`),换序号就是换含义——② 被排除正是这个原因,
他那边真要让矢量场有内容,缺的是**方向列**:多一列(或奇数行放方向),`AlternatingRecords` / `ThisRecordCarriesVector` 才是给矢量场用的两档。 它会把存着的 0 读成另一档。所以 0 号是**空档**,只有值迁移,没有重新编号。
- **默认值**跟着改到 `NextRecordAsPoint`(`ChartToolVectorArrows` 与 `XChartVolumeConfigs` 两处字段初值)。
默认只管新建的元素:他预制里那个 0 不靠默认值救,靠迁移。
- **迁移**=`.ximage-gate/migrate_direction_source.py`:扫工程 `Assets` 下的 `.prefab`/`.unity`,两种字段名都认
(现名 `m_DirectionSource` 和 `[FormerlySerializedAs]` 的旧名 `m_VectorMode`)。判决读回文件而不是信改写:
先落备份再写,写后重新读,期望行 `m_DirectionSource: 1` 真出现才算通过,残留 0 就红。
本轮的两份日志正好是一对:迁移前 `--check` 红(1 条,退出 1),迁移后 `--check` 绿(0 条,退出 0);
被改的那一条就是 `Assets/Prefabs/0n_Panel/SP_盾构机掘进姿态 Variant.prefab` 第 703 行。
**画面要重导入才变**:改的是 YAML 本体,编辑器里那张图得重导入或重启。
- **限制说清楚**:迁移只扫了他当前工程的 `Assets`(1 处)。别的项目或备份里存 0 的资产不会报错——
它会靠 `switch` 的 `default` 那一支跑,画出来的正是被删掉的那个含义("把坐标当方向"),而面板下拉里
已经没有这一项,所以 Inspector 上会显示成对不上号的值。这不是崩溃,是"读法靠 default 兜着、名字里没有了"。
判据跟着改:探针 **473** 条照旧 0 失败("方向是矢量本身"那条从 0 号档改打在 `AlternatingRecords`,"点到点作差"
照打 `NextRecordAsPoint`——两条还是能在同一份数据上分开,覆盖没少);`p4_control` **73** 支照旧各红在点名断言上
(那支改名 `point-to-point reuses the carries-direction rule`,期望断言标签同步改,否则臂红了却没人认它的断言);
编译门 runtime + player + editor + 3 对照绿。要让矢量场真有内容,缺的还是**方向列**:多 3 列(凑 6 个数值维)
或者让奇数行放方向,`ThisRecordCarriesVector` / `AlternatingRecords` 才是给矢量场用的两档。
+3 -3
View File
@@ -34,8 +34,8 @@ namespace XericUI.XChart.Mesh
private int m_CoordinateDimension; private int m_CoordinateDimension;
/// <summary>坐标的维度下标(x/y/z 三维)</summary> /// <summary>坐标的维度下标(x/y/z 三维)</summary>
public int CoordinateDimension { get => m_CoordinateDimension; set { m_CoordinateDimension = value; MarkDirty(); } } public int CoordinateDimension { get => m_CoordinateDimension; set { m_CoordinateDimension = value; MarkDirty(); } }
private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsVector; private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsPoint;
/// <summary>方向从哪来(四档,箭数与维数需求都跟着它变;算式在 XChartVectorFieldMath 里)</summary> /// <summary>方向从哪来(三档,箭数与维数需求都跟着它变;算式在 XChartVectorFieldMath 里)</summary>
public XChartArrowDirectionSource DirectionSource public XChartArrowDirectionSource DirectionSource
{ {
get => m_DirectionSource; get => m_DirectionSource;
@@ -266,7 +266,7 @@ namespace XericUI.XChart.Mesh
m_PointsSkipped++; m_PointsSkipped++;
continue; continue;
} }
// 读法在纯算术里:相邻两条·下一条是第二个点 ⇒ 作差;其余三档 ⇒ 第二量本身就是方向 // 读法在纯算术里:点到点那一档 ⇒ 作差;其余两档 ⇒ 第二量本身就是方向
Vector3 tip = XChartVectorFieldMath.Tip(DirectionSource, origin, second, DirectionScale); Vector3 tip = XChartVectorFieldMath.Tip(DirectionSource, origin, second, DirectionScale);
AddShaft(space, origin, tip, ColorAt(source, FirstRecordOf(i)), ColorAt(source, SecondRecordOf(i))); AddShaft(space, origin, tip, ColorAt(source, FirstRecordOf(i)), ColorAt(source, SecondRecordOf(i)));
m_ArrowsBuilt++; m_ArrowsBuilt++;
+8 -9
View File
@@ -7,14 +7,13 @@ namespace XericUI.XChart.Mesh
/// 一支箭头的<b>方向从哪来</b>(他 2026-10-26 补的口径:光有"相对/绝对"两个词表达不出 /// 一支箭头的<b>方向从哪来</b>(他 2026-10-26 补的口径:光有"相对/绝对"两个词表达不出
/// "一条记录自带方向"和"偶数点是点、奇数点是方向"这两种存法)。 /// "一条记录自带方向"和"偶数点是点、奇数点是方向"这两种存法)。
/// ///
/// <para><b>编号是有意接旧的</b>:0/1 就是原来 <c>XChartArrowVectorMode</c> 的 Absolute/Relative, /// <para><b>序号 0 是空的</b>:那里原来是"把下一条记录<b>折好的坐标</b>当方向"(旧 Absolute)。
/// 所以场景里存过的 <c>m_VectorMode</c> 值不用动就还是同一个意思(枚举换类型而序号不改=静默丢值的反面)。 /// 它只在"把方向写进位置列"的表上有读法——三列 x/y/z 的表里它等于拿位置凑方向,
/// 2/3 是新增的两档"方向是矢量"的存法。</para> /// 2026-11-08 他定了删掉这一档,数据一律走点到点。<b>1/2/3 不许改号</b>:资产里存的就是这些数
/// (<c>m_DirectionSource</c>),换序号就是换含义;存着 0 的资产由迁移脚本改成 1,逐资产点名。</para>
/// </summary> /// </summary>
public enum XChartArrowDirectionSource public enum XChartArrowDirectionSource
{ {
/// <summary>相邻两条、重叠:本条=起点,下一条的<b>坐标</b>就是方向矢量(旧 Absolute)。箭数=N−1</summary>
NextRecordAsVector = 0,
/// <summary>相邻两条、重叠:本条=起点,下一条=<b>第二个点</b>(旧 Relative,首尾相接)。箭数=N−1</summary> /// <summary>相邻两条、重叠:本条=起点,下一条=<b>第二个点</b>(旧 Relative,首尾相接)。箭数=N−1</summary>
NextRecordAsPoint = 1, NextRecordAsPoint = 1,
/// <summary>一条记录自带:0~2 维是点、3~5 维是方向矢量。箭数=N(要 6 个数值维)</summary> /// <summary>一条记录自带:0~2 维是点、3~5 维是方向矢量。箭数=N(要 6 个数值维)</summary>
@@ -104,7 +103,7 @@ namespace XericUI.XChart.Mesh
/// 末端位置。<paramref name="source"/>=<see cref="XChartArrowDirectionSource.NextRecordAsPoint"/> 时 /// 末端位置。<paramref name="source"/>=<see cref="XChartArrowDirectionSource.NextRecordAsPoint"/> 时
/// <paramref name="second"/> 是<b>第二个点</b>(起点 + 差向量×倍率,首尾相接); /// <paramref name="second"/> 是<b>第二个点</b>(起点 + 差向量×倍率,首尾相接);
/// 其余三档它就是<b>方向矢量</b>本身(起点 + 方向×倍率)。 /// 其余三档它就是<b>方向矢量</b>本身(起点 + 方向×倍率)。
/// 相邻两条的两档在同一个数据上画出来是两幅图:一片"刺猬"对一串首尾相接。 /// <para>同一个数据上两种读法是两幅图:一串首尾相接(点到点)对一片"刺猬"(方向由记录自己带)。</para>
/// </summary> /// </summary>
public static Vector3 Tip(XChartArrowDirectionSource source, Vector3 first, Vector3 second, float scale) public static Vector3 Tip(XChartArrowDirectionSource source, Vector3 first, Vector3 second, float scale)
{ {
@@ -116,7 +115,7 @@ namespace XericUI.XChart.Mesh
/// <summary> /// <summary>
/// 这一档方向来源<b>每个箭头自己要吃几个数值维</b>:自带方向那档要 6 个(0~2 点、3~5 方向), /// 这一档方向来源<b>每个箭头自己要吃几个数值维</b>:自带方向那档要 6 个(0~2 点、3~5 方向),
/// 其余三档只要 3 个(方向从别的记录来)。 /// 其余两档只要 3 个(方向从别的记录来)。
/// ///
/// <para>面板拿它和表里现有的维数对印(§25.1):维数不够时元素一支都不画, /// <para>面板拿它和表里现有的维数对印(§25.1):维数不够时元素一支都不画,
/// 报出来必须是"需要几个、现有几个"两个数,不能只说"没显示"。</para> /// 报出来必须是"需要几个、现有几个"两个数,不能只说"没显示"。</para>
@@ -127,7 +126,7 @@ namespace XericUI.XChart.Mesh
: XChartArrowConfig.CoordinateDimensionCount; : XChartArrowConfig.CoordinateDimensionCount;
/// <summary> /// <summary>
/// 给定记录数与上限,这一档来源能画几支。四种算法各不同,所以都得在这里, /// 给定记录数与上限,这一档来源能画几支。三种算法各不同,所以都得在这里,
/// 由调用方现问而不是在工具里各写一遍("N−1/N/N÷2"三个数写错一个,画面上只是少几支,最难查)。 /// 由调用方现问而不是在工具里各写一遍("N−1/N/N÷2"三个数写错一个,画面上只是少几支,最难查)。
/// </summary> /// </summary>
public static int ArrowCount(XChartArrowDirectionSource source, int recordCount, int maxArrows) public static int ArrowCount(XChartArrowDirectionSource source, int recordCount, int maxArrows)
@@ -139,7 +138,7 @@ namespace XericUI.XChart.Mesh
{ {
case XChartArrowDirectionSource.ThisRecordCarriesVector: pairs = recordCount; break; case XChartArrowDirectionSource.ThisRecordCarriesVector: pairs = recordCount; break;
case XChartArrowDirectionSource.AlternatingRecords: pairs = recordCount / 2; break; case XChartArrowDirectionSource.AlternatingRecords: pairs = recordCount / 2; break;
default: pairs = recordCount < 2 ? 0 : recordCount - 1; break; // 相邻两条那两档 default: pairs = recordCount < 2 ? 0 : recordCount - 1; break; // 相邻两条·点到点那一档
} }
if (maxArrows > 0 && maxArrows < pairs) return maxArrows; if (maxArrows > 0 && maxArrows < pairs) return maxArrows;
return pairs; return pairs;
+4 -4
View File
@@ -147,11 +147,11 @@ namespace XericUI.XChart.Mesh
[SerializeField, Tooltip("坐标从第几个数值维开始(一条记录 3 维:x/y/z);一支箭头由**相邻两条记录**构成")] [SerializeField, Tooltip("坐标从第几个数值维开始(一条记录 3 维:x/y/z);一支箭头由**相邻两条记录**构成")]
private int m_CoordinateDimension; private int m_CoordinateDimension;
[SerializeField, Tooltip("方向从哪来(旧「相对/绝对」就是这里的前两项,存的值不用重设):" + [SerializeField, Tooltip("方向从哪来:相邻两条·下一条是第二个点(首尾相接,旧 Relative,存的值 1 照旧) / " +
"相邻两条·下一条的坐标当方向 / 相邻两条·下一条是第二个点(首尾相接) / " + "本条记录自带方向(0~2 是点、3~5 是方向) / 分段(偶数记录是点、奇数是方向)。" +
"本条记录自带方向(0~2 是点、3~5 是方向) / 分段(偶数记录是点、奇数是方向)")] "旧的「绝对」那一档(存的值 0)已删——资产里还存着 0 的要跑迁移脚本改成 1")]
[FormerlySerializedAs("m_VectorMode")] [FormerlySerializedAs("m_VectorMode")]
private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsVector; private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsPoint;
[SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" + [SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" +
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")] "打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]