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
View File
@@ -100,6 +100,7 @@ P21 矢量场没渲染的根因与修法(规范 §28,2026-10-26 他报"矢
P22 箭头改走"线 + 库的原生标记"(规范 §29,2026-10-26 他纠正:"箭头为何用的是填充?我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置"):**根因是一次"猜对了来源"没被复盘**——P18 我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API,`AddCurve`/`CurveCacheEntry` 猜对了,于是没再回头把那个包读一遍,它旁边的 `ArrowHeadData` 我一直不知道存在,就自己用填充四边形拼了杆和头;包其实就在工作区隔壁(`com.lrss3.deconstruction`),API 一直写在 `Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs`。⇒ 规矩:**照着调用点猜出来能跑之后,要把那个来源补读一遍**,"我猜对了"证明不了"我看见全了"。落法:① 杆=一条**共线**三次贝塞尔(新纯算术 `XChartArrowPathMath.Straight`:内控制点落在 1/3、2/3),宽度=`ShaftWidth`、起止色就是沿杆渐变(P18 那个效果原来是条目的原生能力);② 头=曲线渲染器原生标记 `ArrowHeadData`(`width`=头长沿切线、`height`=头宽垂直切线、`depthCompensation=+1`=**头尖对准那个数据点**);③ 连续绘制的头挂在 `ResolvePosition` 算出的那一节上、`progress`=节内参数,**路径不再剪断**——"必须剪否则线穿箭头"是我上一版自己加的,库的标记本来就叠在线上,于是 `Split` 没有调用方、随四角绕序那套(`XChartArrowGeometry` 整个类)一起删;④ 零向量画 `Circle` 标记(开关关掉就整条不画,计入 `skipped=`);⑤ **曲线渲染器不在位 ⇒ `path=none` 一支都不画**,不再有"退回填充画法"那第二条路(两套画法=两套口径,这次的 bug 恰恰长在第二条路上)。`AddFaceLinear`/`XChartFaceFillKind.Linear` **留着**:那是填充渲染器自己的上色模式(预算 `VerticesPerFace(Linear)==4` 与判据都在),别的元素要渐变填充时不必再写第二套。**另一面要说清**:P13 遗留的"填充面改了没作用"与今天"杆与头都不画"是**同一坏点的两种症状**(都走 `XChartMeshFillRenderer`)——他工程里那份报表给出了硬证据:`arrows=31 arrowFaces=62 fillChunks=1 fillMaxVerts=248`(=62×4 顶点一个不多)且 `dom=x[-100..100] y[-49.936..49.936] z[-49.743..50]` ⇒ 坐标已折进盒子、面提交了、子块建了、网格真填了顶点,画面上却没有 ⇒ 坏点在**填充渲染器到 Canvas 的那一跳**,不是数据形状也不是顶点预算。箭头不再经过那一跳,所以箭头上屏了而**网格背景/圆柱填充若也看不见就是同一坏点未除**,那一跳本轮没修(绕过去不等于修好)。**顺手抓到一条会撒谎的读数**:同一行 `curves=0` 却 `curveVerts=66`,而圆柱那一行也印 66 ⇒ `UICurveRenderer.LiveVertexCount` 不是本实例自己的数,只能当"库里一共活着多少顶点"读,看自己那份要读 `curves=`/`markers=`(已立待办)。判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、`progress` 夹进 [0,1]、NaN 位置落到末端而不是"位置未知"、0 尺寸兜底、`Straight` 每个采样都落在那条直线上、切线方向与矢量平行)+ `p4_control` **65** 支(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / `progress` 不夹 / 头尖不对点,各红在点名断言上)+ `dirty_gate` 正本 `knobs=132 takesEffect=132 findings=0`、八支变异全红(claim F 判"坐标必须经 `TryCubePoint`",改写后仍判得住)+ 编译门三臂 + 3 对照绿(`chain_p22.txt`)。**门自己的一次改动**:`run_gate` 原先把 rsp 里列出的每个源文件都喂给 csc,删掉一个源文件后那份快照还列着它 ⇒ `CS2001 找不到源文件`,整道门红得像"产品编译不过";现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**(判决要说清它判的是哪棵树)——这不是吞错:CS2001 说的是"快照过期",Unity 重导入会自己重生成 rsp。
P24 箭头:方向来源四档 + 头的尺寸吃投影 + 锚点(规范 §30,2026-10-26 他三条要求):① **他指出的"矢量被归一化到屏幕空间再算了"是真的**,成因在库那一行 `CurveMeshGenerator.cs:150 pos += tangent * arrow.width * 0.5f * arrow.depthCompensation`——标记的**方向**跟曲线切线走(对)、**尺寸是固定像素**(不是投影结果):杆会随姿态缩短而头不缩,整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 `ProjectedScale(投影像素, 立方体长度, CubeToPixel)`=这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取**这一节自己**的比例,所以弯到背面去的那一节头跟着一起缩;**除不出来(NaN、零长、零比例)就答 0**——宁可头缩成没有,也不要一个凭空的固定像素尺寸。② **`XChartArrowDirectionSource` 四档**(他的"一个箭头对应两组数据 ⇒ 32 个点只该 16 支"):`NextRecordAsVector`(旧 Absolute,N−1)/`NextRecordAsPoint`(旧 Relative,N−1,**点到点不用再算一次投影**,所以 `Tip` 只在这一档作差)/`ThisRecordCarriesVector`(同一条的 3~5 维是方向,N 支、要 6 维)/`AlternatingRecords`(偶数条是点、奇数条是方向,N÷2 支);**支数与维数只有 `ArrowCount(source,…)`/`RequiredCoordinateDimensions(source)` 这一个实现**——四档算法在工具里各写一遍,画面上只是"少几支",最难查。③ **方向是原始矢量、绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"(`(0,1,0)` 会被折成一个偏移量,整场箭头一起跑偏),尺度交给 `DirectionScale`;顺带 `XMeshPreviewChart` 那份"一条记录 6 维、方向存 3~5"的旧示例数据在新档 `ThisRecordCarriesVector` 下**正好合法**(§28.5 说的"死数据"有了读法,默认值我没替他改)。④ **序列化兼容**:新枚举 0/1 就是旧 `XChartArrowVectorMode` 的 Absolute/Relative,字段再加 `[FormerlySerializedAs("m_VectorMode")]` ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。⑤ **`MarkerAnchor` [0,1]** → 库的 `depthCompensation`(`anchor×2−1`;0=尾部落点、0.5=中心、1=头尖落点=默认),非有限退回 1。⑥ **颜色维撞上方向维**:自带方向那档吃 0~5 六列而颜色起点默认仍是 3 ⇒ 会把方向当色相读;判据是撞了就退回单色并印 `colors=overlap`("颜色没生效"与"配置撞了"分得开)。判据:探针 **462** 项 0 失败(新增 10 条:四档各自支数(含 33÷2=16、1 条=0)、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0)+ `p4_control` **66** 支(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫在新算术下已经到不了,**没有靶子的臂不当证据用**)+ `dirty_gate` 正本 `knobs=133 takesEffect=133 findings=0`、**九支变异全红** + 编译门三臂 + 3 对照绿(`chain_p24.txt`)。**门自己也现了一次瞎**(本轮最重要的自证):`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,于是总数是 132 而不是 133,而"132/132 PASS"是绿的、却不再等于"每个旋钮都看得见"——补 `match_head`(认得大括号在下一行的声明)并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 `MarkDirty()`**,门必须红(看不见形状的门会放行一个不置脏的旋钮)。另记两次 harness 正常工作:CJK 又进了一次声明 `coding: ascii` 的脚本(第三次),以及一支臂的锚点被我新写的孪生函数撞成 2 命中 ⇒ `SETUP FAILED` 整轮作废(锚点加宽成两行块;规矩已进记忆)。
P26a 文本槽位复用时恢复默认(存量缺陷,2026-10-26 他提标签需求时点出"我们改的属性在池复用的阶段都要能恢复默认"):`XChartTextSlotFactory.Acquire()` 以前只给**新建**那件设默认,从 `m_Free` Pop 出来的只 `SetActive(true)`,而元素每帧往槽位写的远不止那些(轴线六样:`text/fontSize/color/sizeDelta/anchoredPosition/localEulerAngles`,`ChartToolAxis.cs:469-474`)⇒ 复用件带着上一轮的字色、矩形大小和旋转走,新元素只写自己关心的几样,剩下沿用——症状"标签换个顺序就变大/歪了",画面上看不出是谁写的("同一件事两处存"的另一种:上一轮的残留也是两处)。修法:抽 `public static ResetToDefaults(TMP_Text)`,**默认值只此一处定义**,新建与复用**两条路径都调**。清单不靠记忆:新门 `slot_reset_gate.py` 两条主张——A 所有元素写过的属性 ⊆ 恢复清单(`files scanned=53 slot writes=14 distinct=7 reset lines=16`)、B 恢复函数真的在**两条获取路径**上被调用(只在新建分支调=一条绿谎,直接 FAIL);三支变异各红在点名处(S1 从清单删 `fontSize`、S2 让轴线多写一个 `overflowMode` 当场点名、S3 删掉复用路径那句调用 → 两个分支同报 False),正本 PASS + 三支全红 + 编译门三臂绿(`chain_p26a.txt`)。一条 TMP 版本事实由门先替我撞:这版 `TextMeshProUGUI.outlineWidth` 是 **float** 且没有 `enableOutline` ⇒ 宽度归零即不描边(我按新版文档写的 `Vector2.zero`/`enableOutline` 吃了 CS0029+CS1061,没进他的编辑器)。覆盖不到:这一笔不解决"上不上屏"(P23/P25),只保证"没写的属性不会带着上一轮的值"。
P28 面边插槽 6×4=24(规范 §31,2026-10-26 他数的两件事):他先说"网格发布的轴线虽然有 12 个,实际可用的只有上下两个面周围的边线,另外 4 个垂直边线插槽无法注册",又说"只有前面的 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(`ResolveFaceFrame`),所以那 12 条在"已发布插槽"下拉里**永远是死项**(它们是「对齐格线」那一栏的输入,不是宿主);"4 条垂直棱注册不上"则不是漏发布,而是**"边"根本不是一个可寻址的东西**——以前只能"选一个面 + `CrossRatio=±1`"去贴一条棱,而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到你要的位置。他给的结论正是缺的那层命名:"不可能只有 12 个,而是 4×6=24 个,命名该是 face/side,然后根据面选择对应的边"。落法:① id `mesh.face.<f>.side.<s>` 共 24(前缀沿用 `mesh.face.`——`TryGetSlotAt` 与轴从 id 回落读面号都按它解析,换写法就等于同时存在两套前缀);② **值就是同一个面的四角按 `<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=<原因>`;④ 面板下拉只列"能当宿主的",判据收成**一处** `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用,否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的"——不静默少一项;轴那行现成的 `slot=` / `frame=slot|cube` 已能回答"我贴上了哪条边",没加新读数。判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向不镜像/24 档把 12 条棱**各覆盖两次**——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标",否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支(新增 3 支:所有 side 旋到同一格/环序取镜像/两条边名撞同一个词);编译门三臂 + 3 对照绿(`chain_p28.txt`)。⑤ 选中项还在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)"):**下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;面板在值变化时故意不重建树(那会换掉正在拖的控件),所以这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。顺带一条自证:我先在文档里写了"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示的是裸 id),这句话在下一笔里被改成真的,而不是把文档改回来说假话。本轮自己两次被工具拦下并如实记下:`git add -A` 被分类器拒绝(这条一直禁用;提交用 pathspec 就够,不需要暂存),以及中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 臂文件里的中文源行改用 `\uXXXX`)。覆盖不到:30 个插槽真进了下拉、垂直棱真贴住了,只有他现场判(报表 `sides=24`、`slot=`、`frame=slot`)。
## [0.1.6] - 2026-07-01
+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)。
+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,
/// 轴内缩着就不可能和格线对齐——这是"两头都对不上"最常见的原因,
+8 -1
View File
@@ -271,6 +271,13 @@ namespace XericUI.XChart.Axis
RequestTextSlots(LabelSource == XChartAxisLabelSource.DimensionLabel ? 1 : m_Majors.Count);
}
/// <summary>
/// 什么样的插槽能当轴的<b>宿主</b>:要给出一个面的四条边(<c>Quad3D</c>)才谈得上"沿哪条、往哪边刻度"。
/// 这条只有一个定义——面板列清单(滤掉格线那类比例数组)与这里的解析共用它,
/// 否则会出现"下拉里选了、线上画不出"那种两边都对的样子(§31)。
/// </summary>
public static bool CanHostAxis(XChartSlotMode mode) => mode == XChartSlotMode.Quad3D;
/// <summary>
/// 面帧从**定义网格发布的插槽**里取(规范 §11.2):网格是定义者,其余工具跟随——
/// 消费者拿到的是四个点,不是"第几个面",所以换成异形网格也不用改这里。
@@ -283,7 +290,7 @@ namespace XericUI.XChart.Axis
IXChartSlotBoard board = Context?.Slots;
XChartSlotView slot;
if (board != null && board.TryRead(SlotId, out slot)
&& slot.Mode == XChartSlotMode.Quad3D)
&& CanHostAxis(slot.Mode))
{
Vector3 c00, c01, c11, c10;
if (slot.TryGetQuad(0, out c00, out c01, out c11, out c10))
+47
View File
@@ -216,6 +216,53 @@ namespace XericUI.XChart.Mesh
public static string GridSlotId(CubeFace face, bool alongS)
=> FaceSlotPrefix + (int)face + (alongS ? ".grid.S" : ".grid.T");
/// <summary>
/// 一条棱插槽 id:<c>mesh.face.&lt;面号&gt;.side.&lt;边号&gt;</c>,一个面 4 条 ⇒ 全立方体 6×4=24 个。
///
/// <para><b>为什么是 24 而不是 12</b>(他 2026-10-26 数的):一根立方体棱被两个面共享,而"轴贴着这条棱画"
/// 需要的是<b>面内</b>的两件事——沿棱的方向、以及从棱往面内走的横方向。同一根棱从不同面看,
/// 后者完全不同,所以 12 条棱表达不出"哪一面的那条棱"。命名按 <c>面 + 边</c> 来,边号见
/// <see cref="GetSideQuad"/>(0=底、1=左、2=顶、3=右,绕序逆时针)。</para>
///
/// <para>插槽的<b>值</b>还是同一个面的四个角、只是把选中的那条边旋到面帧的底边(S 轴、t=0)——
/// 于是它仍是一个 <c>Quad3D</c>,消费者(轴线)的 AlongS/CrossRatio 一行都不用改。</para>
/// </summary>
public const int SideCount = 4;
public static string SideSlotId(CubeFace face, int side)
=> FaceSlotPrefix + (int)face + ".side." + side;
/// <summary>边的名字(面板与报表用;绕序逆时针,0 是面帧 S 轴那条底边)</summary>
public static string SideName(int side)
{
switch (side)
{
case 0: return "底边";
case 1: return "左边";
case 2: return "顶边";
case 3: return "右边";
default: return "边" + side;
}
}
/// <summary>
/// 第 <paramref name="side"/> 条边旋到面帧底边后的四角(仍是 <c>ST00/ST01/ST11/ST10</c> 顺序,
/// 因此新面帧的 <b>S 轴就是那条棱</b>、<b>T 轴就是"从棱往面内走"</b>;绕序不变 ⇒ 不会镜像)。
/// 做法是纯旋转:<see cref="GetFaceCorners"/> 的四角按 00→01→11→10 成环,环上转 side 格。
/// </summary>
public static void GetSideQuad(CubeFace face, int side, out Vector3 cornerST00, out Vector3 cornerST01,
out Vector3 cornerST11, out Vector3 cornerST10)
{
Vector3 c00, c01, c11, c10;
GetFaceCorners(face, out c00, out c01, out c11, out c10);
var ring = new[] { c00, c01, c11, c10 };
int step = ((side % SideCount) + SideCount) % SideCount;
cornerST00 = ring[step];
cornerST01 = ring[(step + 1) % SideCount];
cornerST11 = ring[(step + 2) % SideCount];
cornerST10 = ring[(step + 3) % SideCount];
}
/// <summary>
/// 一组格线要占多少个 float(<paramref name="lineCount"/> 组 × 每组两个端点 × 3 个分量):
/// 两个背景都按它开缓冲,"值布局"只有这一个来源。
@@ -74,6 +74,9 @@ namespace XericUI.XChart.Pseudo3D
// 本帧提交了多少:线框"整块不见了"要能分清是没空间、没提交还是提交了 0 条
private int m_EdgesDrawn;
private int m_FacesPublished;
// 面边插槽(6×4=24)发出去几个、卡在哪儿(§31):发不出去比发错更难查,所以留名字与原因
private int m_SidesPublished;
private string m_SidesRefused;
// ── 对外出口 ──────────────────────────────────────────────
@@ -114,6 +117,8 @@ namespace XericUI.XChart.Pseudo3D
{
IXChartSlotBoard board = Context?.Slots;
m_FacesPublished = 0;
m_SidesPublished = 0;
m_SidesRefused = null;
if (board == null) return;
for (int i = 0; i < XChartCubeGeometry.FaceCount; i++)
@@ -130,6 +135,22 @@ namespace XericUI.XChart.Pseudo3D
board.Publish(XChartCubeGeometry.FaceSlotId(face), XChartSlotMode.Quad3D,
XChartSlotAccess.ReadOnly, m_SlotValues, out string _);
m_FacesPublished++;
// 同一个面的 4 条边各发一份(旋到底边的那个四角,仍是 Quad3D)——
// 一根棱被两个面共享,"贴哪一面的哪条棱"必须能从 id 里说出来(§31)
for (int side = 0; side < XChartCubeGeometry.SideCount; side++)
{
XChartCubeGeometry.GetSideQuad(face, side, out c00, out c01, out c11, out c10);
m_SlotValues[0] = c00.x; m_SlotValues[1] = c00.y; m_SlotValues[2] = c00.z;
m_SlotValues[3] = c01.x; m_SlotValues[4] = c01.y; m_SlotValues[5] = c01.z;
m_SlotValues[6] = c11.x; m_SlotValues[7] = c11.y; m_SlotValues[8] = c11.z;
m_SlotValues[9] = c10.x; m_SlotValues[10] = c10.y; m_SlotValues[11] = c10.z;
string why;
if (board.Publish(XChartCubeGeometry.SideSlotId(face, side), XChartSlotMode.Quad3D,
XChartSlotAccess.ReadOnly, m_SlotValues, out why)) m_SidesPublished++;
else m_SidesRefused = why;
}
}
}
@@ -247,6 +268,8 @@ namespace XericUI.XChart.Pseudo3D
if (m_FaceFrames[i].IsValid) valid++;
sb.Append(" edges=").Append(m_EdgesDrawn)
.Append(" faces=").Append(m_FacesPublished)
.Append(" sides=").Append(m_SidesPublished)
.Append(m_SidesRefused == null ? "" : " sideRefuse=" + m_SidesRefused)
.Append(" frames=").Append(valid).Append('/').Append(m_FaceFrames.Length)
.Append(" backEdges=").Append(ShowBackEdges ? "on" : "off")
.Append(" space=").Append(Context != null && Context.Space != null ? "ok" : "NULL")