XChart P28:面边插槽 6×4=24——"贴哪一面的哪条棱"终于是一个可寻址的东西(规范 §31)

他数出来的两件事,都对应一个真实的形状问题(不是"漏发布"):

- "下拉里 12 个,只有 mesh.face.1-5 有用,后面的 mesh.face.0.grid.S/T 都没用" —— 板上当时只有
  `mesh.face.<0..5>`(Quad3D 面四角,6 个)与 `mesh.face.<n>.grid.S|T`(Line3D **比例数组**,12 个),
  而轴线只认 Quad3D ⇒ 那 12 项在这个下拉里**永远是死项**(它们是「对齐格线」的输入,不是宿主)。
- "4 条垂直边注册不上" —— 因为"边"根本不是可寻址的东西:以前只能"选一个面 + CrossRatio=±1"去贴棱,
  而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到位置上。
  他给的结论正是要补的那层命名:"不可能只有 12 个,而是 4x6=24 个,命名该是 face/side"。

落法:
- id 用 `mesh.face.<f>.side.<s>`(24 个)。前缀沿用 `mesh.face.`——`TryGetSlotAt` 与"轴从 id 回落读面号"都按它解析,
  写成 `mesh.face0.side0` 就会同时存在两套前缀。
- **值=同一个面的四角按 <00,01,11,10> 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)。
  于是它仍是 Quad3D:轴线的 AlongS/CrossRatio/刻度朝外/标签随轴旋转**一行都不用改**;绕序不变 ⇒ 不镜像
  (镜像了"往面内刻度"会翻到外面去,而这件事在画面上只是"刻度朝里",很难归因)。边号 0 底·1 左·2 顶·3 右。
- 发布者只有一个:线框元素(它就是画棱的那个,`mesh.face.<n>` 也归它)。一处算式出 24 份,报表
  `faces=6 sides=24`;发不出去印 `sideRefuse=<原因>`——发不出去比发错更难查,所以留名字。
- 面板下拉只列"能当宿主的",判据收成一处 `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用;
  否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的",不静默少一项。
- 选中项另外在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)")。
  **下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;又因为面板在值变化时故意不重建树
  (那会换掉正在拖的控件),这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。
- 轴那行现成的 `slot=` / `frame=slot|cube` 已经能回答"我贴上了哪条边"(`frame=cube` 就是没读到槽、退回了硬编码),
  所以没有再加新读数。

一条自证:我先在文档里写"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示裸 id)。
这句话在这一笔里被改成真的,而不是把文档改回去说假话——文档里的功能存在性也要有门。

判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向/
24 档把 12 条棱各覆盖两次——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标",
否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支 CONTROL PASSED(新增 3 支:所有 side 旋到同一格/
环序取成镜像/两条边名撞同一个词);`dirty_gate` 正本 knobs=133 takesEffect=133、九支全红;
`slot_reset_gate` 仍 PASS(上一笔立的"被写 ⊆ 被恢复"这条没被这次改动放宽);编译门 runtime+player+editor+3 对照绿
(chain_p28.txt,面板那行加完之后又跑了一次 chain_p28b.txt 同样绿)。

本轮两次被工具拦住、都是它正常工作:`git add -A` 被分类器拒绝(一直禁用;pathspec 提交本就不需要暂存);
中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 带中文的源行在臂文件里写 `\uXXXX`)。

覆盖不到的:30 个插槽是否真进了下拉、垂直棱是否真贴住了,只有他现场判(§31.4,看 `sides=24` / `slot=` / `frame=slot`)。
This commit is contained in:
2026-10-26 19:31:25 +08:00
parent dc4e5445ad
commit 192714baf1
7 changed files with 173 additions and 4 deletions
+1 -1
View File
@@ -98,7 +98,7 @@ public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }
| `ChartToolMeshBg`(`BG Cube Grid`) | `FillFaces/FillColor/FillCenterColor` · `GridFaces/GridColor/GridThickness/GridDivisions/GridDivisionsS/T` · `GridDimensionS/T`(格线绑到哪一维) · `ShowFaceOutline/OnlyVisibleFaces/OutlineColor` |
| `ChartToolCubeBg`(`BG Cube Wire`) | `FrontEdgeColor/BackEdgeColor/EdgeThickness/ShowBackEdges` |
| `ChartToolScatterPoints` | `AutoFromData/DimensionX/Y/Z` · 外观 10 个(`PointSize/PointType/PointSizeMode/PointColor/CenterColor/BorderColor/BorderThickness/SideCount/ChamferSize/PointAngle`,走 `SyncShapeParams`) · `EnableColorMapping/ColorMapMin/ColorMapMax/ColorMapDimension` |
| `ChartToolAxis` | `SlotId`(宿主面) · `AlignToGrid/Direction/StartRatio/EndRatio/CrossRatio` · 刻度(`Dimension/Scale/AutoStep/ManualStep/TargetMajorCount/MinorTickCount`) · 线与标签(`LineColor/LineThickness/Major…/Minor…/LabelSource/LabelFormat/CustomLabels/Label…`) |
| `ChartToolAxis` | `SlotId`(**宿主**:板上现在发 `mesh.face.<0..5>` 与 `mesh.face.<f>.side.<0..3>` 共 30 个可当选;边号 0 底·1 左·2 顶·3 右,见规范 §31。下拉里不会再出现 `…grid.S/T`,那是「对齐格线」的输入) · `AlignToGrid/Direction/StartRatio/EndRatio/CrossRatio` · 刻度(`Dimension/Scale/AutoStep/ManualStep/TargetMajorCount/MinorTickCount`) · 线与标签(`LineColor/LineThickness/Major…/Minor…/LabelSource/LabelFormat/CustomLabels/Label…`) |
## 5. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算
+43 -1
View File
@@ -2066,4 +2066,46 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
2. 换成 `ThisRecordCarriesVector`(他那份 demo 数据的形状)⇒ 32 支;若 `colors=overlap` 就把颜色起点调到 6。
3. 转立方体:一圈"圆周方向"的矢量投到 2D 上**长短不一**(`headScale` 读数跟着变;指向屏幕里的那支会缩到几乎看不见)。
4. 拖 `MarkerAnchor`:0 时尾巴钉在点上、1 时头尖钉在点上(默认)。
5. 头的绝对大小他满意与否归他判——机器只保证"它是投影算出来的,不是写死的"。
5. 头的绝对大小他满意与否归他判——机器只保证"它是投影算出来的,不是按一个写死的像素尺寸画出来的"。
## 31. P28:面边插槽 6×4=24("贴哪一面的哪条棱"终于说得出来,2026-10-26)
### 31.1 他数出来的两件事,和它们各自的真相
- **"下拉里有 12 个,只有 mesh.face.1-5 有用,后面的 grid.S/T 都没用"**:完全对得上字面——板上现在只有两类 id:
`mesh.face.<0..5>`(Quad3D,面四角,6 个)与 `mesh.face.<n>.grid.S|T`(**Line3D 比例数组**,12 个)。
而轴线只认 `Quad3D`(`ChartToolAxis.ResolveFaceFrame`),所以那 12 条在这个下拉里**永远是死项**——
它们是「对齐格线」那一栏的输入,不是宿主。
- **"4 条垂直边注册不上"**:不是漏发布,是**"边"根本不是一个可寻址的东西**。以前要贴一条棱只能"选一个面 + `CrossRatio=±1`",
而一根立方体棱被两个面共享,两面的面内方向又不同 ⇒ 同一根棱有两种参数化,其中一种落不到你要的位置。
### 31.2 落法:一条边=一个"旋到底边的面帧",仍是 Quad3D
- id:**`mesh.face.<f>.side.<s>`**,6×4=24 个。前缀沿用 `mesh.face.`(`TryGetSlotAt`、轴从 id 回落读面号都按它解析;
换成 `mesh.face0.side0` 那种写法就会同时存在两套前缀)。
- **值**=同一个面的四角、按 `<00,01,11,10>` 这个环旋转 `s` 格,让**选中的那条棱正好落在面帧的底边(S 轴、t=0)**。
于是它还是一个 `Quad3D`,轴线的 `AlongS`/`CrossRatio`/刻度朝外/标签随轴旋转**一行都不用改**;
绕序保持不变 ⇒ 不会镜像(镜像了"往面内刻度"就会翻到外面去)。
- 边号:`0 底 · 1 左 · 2 顶 · 3 右`(环上逆时针),名字由 `SideName` 给,面板与报表同一个来源。
- **发布者只有一个**:线框元素(它就是画棱的那个,`mesh.face.<n>` 也是它发的)——一处算式出 24 份,
报表印 `faces=6 sides=24`;发不出去时 `sideRefuse=<原因>`(发不出去比发错更难查,所以留名字)。
- 面板下拉**只列能当宿主的**,并明说"另有 N 个比例数组插槽是给对齐格线用的"。
判据只有一处:`ChartToolAxis.CanHostAxis(mode)`——消费者与面板共用它,否则会出现"下拉里能选、线上画不出"。
轴那行的 `slot=` / `frame=slot|cube` 早就有了,所以"我到底贴上了哪条边"当场可读,不必再加新读数。
### 31.3 判据
- 探针 **466** 项 0 失败,新增 4 条,**全部打在性质上**(不重跑实现自己的下标,否则改错旋转的人会顺手把判据也改错):
每个 side 的底边就是它自己那条棱 / 旋转后面法向同向(不镜像)/ 24 档把 12 条棱**各覆盖两次**(这正是"不该只有 12 个"的机器版说法)/
id 与边名不撞。
- `p4_control` **69** 支:新增 3 支(所有 side 都旋到同一格/环序取成镜像/两条边名撞成同一个词),各红在点名的那条上。
- 编译门三臂 + 3 支对照绿(`chain_p28.txt`)。
### 31.4 覆盖不到什么 / 他侧验收(Ctrl+R 后)
1. 轴线元素的"已发布插槽"下拉:应当看到 6 个 `mesh.face.N` + 24 个 `mesh.face.N.side.M`,**不再出现 `.grid.S/T`**,
并且旁边那行写着"另有 12 个比例数组插槽…不当宿主"。
2. 选 `mesh.face.<某个侧面>.side.1` 或 `.side.3`(左/右边=那两条垂直棱)⇒ 轴能贴住它,刻度往面内走。
这一条是他这次报"垂直边注册不上"的直接判据。
3. 报表里线框那行 `sides=24`;轴那行 `slot=` 与 `frame=slot` 同时到位(`frame=cube` 说明回落了,即没读上槽)。
4. 转立方体看刻度方向对不对——这条机器判不了(§13.2)。