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:
@@ -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=`。
|
||||
现在箭头这条路上没有"填充"那一层了,读数能给的解释比上一版窄——这正是这次改动的目的。
|
||||
|
||||
Reference in New Issue
Block a user