Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartArrowPathMath.cs
T
lrss3 c40aa1f0c1 XChart P18(中):连续绘制那条路径的算术与判据(曲线渲染器接线前的地基)
新增纯算术 `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 导入才有,届时单独补一笔。
2026-10-26 07:29:58 +08:00

122 lines
5.7 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>
/// 在参数 t 处把一段三次贝塞尔<b>剪成两段</b>(de Casteljau 分裂):
/// <paramref name="left"/> 是 [0,t] 那半、<paramref name="right"/> 是 [t,1] 那半,
/// 两者各 4 个控制点。<b>两段接回去必须与原段逐点一致</b>——这条由探针判据钉住
/// (剪错了画面上是"箭头前面那段路挪了位",很不容易看出来)。
/// </summary>
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];
}
}
/// <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
}
}
}