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
+54
View File
@@ -1719,6 +1719,60 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
于是 `did not go red` 当场把这条假点名抓了出来。⇒ 规矩不变:**点名清单按实测改**;
给每条判据配**它自己那支**变异体(这次补了"空表不挡而直接进算术"那一支专门管零/一条记录)。
## 26. P18:矢量场的两端颜色,与"路径上的箭头"(2026-10-26)
### 26.1 两端各自的颜色=填充四边形多一档线性渐变
`XChartMeshFillRenderer` 原来只有两档:四角同色(平坦)与"四角 + 中心"(径向)。这轮加第三档
**线性渐变**(`AddFaceLinear`):`00/10` 一对边一色、`01/11` 一对边一色,渐变方向垂直于这两条边。
- **每面花几个顶点收成单一定义** `XChartMeshBudget.VerticesPerFace(kind)`:预算侧与写顶点侧必须同源,
否则会出现"预算以为 4 个、实际发 5 个",恰好在卡线时撞 65535(§10.3 那一族)。
- 箭头:**杆走线性渐变(起点色 → 终点色),头走单色(终点色)**。两端颜色来自相邻两条记录各自的颜色维,
所以"这条记录的颜色和下一条不同"就直接看得出来了。
- **杆的四角绕序有判据**:`BuildShaft` 把 a/d 放在起点一侧、b/c 放在末端一侧——配错的话画面上是
"杆的两侧各一色"而不是"沿杆渐变",这种错最容易看漏,所以离线钉住(探针 `arrow shaft:` 一条 + 一支臂)。
### 26.2 连续绘制改走曲线渲染器(贝塞尔细分)
路径是"会弯的线",所以交给库里的 `UICurveRenderer`(圆柱弧段同一件,§10.4:折线渲染器只留给直线,
逐段提交会在转角留断口)。API 形状是从我们自己的调用点学的:
`AddCurve(CurveCacheEntry{startColor,endColor,tessellationSegments}, 4 个控制点, 4 个宽度)`,
`autoRebuild = false`(控制点每帧由工具喂),报表读 `LiveVertexCount`。
**entry 自带起止色 ⇒ 沿程渐变是曲线渲染器本来就有的能力**,路径的颜色不必靠切段去凑。
途经点 → 控制点用 **Catmull-Rom 转三次贝塞尔**(张力 1/6,`XChartArrowPathMath`):
这样曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置。
### 26.3 箭头位置可调:路径在剪口处剪断
`HeadPosition`(0..1,默认 1=末端)="画到路径的哪个位置",箭头放在那一处:
1. `ResolvePosition(段数, along)` → 段号 + 段内参数;
2. 该段用 `Split` 在参数处剪成两半,**只画左半**(前面的段整段画);
3. 箭头放在剪口上,方向取该点的**切线**(`Tangent`),不是两端连线——弯处会歪。
**为什么要剪断**:不剪的话路径从箭头底下穿出去,看着像"箭头朝里长"。
剪开再接回去必须与原段逐点一致(探针 8 个采样点,最大偏差 <1e-4),否则"箭头前面那段路挪了位"。
### 26.4 互斥显示又用了一次
`HeadPosition` 与 `PathSegments` **只在连续绘制下出现**(一支一支画时头永远在末端,这两个值没有意义);
`VectorMode` 反过来只在非连续下出现。判据全在配置自己的 `IsFieldHidden` 里,面板不写特例。
### 26.5 读数与退路
报表那一行现在带 `path=curve|fill|-`、`at=<位置>`、`curves=<提交了几段>`、`curveVerts=<顶点数>`:
**曲线渲染器不在位时退回直线段**(形状仍读得出来),但退没退在 `path=` 上一个字就说清了——
不是"悄悄换个画法还报一样的数"。
### 26.6 他侧验收(Ctrl+R 后)
1. 打开颜色维 + `连续绘制`:路径是平滑曲线(不是折角链),颜色沿程渐变,末端一个箭头。
2. 拖 `HeadPosition` 到 0.3:路径只画到 30% 处,箭头在那里、顺着曲线的方向;拖回 1=整条。
3. 关掉连续绘制:`HeadPosition` / `PathSegments` 两项**消失**,`相对/绝对`回来。
4. 一支一支的箭头:杆的两端颜色不同(起点色 → 终点色),头是终点色。
### 25.8 他侧验收(Ctrl+R 后)
1. `工具 → Add → 向量箭头`,数据窗口 `测试 → 螺旋矢量场`:立刻看到箭头。