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
+50 -1
View File
@@ -802,6 +802,7 @@ namespace XericUI.XChart.Editor
if (slotProp == null) return;
var available = new List<string>();
int notHost = 0;
var board = chart != null && chart.ToolManager != null && chart.ToolManager.Context != null
? chart.ToolManager.Context.Slots
: null;
@@ -812,6 +813,9 @@ namespace XericUI.XChart.Editor
string id;
XChartSlotMode mode;
if (!board.TryGetSlotAt(i, out id, out mode)) continue;
// 只列"能当宿主的":比例数组那类(格线的 mesh.face.N.grid.S/T)在这个下拉里永远是死项
// ——轴线认的是四条边的面帧,判据只有一处:ChartToolAxis.CanHostAxis
if (!ChartToolAxis.CanHostAxis(mode)) { notHost++; continue; }
if (!available.Contains(id)) available.Add(id);
}
}
@@ -820,6 +824,12 @@ namespace XericUI.XChart.Editor
choices.AddRange(available);
int current = available.IndexOf(slotProp.stringValue);
// 边号 0~3 对人来说不是话,但下拉的选项文本就是写回的值(加后缀会写坏 id),
// 所以翻译只能放在下面这一行——SideName 与轴、与发布的是同一个来源。
// 面板在值变化时故意不重建树(那会换掉正在拖的控件),所以这一行**自己跟着回调改**,
// 否则它就是一条会停在旧值上的静态读数(§24.1 那一族)。
var slotHint = MakeReadonly(SlotIdHint(slotProp.stringValue));
var dropdown = new DropdownField("已发布插槽", choices, current < 0 ? 0 : current + 1);
dropdown.RegisterValueChangedCallback(evt =>
{
@@ -827,17 +837,56 @@ namespace XericUI.XChart.Editor
serializedObject.Update();
slotProp.stringValue = evt.newValue;
serializedObject.ApplyModifiedProperties();
slotHint.text = SlotIdHint(evt.newValue);
OnValueChanged();
});
host.Add(dropdown);
host.Add(MakeField(slotProp, "宿主面(可手填)"));
host.Add(MakeReadonly("已发布插槽 " + available.Count + " 个"));
host.Add(slotHint);
host.Add(MakeReadonly("可当宿主的插槽 " + available.Count + " 个"
+ (notHost > 0 ? "(另有 " + notHost + " 个比例数组插槽,那是「对齐格线」的输入,不当宿主)" : "")));
LogDetailOnce("slots", "XChart 面板:板上已发布的插槽 id —— " + (available.Count == 0
? "(一个都没有:定义网格的元素还没跑,或本图没有网格元素)"
: string.Join(", ", available.ToArray())));
}
/// <summary>
/// 把插槽 id 翻成人话(<c>mesh.face.2.side.1</c> → "面 Top · 左边")。**认得的形状才翻译**,
/// 认不得的原样印出来并说为什么不能当宿主——这一行是给人核对的,编一个听起来对的名字比不翻更坏。
/// </summary>
private static string SlotIdHint(string id)
{
if (string.IsNullOrEmpty(id)) return "当前宿主:(空)";
const string prefix = XericUI.XChart.Mesh.XChartCubeGeometry.FaceSlotPrefix;
if (!id.StartsWith(prefix, StringComparison.Ordinal))
return "当前宿主:" + id + "(不是 " + prefix + "* 的形状,原样交给插槽板)";
string rest = id.Substring(prefix.Length);
int dot = rest.IndexOf('.');
int face;
if (!int.TryParse(dot < 0 ? rest : rest.Substring(0, dot), out face))
return "当前宿主:" + id + "(面号读不出来)";
var faceType = typeof(XericUI.XChart.Mesh.XChartCubeGeometry.CubeFace);
string faceName = System.Enum.IsDefined(faceType, face)
? ((XericUI.XChart.Mesh.XChartCubeGeometry.CubeFace)face).ToString()
: "第" + face + "面";
if (dot < 0) return "当前宿主:面 " + faceName + "(四角,轴可以贴它的任一条边)";
string tail = rest.Substring(dot + 1);
if (tail.StartsWith("side.", StringComparison.Ordinal))
{
int side;
return int.TryParse(tail.Substring(5), out side)
? "当前宿主:面 " + faceName + " · "
+ XericUI.XChart.Mesh.XChartCubeGeometry.SideName(side) + "(side." + side + ")"
: "当前宿主:" + id + "(边号读不出来)";
}
return "当前宿主:" + id + "(这是比例数组,不能当宿主——换下拉里的一条边)";
}
/// <summary>
/// 把某条轴铺满整面(起点 0、终点 1)。网格线铺的是整面 0..1,
/// 轴内缩着就不可能和格线对齐——这是"两头都对不上"最常见的原因,