diff --git a/CHANGELOG.md b/CHANGELOG.md index 6985565..eb01774 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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..grid.S|T`(Line3D **比例数组**,12 个),而轴线只认 Quad3D(`ResolveFaceFrame`),所以那 12 条在"已发布插槽"下拉里**永远是死项**(它们是「对齐格线」那一栏的输入,不是宿主);"4 条垂直棱注册不上"则不是漏发布,而是**"边"根本不是一个可寻址的东西**——以前只能"选一个面 + `CrossRatio=±1`"去贴一条棱,而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到你要的位置。他给的结论正是缺的那层命名:"不可能只有 12 个,而是 4×6=24 个,命名该是 face/side,然后根据面选择对应的边"。落法:① id `mesh.face..side.` 共 24(前缀沿用 `mesh.face.`——`TryGetSlotAt` 与轴从 id 回落读面号都按它解析,换写法就等于同时存在两套前缀);② **值就是同一个面的四角按 `<00,01,11,10>` 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)⇒ 仍是 `Quad3D`,轴线的 `AlongS`/`CrossRatio`/刻度朝外/标签随轴旋转**一行都不用改**,绕序不变所以不会镜像(镜像了"往面内刻度"就翻到外面);边号 0 底·1 左·2 顶·3 右(`SideName` 一个来源,面板与报表共用);③ **发布者只有线框元素**(它就是画棱的那个,`mesh.face.` 也它发),一处算式出 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 diff --git a/Documentation/XChart-ExternalAPI.md b/Documentation/XChart-ExternalAPI.md index 81b4b1f..7f69f50 100644 --- a/Documentation/XChart-ExternalAPI.md +++ b/Documentation/XChart-ExternalAPI.md @@ -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..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. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index f9f6ccb..e4190bd 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -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..grid.S|T`(**Line3D 比例数组**,12 个)。 + 而轴线只认 `Quad3D`(`ChartToolAxis.ResolveFaceFrame`),所以那 12 条在这个下拉里**永远是死项**—— + 它们是「对齐格线」那一栏的输入,不是宿主。 +- **"4 条垂直边注册不上"**:不是漏发布,是**"边"根本不是一个可寻址的东西**。以前要贴一条棱只能"选一个面 + `CrossRatio=±1`", + 而一根立方体棱被两个面共享,两面的面内方向又不同 ⇒ 同一根棱有两种参数化,其中一种落不到你要的位置。 + +### 31.2 落法:一条边=一个"旋到底边的面帧",仍是 Quad3D + +- id:**`mesh.face..side.`**,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.` 也是它发的)——一处算式出 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)。 diff --git a/Editor/XChart/XChartBaseEditor.cs b/Editor/XChart/XChartBaseEditor.cs index 49e20ca..072c81a 100644 --- a/Editor/XChart/XChartBaseEditor.cs +++ b/Editor/XChart/XChartBaseEditor.cs @@ -802,6 +802,7 @@ namespace XericUI.XChart.Editor if (slotProp == null) return; var available = new List(); + 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()))); } + /// + /// 把插槽 id 翻成人话(mesh.face.2.side.1 → "面 Top · 左边")。**认得的形状才翻译**, + /// 认不得的原样印出来并说为什么不能当宿主——这一行是给人核对的,编一个听起来对的名字比不翻更坏。 + /// + 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 + "(这是比例数组,不能当宿主——换下拉里的一条边)"; + } + /// /// 把某条轴铺满整面(起点 0、终点 1)。网格线铺的是整面 0..1, /// 轴内缩着就不可能和格线对齐——这是"两头都对不上"最常见的原因, diff --git a/Runtime/XChart/Axis/ChartToolAxis.cs b/Runtime/XChart/Axis/ChartToolAxis.cs index 9b61086..4ca6a36 100644 --- a/Runtime/XChart/Axis/ChartToolAxis.cs +++ b/Runtime/XChart/Axis/ChartToolAxis.cs @@ -271,6 +271,13 @@ namespace XericUI.XChart.Axis RequestTextSlots(LabelSource == XChartAxisLabelSource.DimensionLabel ? 1 : m_Majors.Count); } + /// + /// 什么样的插槽能当轴的宿主:要给出一个面的四条边(Quad3D)才谈得上"沿哪条、往哪边刻度"。 + /// 这条只有一个定义——面板列清单(滤掉格线那类比例数组)与这里的解析共用它, + /// 否则会出现"下拉里选了、线上画不出"那种两边都对的样子(§31)。 + /// + public static bool CanHostAxis(XChartSlotMode mode) => mode == XChartSlotMode.Quad3D; + /// /// 面帧从**定义网格发布的插槽**里取(规范 §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)) diff --git a/Runtime/XChart/Mesh/XChartCubeGeometry.cs b/Runtime/XChart/Mesh/XChartCubeGeometry.cs index e97e766..afe38a0 100644 --- a/Runtime/XChart/Mesh/XChartCubeGeometry.cs +++ b/Runtime/XChart/Mesh/XChartCubeGeometry.cs @@ -216,6 +216,53 @@ namespace XericUI.XChart.Mesh public static string GridSlotId(CubeFace face, bool alongS) => FaceSlotPrefix + (int)face + (alongS ? ".grid.S" : ".grid.T"); + /// + /// 一条棱插槽 id:mesh.face.<面号>.side.<边号>,一个面 4 条 ⇒ 全立方体 6×4=24 个。 + /// + /// 为什么是 24 而不是 12(他 2026-10-26 数的):一根立方体棱被两个面共享,而"轴贴着这条棱画" + /// 需要的是面内的两件事——沿棱的方向、以及从棱往面内走的横方向。同一根棱从不同面看, + /// 后者完全不同,所以 12 条棱表达不出"哪一面的那条棱"。命名按 面 + 边 来,边号见 + /// (0=底、1=左、2=顶、3=右,绕序逆时针)。 + /// + /// 插槽的值还是同一个面的四个角、只是把选中的那条边旋到面帧的底边(S 轴、t=0)—— + /// 于是它仍是一个 Quad3D,消费者(轴线)的 AlongS/CrossRatio 一行都不用改。 + /// + public const int SideCount = 4; + + public static string SideSlotId(CubeFace face, int side) + => FaceSlotPrefix + (int)face + ".side." + side; + + /// 边的名字(面板与报表用;绕序逆时针,0 是面帧 S 轴那条底边) + public static string SideName(int side) + { + switch (side) + { + case 0: return "底边"; + case 1: return "左边"; + case 2: return "顶边"; + case 3: return "右边"; + default: return "边" + side; + } + } + + /// + /// 第 条边旋到面帧底边后的四角(仍是 ST00/ST01/ST11/ST10 顺序, + /// 因此新面帧的 S 轴就是那条棱、T 轴就是"从棱往面内走";绕序不变 ⇒ 不会镜像)。 + /// 做法是纯旋转: 的四角按 00→01→11→10 成环,环上转 side 格。 + /// + 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]; + } + /// /// 一组格线要占多少个 float( 组 × 每组两个端点 × 3 个分量): /// 两个背景都按它开缓冲,"值布局"只有这一个来源。 diff --git a/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs b/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs index ed35f05..ee26074 100644 --- a/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs +++ b/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs @@ -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")