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 导入才有,届时单独补一笔。
This commit is contained in:
@@ -0,0 +1,122 @@
|
|||||||
|
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
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user