他这句纠正指向一件我一直不知道存在的东西: > 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。 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=)。
99 lines
4.9 KiB
C#
99 lines
4.9 KiB
C#
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
|
||
}
|
||
}
|
||
} |