Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartArrowPathMath.cs
T
lrss3 5f4c1adf0a 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=)。
2026-10-26 13:15:55 +08:00

99 lines
4.9 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using UnityEngine;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 矢量场"连续绘制"那条路径的<b>纯算术</b>:一串点 → 一条平滑折线(三次贝塞尔链)、
/// 在链上取点/取切线、把"路径上的位置"换成"第几节的哪个参数",以及把两点写成一条直线贝塞尔。
///
/// <para><b>为什么要单独一个文件</b>:这几条是"画出来对不对"唯一能离线判的部分——
/// 曲线渲染器那一层(库里的 <c>UICurveRenderer</c>)吃的是<b>控制点</b>,
/// 控制点算错了画面只会"看着不太对",不会报错。箭头放在路径的哪一处、切线朝哪,
/// 全部由这里的算式决定,所以每条都要有判据(规范 §25、§26)。</para>
///
/// <para><b>平滑用的是 Catmull-Rom 转贝塞尔</b>:给一串途经点,每段 (p1→p2) 的两个内控制点
/// 由相邻点 p0/p3 推出(张力 1/6 那档,标准写法)。这样曲线<b>真的经过每个数据点</b>——
/// 矢量场的点是数据本身,用"不经过控制点"的自由贝塞尔就等于把数据挪了位置。</para>
/// </summary>
public static class XChartArrowPathMath
{
/// <summary>一段贝塞尔的控制点个数</summary>
public const int ControlPointsPerSegment = 4;
/// <summary>
/// 由四个途经点 p0,p1,p2,p3 推出<b>段 p1→p2</b> 的三次贝塞尔控制点(写进
/// <paramref name="bezier"/>[0..3])。端点外的点(首段的前一点、末段的后一点)
/// 由调用方<b>重复端点</b>给出——那是标准做法,效果是端点处切线指向段内。
/// </summary>
public static void CatmullRomToBezier(Vector2 p0, Vector2 p1, Vector2 p2, Vector2 p3, Vector2[] bezier)
{
if (bezier == null || bezier.Length < ControlPointsPerSegment) return;
bezier[0] = p1;
bezier[1] = p1 + (p2 - p0) / 6f;
bezier[2] = p2 - (p3 - p1) / 6f;
bezier[3] = p2;
}
/// <summary>贝塞尔上参数 t 处的点(de Casteljau,t 夹到 [0,1])</summary>
public static Vector2 Evaluate(Vector2[] bezier, float t)
{
if (bezier == null || bezier.Length < ControlPointsPerSegment) return Vector2.zero;
t = Mathf.Clamp01(t);
Vector2 a = Vector2.Lerp(bezier[0], bezier[1], t);
Vector2 b = Vector2.Lerp(bezier[1], bezier[2], t);
Vector2 c = Vector2.Lerp(bezier[2], bezier[3], t);
Vector2 d = Vector2.Lerp(a, b, t);
Vector2 e = Vector2.Lerp(b, c, t);
return Vector2.Lerp(d, e, t);
}
/// <summary>
/// 贝塞尔在参数 t 处的<b>切线</b>(导数,未归一化;退化时返回零向量,由调用方决定怎么办)。
/// 箭头要"顺着路径"就必须吃这条,而不是吃两端点的连线——后者在弯曲处会偏。
/// </summary>
public static Vector2 Tangent(Vector2[] bezier, float t)
{
if (bezier == null || bezier.Length < ControlPointsPerSegment) return Vector2.zero;
t = Mathf.Clamp01(t);
float u = 1f - t;
// B'(t) = 3(1-t)^2 (P1-P0) + 6(1-t)t (P2-P1) + 3t^2 (P3-P2)
return 3f * u * u * (bezier[1] - bezier[0])
+ 6f * u * t * (bezier[2] - bezier[1])
+ 3f * t * t * (bezier[3] - bezier[2]);
}
/// <summary>
/// 两点之间的<b>共线</b>三次贝塞尔控制点(内控制点落在 1/3、2/3)——细分多少节都是那条直线。
/// 一支箭头的杆走这一条:杆和路径用同一个渲染器、同一套宽度与起止色,
/// 就不需要"填充四边形"那第二套画法(他 2026-10-26 的纠正,§29)。
/// </summary>
public static void Straight(Vector2 from, Vector2 to, Vector2[] bezier)
{
bezier[0] = from;
bezier[1] = Vector2.Lerp(from, to, 1f / 3f);
bezier[2] = Vector2.Lerp(from, to, 2f / 3f);
bezier[3] = to;
}
/// <summary>
/// 把"整条路径上的位置"(0=起点,1=末端)换成<b>段号 + 段内参数</b>。
/// 段数 ≤0 时给 0 段、参数 1(调用方按"没有路径"处理)。
/// </summary>
public static void ResolvePosition(int segmentCount, float along, out int segment, out float t)
{
segment = 0;
t = 1f;
if (segmentCount <= 0) return;
float scaled = Mathf.Clamp01(along) * segmentCount;
int index = Mathf.FloorToInt(scaled);
if (index >= segmentCount) index = segmentCount - 1;
segment = index;
t = scaled - index;
if (index == segmentCount - 1 && t > 0f) t = scaled - index; // 末段允许走到 1
}
}
}