From c40aa1f0c1c4a3f1603ae473f0ff558fe0cf1252 Mon Sep 17 00:00:00 2001
From: lrc <571244399@qq.com>
Date: Mon, 26 Oct 2026 07:29:58 +0800
Subject: [PATCH] =?UTF-8?q?XChart=20P18=EF=BC=88=E4=B8=AD=EF=BC=89?=
=?UTF-8?q?=EF=BC=9A=E8=BF=9E=E7=BB=AD=E7=BB=98=E5=88=B6=E9=82=A3=E6=9D=A1?=
=?UTF-8?q?=E8=B7=AF=E5=BE=84=E7=9A=84=E7=AE=97=E6=9C=AF=E4=B8=8E=E5=88=A4?=
=?UTF-8?q?=E6=8D=AE=EF=BC=88=E6=9B=B2=E7=BA=BF=E6=B8=B2=E6=9F=93=E5=99=A8?=
=?UTF-8?q?=E6=8E=A5=E7=BA=BF=E5=89=8D=E7=9A=84=E5=9C=B0=E5=9F=BA=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
新增纯算术 `Runtime/XChart/Mesh/XChartArrowPathMath.cs`:一串途经点 → 三次贝塞尔链
(Catmull-Rom,张力 1/6),以及链上取点 / 取切线 / 在参数处剪成两段 / "整条路径的位置"换成段号+段内参数。
为什么先落算式:曲线渲染器(库里的 `UICurveRenderer`,圆柱弧段已在用,`AddCurve(entry, 4 控制点, 4 宽度)`,
entry 自带起止色=沿程渐变)吃的是**控制点**——控制点算错,画面上只是"看着不太对",不会报错。
箭头放在路径哪一处、切线朝哪,全由这几个函数决定,所以每条都要有判据。
判据(9 条,全是**性质**而不是手算的中间点坐标——写死的数字一旦错了就是抄自己的输出):
- 曲线**经过每个数据点**(段的两端就是那两个点);
- 端点切线=过该点那条弦的一半(Catmull-Rom 的标准性质,张力 1/6 就是它的来源);
- 剪开的两半**共用同一个剪口点**,且逐参数接回去与原段逐点一致(8 个采样点,最大偏差 <1e-4);
- 共线的点画出来仍是直的(切线平行、y 恒 0);
- 位置 0 → 首段起点、1 → **末段末端**、0.5 → 第 2 段起点;段数 0 时给出的是"没有路径"而不是猜。
`p4_control` **61** 支臂:新增两支各红在点名断言上(把控制柄拉成 /3 张力、剪开时不共用剪口点);
探针 **450** 项 0 失败;编译门三臂 + 3 对照绿。
下一笔把这条链接进 `ChartToolVectorArrows` 的连续绘制(曲线渲染器 + 箭头位置可调)。
新文件的 `.meta` 要等 Unity 导入才有,届时单独补一笔。
---
Runtime/XChart/Mesh/XChartArrowPathMath.cs | 122 +++++++++++++++++++++
1 file changed, 122 insertions(+)
create mode 100644 Runtime/XChart/Mesh/XChartArrowPathMath.cs
diff --git a/Runtime/XChart/Mesh/XChartArrowPathMath.cs b/Runtime/XChart/Mesh/XChartArrowPathMath.cs
new file mode 100644
index 0000000..837a166
--- /dev/null
+++ b/Runtime/XChart/Mesh/XChartArrowPathMath.cs
@@ -0,0 +1,122 @@
+using UnityEngine;
+
+namespace XericUI.XChart.Mesh
+{
+ ///
+ /// 矢量场"连续绘制"那条路径的纯算术:一串点 → 一条平滑折线(三次贝塞尔链),
+ /// 以及在链上取点/取切线、在某个参数处把链剪成两段。
+ ///
+ /// 为什么要单独一个文件:这几条是"画出来对不对"唯一能离线判的部分——
+ /// 曲线渲染器那一层(库里的 UICurveRenderer)吃的是控制点,
+ /// 控制点算错了画面只会"看着不太对",不会报错。箭头放在路径的哪一处、切线朝哪,
+ /// 全部由这里的算式决定,所以每条都要有判据(规范 §25、§26)。
+ ///
+ /// 平滑用的是 Catmull-Rom 转贝塞尔:给一串途经点,每段 (p1→p2) 的两个内控制点
+ /// 由相邻点 p0/p3 推出(张力 1/6 那档,标准写法)。这样曲线真的经过每个数据点——
+ /// 矢量场的点是数据本身,用"不经过控制点"的自由贝塞尔就等于把数据挪了位置。
+ ///
+ public static class XChartArrowPathMath
+ {
+ /// 一段贝塞尔的控制点个数
+ public const int ControlPointsPerSegment = 4;
+
+ ///
+ /// 由四个途经点 p0,p1,p2,p3 推出段 p1→p2 的三次贝塞尔控制点(写进
+ /// [0..3])。端点外的点(首段的前一点、末段的后一点)
+ /// 由调用方重复端点给出——那是标准做法,效果是端点处切线指向段内。
+ ///
+ 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;
+ }
+
+ /// 贝塞尔上参数 t 处的点(de Casteljau,t 夹到 [0,1])
+ 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);
+ }
+
+ ///
+ /// 贝塞尔在参数 t 处的切线(导数,未归一化;退化时返回零向量,由调用方决定怎么办)。
+ /// 箭头要"顺着路径"就必须吃这条,而不是吃两端点的连线——后者在弯曲处会偏。
+ ///
+ 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]);
+ }
+
+ ///
+ /// 在参数 t 处把一段三次贝塞尔剪成两段(de Casteljau 分裂):
+ /// 是 [0,t] 那半、 是 [t,1] 那半,
+ /// 两者各 4 个控制点。两段接回去必须与原段逐点一致——这条由探针判据钉住
+ /// (剪错了画面上是"箭头前面那段路挪了位",很不容易看出来)。
+ ///
+ public static void Split(Vector2[] bezier, float t, Vector2[] left, Vector2[] right)
+ {
+ if (bezier == null || bezier.Length < ControlPointsPerSegment) return;
+ if (left != null && left.Length < ControlPointsPerSegment) return;
+ if (right != null && right.Length < ControlPointsPerSegment) return;
+ 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);
+ Vector2 f = Vector2.Lerp(d, e, t); // = 曲线在 t 处的点
+
+ if (left != null)
+ {
+ left[0] = bezier[0];
+ left[1] = a;
+ left[2] = d;
+ left[3] = f;
+ }
+ if (right != null)
+ {
+ right[0] = f;
+ right[1] = e;
+ right[2] = c;
+ right[3] = bezier[3];
+ }
+ }
+
+ ///
+ /// 把"整条路径上的位置"(0=起点,1=末端)换成段号 + 段内参数。
+ /// 段数 ≤0 时给 0 段、参数 1(调用方按"没有路径"处理)。
+ ///
+ 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
+ }
+ }
+}
\ No newline at end of file