XChart P18(下半):连续绘制走曲线渲染器 + 箭头位置可调(规范 §26)

- `ChartToolVectorArrows` 的连续绘制不再提交折线,改为**Catmull-Rom → 三次贝塞尔链**喂库里的
  `UICurveRenderer`(圆柱弧段同一件,§10.4:折线只留给直线,逐段提交会在转角留断口)。
  曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置。
  `CurveCacheEntry` 自带起止色 ⇒ 沿程渐变是它本来的能力,不必靠切段凑。
- **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给"段号 + 段内参数",该段用 `Split` 剪断、
  只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪)。
  必须剪:不剪的话路径从箭头底下穿出去,看着像"箭头朝里长"。
- 互斥显示再用一次:`HeadPosition` / `PathSegments` 只在连续绘制下出现,`相对/绝对` 只在非连续下出现。
- **退路要看得见**:曲线渲染器不在位时退回直线段(形状仍读得出来),报表带
  `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=` —— 退没退一个字段说清。
- 文档:规范新增 §26(含他侧验收四条:平滑曲线、拖位置、互斥隐藏、杆两端不同色)。

判据(交付树那一跑,`.ximage-gate/chain_p18.txt` 每套一行 rc):编译门三臂 + 3 对照绿;
探针 **450** 项 0 失败;`p4_control` **61/61** 支臂各红在自己点名的断言上;
`p2_control` 4 臂 / `pool_family` / `generator_gate` 2 变异 / `hierarchy_gate` 5 变异全绿。

**没做**:曲线渲染器自带的那个"矢量标签"还没接(现在箭头方向来自切线);
`XChartArrowPathMath.cs.meta` 要等 Unity 导入才生成,届时单独补一笔。
This commit is contained in:
2026-10-26 07:56:00 +08:00
parent c40aa1f0c1
commit b26d533ffe
4 changed files with 197 additions and 12 deletions
+1
View File
@@ -94,6 +94,7 @@ P14 界面收敛(规范 §23,2026-10-25 他对着截图点了三条):①
P15 界面:元素块收成一行状态 + 默认元素让删(规范 §24,2026-10-25 他给的格式 `▼ √ Cylinder (R1, D4) [↑][↓][-]`):① 新增 `MakeHeaderRow` 把折叠板的标题搬进一个横排行,右边依次是 **√**(写 `m_Enabled`)、**R**、**D** 两个**可编辑**格子、`↑ ↓ -` 三个单字符动作键(中文说明进 tooltip),Body 里那行「启用/注册序/绘制序/上移/下移/删除」整行删掉 ⇒ 同一个写入口只有一处。他报的"注册序/绘制序的字段我在界面上没看到"根因**不是没做,是控件在折叠着的 Body 里**(面板默认全折叠,§13)——这一类要按位置查、不按存在查;R/D **不做成静态读数**:面板树在值变化时故意不重建(重建会换掉用户正在拖的输入框),静态读数会停在旧数字上="改了没反应"的又一种形状,绑定的格子没有这个问题。顺带拆掉一个**藏着的第二入口**:基类那三个字段没有 `[Header]`,会被 `AppendHeaderGroups` 整组塞进元素 Body 的「其它」里 ⇒ 标题行有了 √ R D 之后同一个写入口出现两次,现在分组时跳过这三个名字(与 `m_SlotId` 同一条规矩)。② 回答"默认工具应该被删除吗":**让删,也让关**,`[-]` 与 `√` 对每个元素都可用、不做特例,理由写进 `-` 的 tooltip 与 §24.2 那张表(删线框 ⇒ 网格仍发面四角给轴线;删网格 ⇒ 线框仍发四角、`AlignToGrid` 回落并在报表 `align=` 说原因;删空间 ⇒ 见③)。③ 顺带补一条会咬人的不变量:`EnsureSpace()` 原来只在初始化那一次跑,把「空间(基变换)」删掉或停用之后没人再补 ⇒ 投影权威为 null ⇒ 线框/网格/散点全部不画,现象是**"点了一下删,整张图空了"**;现在**每次 `RebuildElements` 之后**都保证图里有一个空间工具(删掉它=回到默认姿态继续画,重新 Add 一条就把旋钮拿回来)。判据:编译门三臂绿(`XChartBaseEditor.cs`/`XChartDataWindow.cs` 在点名源里)、`p4_control` **52/52** 支臂各红在点名的断言上、探针 **424** 项 0 失败、`p2` 4 臂 + `pool_family` + `generator_gate` 2 变异 + `hierarchy_gate` 5 变异**在交付树上复跑**全绿(`.ximage-gate/chain_p15.txt` 每套一行 rc);hierarchy 之所以必须复跑:它算父级是沿**盒子根**往上走的,把 Foldout 搬进横排行不动它的身份——真动错了就会以 `HIERARCHY-NO-PARENT` 红出来。**每份绿各覆盖哪棵树也记清**:那六套复跑覆盖的是"标题行 + `EnsureSpace`"那一版;之后为拆「其它」里的第二入口又改了一次编辑器文件,改完只复跑编译门与探针(`XChartBaseEditor` 只在 `run_gate.py` 的点名源里出现,其余套件一个都不读它,逐脚本 grep 过)。④ **这份绿覆盖不到什么**也点名:一行排不排得下、窄格子能不能改数、"删掉 `Space` 那一行图还在不在",离线一律判不了(引擎 mono 造不出真 `VisualElement`,§13.2)⇒ 归他现场判。
P17 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规范 §25,2026-10-25 他现场):① **"加了箭头元素一条都不画"的根因**是维数不够时它静默返回——一条记录要 6 个数值维(起点 3 + 方向 3),而伪 3D 散点预设默认只建了 `x/y/z` 三列,于是算完 0 支、提交 0 个面,画面上与"工具没注册 / 空间是 null / 渲染器没建"长得完全一样 ⇒ 处置不是改那行判断,而是**让这件事说得出来**:元素配置新增 `RequiredNumericDimensions`(默认 0=无所谓),面板在元素块里印"需要 N 个数值维,表现在有 M 个 ⇒ 一条都不画(报表里 dims=N/M)",报表里该元素自己印 `dims=有/需要 arrows=算了几支 mode=… colors=…`;② 一条记录的两组三维按**两种读法**解释(他口述):`Absolute`=后三维是方向矢量本身(起点+方向×倍率 ⇒ 螺旋点画成一片"刺猬")、`Relative`=后三维是第二个点(起点+差向量×倍率 ⇒ 一串首尾相接、顺着螺旋转),算式收进纯算术 `XChartVectorFieldMath.Tip`;③ `连续绘制`:把每条记录的**第一组三维**按顺序连成折线(只有最后一段带箭头),这时"相对/绝对"没有意义 ⇒ **面板上隐藏**——互斥显示的判据写在配置自己身上(`XChartElementConfig.IsFieldHidden(fieldName)`,面板只照着藏/放;**藏而不是不建**:面板树在值变化时不重建,勾回来必须立刻可见);④ **颜色维**:矢量后面再接 3~4 个数值维 `[色相, 饱和度, 明度, (不透明度)]`——色相走 **0..256 的色环**(256 与 0 同色、128 半圈),其余三个按 0..1 夹住;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha),算进门槛的话勾一下"有不透明度"就会让整个元素因维数不够突然消失;不是有限数**门口就拒**(退回单色,不画成黑——NaN 经取模 + HSV 会变成一块"看着像黑"的东西,那是我们替数据编的颜色);HSV 换算**自己写**(`Color.HSVToRGB` 是引擎侧静态调用,离线探针里跑不起来,而这条换算正是要离线钉住的);⑤ 数据侧新增 `测试 → 螺旋矢量场 32(9 维:起点+第二点+色相/饱和/明度)`:前三维是螺旋上的点、中三维是**下一个点**、后三维是颜色(色相 0→256 走满一圈)——两种读法在这份数据上正好是"刺猬"与"首尾相接"两幅图,且它**自己会把列补到 9 个**(测试数据的判据是"点一下就能看到东西",不是"提示他先去加六列")。判据:探针 **436** 项 0 失败(新增 12 条 `vector field` / `vector field colour`)、`p4_control` 新增 3 支臂(相对被读成绝对 / 色环按 0..1 读 / 颜色门口放 NaN 进来)各红在点名断言上、编译门三臂绿,`p2` / `family` / `generator_gate` / `hierarchy_gate` 在交付树上复跑,**55 支臂全红在各自主张上**、探针 436 项 0 失败(终态见 §25.6)。**本轮没做的**如实点名:仍然**不用曲线渲染器**(是直线段——"默认使用直线"是他给的,库里那个带矢量标签的曲线渲染器 + "调整箭头位置"排下一轮)、**两端各自的颜色**(现在是每支一个色,读一条记录的颜色维;他提的"两个分量各自设色"要逐顶点双色)、圆柱的颜色开关没动。
P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确口径重写):① **序号不是给人设的**——*注册序*由**类型**定好(定义几何的那一类天然靠前、数据呈现那一类靠后),面板**只显示、不给输入控件**;*绘制序*与**元素在表里的位置**绑定(上移/下移就是改绘制顺序),也不再有第二个手填的序号——序号能手填就会出现两条口径(位置 vs 数字)指向不同事实,"上移之后绘制顺序变没变"就没人回答得了。第一版我把 `R… D…` 做成了两个窄输入框,他现场否掉("我根本不想给它设置这个序号"),而且那对输入框还会露出拖拽光标、窄到数字看不见 ⇒ 改成**文本读数**并就地刷新(面板树在值变化时不重建)。② **矢量场的数据口径写错了**:正确是**前三维=坐标 x/y/z**(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4~7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。
P18 矢量场收尾:两端各自的颜色 + 连续绘制走曲线渲染器 + 箭头位置可调(规范 §26,2026-10-26):① 填充四边形多一档**线性渐变**(`AddFaceLinear`:`00/10` 一对边一色、`01/11` 一对边一色),箭头**杆走渐变(起点色→终点色)、头走终点色**——两端颜色来自相邻两条记录各自的颜色维,所以"这条与下条颜色不同"直接看得出来;每面花几个顶点收成**单一定义** `XChartMeshBudget.VerticesPerFace(kind)`(预算侧与写顶点侧同源,否则"预算以为 4 个、实际发 5 个"会在卡线时撞 65535,§10.3 那一族);**杆的四角绕序有判据**(a/d 在起点一侧、b/c 在末端一侧;配错画面上是"杆两侧各一色"而不是"沿杆渐变",最容易看漏)。② 连续绘制改走**曲线渲染器**(库里 `UICurveRenderer`,圆柱弧段同一件):途经点 → **Catmull-Rom 转三次贝塞尔**(张力 1/6,新纯算术 `XChartArrowPathMath`),曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置;`entry` 自带起止色 ⇒ 沿程渐变是它本来的能力;不再逐段提交折线(§10.4 的转角断口)。③ **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给段号+段内参数 ⇒ 该段 `Split` 剪断、只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪);**必须剪**,否则路径从箭头底下穿出去、看着像"箭头朝里长"。④ 互斥显示又用一次:`HeadPosition`/`PathSegments` 只在连续绘制下出现,`相对/绝对` 反过来只在非连续下出现。⑤ 读数与退路:报表带 `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=`——曲线渲染器不在位时退回直线段(形状仍读得出来),但**退没退在 `path=` 上一个字说清**,不是悄悄换个画法还报一样的数。判据:编译门三臂 + 3 对照绿;探针 **450** 项 0 失败(新增 `arrow path:` 9 条——全是**性质**判据:过数据点、端点切线=弦的一半、剪开再接回逐点一致、共线仍是直的、位置 0/0.5/1 落在哪一段,不写手算的中间点坐标)+ `arrow shaft:` 配对 1 条 + 顶点数 1 条;`p4_control` **61** 支臂各红在点名断言上(新增 4 支:起点侧角取成末端、所有面按平坦算顶点、控制柄拉成 /3 张力、剪开不共用剪口点);`p2` / `family` / `generator_gate` / `hierarchy_gate` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。
## [0.1.6] - 2026-07-01