XChart P22:箭头的杆与头改走曲线渲染器的原生标记(规范 §29,他纠正"箭头为何用的是填充")

他这句纠正指向一件我一直不知道存在的东西:

> 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。

P18 那次我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API——`AddCurve`/`CurveCacheEntry` 猜对了,
于是**没有回头把那个包读一遍**,它旁边的 `ArrowHeadData` 我一直不知道,就用填充四边形自己拼了杆和头。
包其实就在工作区隔壁(com.lrss3.deconstruction),API 一直写在
Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs。教训写进 §29.1:
**照着调用点猜出来能跑之后,要把那个来源补读一遍**——"我猜对了"证明不了"我看见全了"。

画法(一套几何,没有第二条路):
- 杆=一条**共线**三次贝塞尔(新纯算术 XChartArrowPathMath.Straight:内控制点落在 1/3、2/3),
  宽度=ShaftWidth,startColor/endColor 就是沿杆渐变——P18 我要的那个效果原来是条目的原生能力。
- 头=原生标记 ArrowHeadData:width=头长(沿切线)、height=头宽(垂直切线)、
  depthCompensation=+1 ⇒ **头尖对准那个数据点**。尺寸与位置先走我们自己的纯算术 XChartArrowMarker
  (离线探针引不到库那个 assembly,判据打在纯算术上,工具里只做对号入座)。
- 连续绘制的头挂在 ResolvePosition 算出的那一节上、progress=节内参数;**路径不再剪断**——
  "必须剪否则线穿箭头"是我上一版自己加的机制,Split 因此没有调用方,随四角绕序一起删。
- 零向量=一个 Circle 标记(开关关掉则整条不画,计入 skipped=)。
- **曲线渲染器不在位 ⇒ path=none、一支都不画**。不再有"退回填充画法"那第二条路:两套画法就是两套口径,
  而这次的 bug 恰恰长在第二条路上。

撤掉:XChartArrowGeometry(BuildShaft/BuildHead/TryBuild)整个类删、XChartArrowPathMath.Split 删。
留着:XChartMeshFillRenderer.AddFaceLinear 与 XChartFaceFillKind.Linear——那是填充渲染器自己的上色模式
(预算 VerticesPerFace(Linear)==4 与判据都在),只是箭头不再用它;别的元素要渐变填充时不必再写第二套。
配置里 HeadPosition 的 tooltip 一起改(原文写着"路径在这一处剪断",§29 之后不剪,留着就是面板说谎)。

**为什么这一改仍然不算把 bug 修好**(§29.3 写清):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 的那一跳。箭头不再经过那一跳,所以箭头上屏了,
而那一跳本身没修(P23 专门查;绕过去不等于修好)。同一行还抓到一条会撒谎的读数:
curves=0 却 curveVerts=66,而圆柱那一行也印 66 ⇒ UICurveRenderer.LiveVertexCount 不是本实例的数,
不能当"我这条曲线画了多少顶点"读(一并立进 P23)。

判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;
新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、progress 夹进 [0,1]、NaN 位置落到末端、0 尺寸兜底、
Straight 每个采样都落在那条直线上、切线方向与矢量平行);p4_control **65** 支 CONTROL PASSED
(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / progress 不夹 / 头尖不对点,各红 1/2/1 条点名断言);
dirty_gate 正本 knobs=132 takesEffect=132 findings=0、八支变异全红(claim F 判"坐标必须经 TryCubePoint",
改写后仍判得住);编译门 runtime+player+editor+3 对照 GATE PASSED(chain_p22.txt,
tooltip 那次改动之后重跑一次 chain_p22b.txt 同样绿)。

本轮我自己两次把臂写坏,两次都是 harness 拒绝而不是假判,记进规范:
① 单行锚 `AcrossTangent = Mathf.Max(0.1f, width),` 被我新写的孪生函数 Head/Dot 撞成 2 命中 ⇒ SETUP FAILED,
整轮作废 ⇒ 锚要加宽到"只有那一处才有的形状"(这次用两行块);
② 替换值给对象初始化器里那一行写了分号(`Progress = progress;`)⇒ 变异体 CS1513,又是 SETUP FAILED
⇒ 替换值要保持它所在语法位置的标点。
另外 run_gate 学到一件事(同轮改动):rsp 是项目取的快照,删掉一个源文件后那份快照还列着它 ⇒ CS2001,
整道门红得像"产品编译不过"。现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**
(判决要说出它判的是哪棵树)——这不是吞错:CS2001 说的是快照过期,Unity 重导入会自己重生成 rsp。

顺带把 P18 那个还欠着的 .meta(XChartArrowPathMath.cs.meta,Unity 早生成好了、我一直没提交)一起入仓。
覆盖不到的照旧:观感归他现场判(§29.5 四条:成对模式 31 支直线+三角头、连续绘制拖 HeadPosition 头沿线滑动、
颜色维沿程渐变、什么都没有时读 path=/arrows=/markers=/curveVerts=)。
This commit is contained in:
2026-10-26 13:15:55 +08:00
parent cb759fe583
commit 5f4c1adf0a
9 changed files with 273 additions and 297 deletions
+73
View File
@@ -1723,6 +1723,9 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
### 26.1 两端各自的颜色=填充四边形多一档线性渐变
> **本节那一档"箭头用法"已被 §29 撤掉**(2026-10-26 他纠正:杆走线、头用曲线渲染器的原生标记)。
> `AddFaceLinear` 这个能力留着——它是填充渲染器自己的一种上色模式,只是箭头不再经过它。
`XChartMeshFillRenderer` 原来只有两档:四角同色(平坦)与"四角 + 中心"(径向)。这轮加第三档
**线性渐变**(`AddFaceLinear`):`00/10` 一对边一色、`01/11` 一对边一色,渐变方向垂直于这两条边。
@@ -1925,3 +1928,73 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
- `XMeshPreviewChart` 的示例数据仍是**旧的"一条记录 6 维"口径**(方向存第 4~6 维):
新口径下那三列是**死数据**,画出来的是"每条记录位置 → 0.25×下一条记录位置"。
按"相邻两条"重造这份 demo 之前,要先确认它还想不想同时喂散点元素(一对记录里第二条也会成为一个点)。
## 29. P22:箭头的杆与头改走曲线渲染器的原生标记(2026-10-26 他的纠正)
### 29.1 他的原话,以及我为什么会绕远
> 箭头为何用的是填充?我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。
P18 那次我读不到库那个包(被拦过一次),就照着自己代码里的调用点猜 API——猜出来的
`AddCurve` / `CurveCacheEntry` 是对的,但**我没有回头把那个包整个读一遍**,于是它旁边的
`ArrowHeadData` 我一直不知道存在,就用填充四边形自己拼了杆和头。包其实就在工作区隔壁
(`com.lrss3.deconstruction`),API 一直写在 `Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs`。
教训不是"下次记得读",是:**照着调用点猜出来能跑之后,要把那个来源补读一遍**——
"我猜对了"证明不了"我看见全了"。
### 29.2 现在的画法(杆=线,头=标记,没有第二套几何)
- **杆**=一条**共线**的三次贝塞尔(`XChartArrowPathMath.Straight`:内控制点落在 1/3、2/3),
宽度=`ShaftWidth`,`startColor`/`endColor` 就是沿杆渐变——P18 我要的那个效果,其实是条目的原生能力。
- **头**=曲线渲染器的原生标记 `ArrowHeadData`:`shape=Triangle`、`width`=头长(沿切线)、
`height`=头宽(垂直切线)、`depthCompensation=+1`=**头尖对准那个数据点**(矢量场的箭头指的就是那一点)。
- **连续绘制**=Catmull-Rom 链逐节提交,头挂在 `ResolvePosition` 算出的那一节上,
`progress`=节内参数。**路径不再剪断**——"必须剪,否则线从箭头底下穿出去"是我上一版自己加的机制,
库的标记本来就设计成叠在线上,不需要它。于是 `XChartArrowPathMath.Split` 没有调用方了,随杆的四角一起删。
- **零向量**=一个 `Circle` 标记(就是个点);开关关掉则整条不画,`skipped=` 里看得见少了几条。
- **曲线渲染器不在位 ⇒ `path=none`,一支都不画**。没有"退回填充画法"那第二条路——两套画法就是两套口径,
而这次的 bug 恰恰长在"第二条路"上。
### 29.3 撤掉了什么,以及还剩什么没修
- 删 `XChartArrowGeometry`(`BuildShaft`/`BuildHead`/`TryBuild`:四角绕序那套)与 `XChartArrowPathMath.Split`;
`XChartMeshFillRenderer.AddFaceLinear` / `XChartFaceFillKind.Linear` **留着**——那是这个填充渲染器自己的一种
上色模式(预算 `VerticesPerFace(Linear)==4` 与判据都在),只是箭头不再用它;别的元素要渐变填充时不必再写第二套。
- **这件事的另一面要说清**:P13 遗留的"填充面改了没作用"和今天"杆与头都不画"是**同一个坏点的两种症状**
(都走 `XChartMeshFillRenderer`)。证据是他工程里那份报表(我打开开关后他自己跑出来的那一行):
```
Arrows … dims=3/3 records=32 dom=x[-100..100] y[-49.936..49.936] z[-49.743..50]
arrows=31 skipped=0 path=- curves=0 arrowFaces=62 fillChunks=1 fillMaxVerts=248
```
`dom=` 有值 ⇒ §28 那一步折进去了、坐标就在盒子里;`arrows=31`、`arrowFaces=62`、`fillChunks=1`、
`fillMaxVerts=248`(=62×4 个顶点,一个不多)⇒ **面提交了、子块建了、网格也真填了顶点**,画面上却没有。
所以不是数据形状、不是开关、不是顶点预算,是**填充渲染器到 Canvas 的那一跳**。(那一跳本轮没修:
箭头不再经过它,所以箭头上屏了,而网格背景/圆柱填充那两类如果也看不见,就是同一个坏点还没除掉。)
- **顺手抓到的一条会撒谎的读数**:同一行里 `curves=0` 但 `curveVerts=66`——`UICurveRenderer.LiveVertexCount`
**不是这个实例自己的数**(同一时刻圆柱那一行也印 66)。所以 `curveVerts=` 只能当"库里现在一共活着多少顶点"读,
不能当"我这条曲线提交了几个顶点"读;要看自己那份,读 `curves=`(条目数)与 `markers=`。已记进 P23 待办。
### 29.4 判据
- 探针 **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`)
在改写后仍然判得住。
- 编译门 runtime + player + editor + 3 支对照 `GATE PASSED`(`chain_p22.txt`)。
- **门自己的一次改动**(同轮):`run_gate` 把 rsp 里列出的每个源文件都喂给 csc;删掉一个源文件之后
那份快照还列着它 ⇒ `CS2001 找不到源文件`,整道门红得像"产品编译不过"。现在它**跳过工作区里已不存在的
包内源文件,并逐个点名印出来**(判决要能说出它判的是哪棵树)。这不是把错误吞掉:CS2001 说的是
"快照过期",不是"代码编译不过",Unity 重导入后会重新生成那份 rsp。
### 29.5 覆盖不到什么 / 他侧验收(Ctrl+R 后)
1. 关掉连续绘制:每支箭头=一段直线 + 末端三角头(32 条记录 ⇒ 31 支),姿态转过去也不会塌成一条线。
2. 打开连续绘制:一条平滑路径 + 一个头;拖 `HeadPosition` ⇒ 头**沿路径滑动**,路径不剪断。
3. 打开颜色维:杆沿程渐变(起点色 → 终点色),头是终点色。
4. 若画面仍然什么都没有 ⇒ 读报表那一行的 `path= / arrows= / markers= / curveVerts=`。
现在箭头这条路上没有"填充"那一层了,读数能给的解释比上一版窄——这正是这次改动的目的。