他这句纠正指向一件我一直不知道存在的东西: > 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。 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=)。
180 lines
8.9 KiB
C#
180 lines
8.9 KiB
C#
using UnityEngine;
|
||
using XericUI.XChart;
|
||
|
||
namespace XericUI.XChart.Mesh
|
||
{
|
||
/// <summary>
|
||
/// 曲线渲染器的箭头标记长什么样(离线侧的形状,接线时一对一映射到库的 <c>ArrowShape</c>)。
|
||
/// 只列我们真用的两档:三角形=有方向的箭头,圆形=零向量那种"就是一个点"。
|
||
/// </summary>
|
||
public enum XChartMarkerShape
|
||
{
|
||
Triangle,
|
||
Circle,
|
||
}
|
||
|
||
/// <summary>
|
||
/// 一支箭头的<b>头</b>:位置(在曲线上的参数 0..1)、尺寸(沿切线/垂直切线)、颜色。
|
||
///
|
||
/// <para>这是<b>我们自己的</b>纯算术写法,不是库的结构体——离线探针引不到库那个 assembly,
|
||
/// 所以判据打在这个结构上,工具里只做"对号入座"的映射(§29)。尺寸在 <see cref="XChartVectorFieldMath.Head"/>
|
||
/// 里夹住而不是原样传:"头长 0"进库里就是画不出来的东西,而那里的调用方是面板上的数字框。</para>
|
||
/// </summary>
|
||
public struct XChartArrowMarker
|
||
{
|
||
public XChartMarkerShape Shape;
|
||
/// <summary>在曲线上的位置(0=起点、1=末端),已夹进 [0,1]</summary>
|
||
public float Progress;
|
||
/// <summary>沿切线方向的尺寸(库里叫 width)</summary>
|
||
public float AlongTangent;
|
||
/// <summary>垂直切线方向的尺寸(库里叫 height)</summary>
|
||
public float AcrossTangent;
|
||
/// <summary>+1=头尖对准那个点;0=中心对准(圆点用这个)</summary>
|
||
public float TipAtPoint;
|
||
public Color32 Color;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 矢量场(箭头)的<b>纯算术</b>:一条记录的两组三维怎么变成一支箭头,以及一组颜色维怎么变成颜色。
|
||
/// 单独拎出来是因为这两条是"看图看不出来"的判据——
|
||
/// 他 2026-10-25 现场:"我把它添加进来了,之后它并没有显示出来",以及"相对和绝对就是这两种区别"。
|
||
/// 读数与算式放在一起,离线探针才能逐条钉住(规范 §25)。
|
||
/// </summary>
|
||
public static class XChartVectorFieldMath
|
||
{
|
||
/// <summary>
|
||
/// 一条记录的原始三值 → <b>立方体单位</b>:每一维按<b>它自己的显示范围</b>映到 [-1,1]
|
||
/// (±1 就是盒子边界),与散点、圆柱走的是同一套(<see cref="XChartBindingMath.TryNormalize"/>)。
|
||
///
|
||
/// <para><b>为什么单独有这么一个函数</b>:箭头以前把数据值<b>直接当成立方体单位</b>用了,
|
||
/// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有
|
||
/// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归,
|
||
/// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。</para>
|
||
///
|
||
/// <para><b>任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答</b>——
|
||
/// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。</para>
|
||
/// </summary>
|
||
public static bool TryCubePoint(double x, double y, double z,
|
||
double minX, double maxX, double minY, double maxY, double minZ, double maxZ,
|
||
out Vector3 cube)
|
||
{
|
||
cube = Vector3.zero;
|
||
|
||
float nx, ny, nz;
|
||
if (!XChartBindingMath.TryNormalize(x, minX, maxX, out nx)
|
||
|| !XChartBindingMath.TryNormalize(y, minY, maxY, out ny)
|
||
|| !XChartBindingMath.TryNormalize(z, minZ, maxZ, out nz)) return false;
|
||
|
||
cube = new Vector3(nx, ny, nz);
|
||
return true;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 三角形头。<paramref name="progress"/> 夹进 [0,1];<b>不是有限数就落在末端</b>(1)——
|
||
/// NaN 一路传进库里会得到一个位置未知、也报不出错的东西,那正是"画面和读数对不上"的来路。
|
||
/// 两个尺寸都兜住最小值:0 长的头等于没画,而"没画"该由开关说话,不该由算术偷偷决定。
|
||
/// </summary>
|
||
public static XChartArrowMarker Head(float length, float width, float progress, Color color)
|
||
{
|
||
return new XChartArrowMarker
|
||
{
|
||
Shape = XChartMarkerShape.Triangle,
|
||
Progress = IsFinite(progress) ? Mathf.Clamp01(progress) : 1f,
|
||
AlongTangent = Mathf.Max(0.1f, length),
|
||
AcrossTangent = Mathf.Max(0.1f, width),
|
||
TipAtPoint = 1f,
|
||
Color = color,
|
||
};
|
||
}
|
||
|
||
/// <summary>零向量的圆点:位置在条目中间(0.5)、中心对准那个点。</summary>
|
||
public static XChartArrowMarker Dot(float diameter, float width, Color color)
|
||
{
|
||
return new XChartArrowMarker
|
||
{
|
||
Shape = XChartMarkerShape.Circle,
|
||
Progress = 0.5f,
|
||
AlongTangent = Mathf.Max(0.1f, diameter),
|
||
AcrossTangent = Mathf.Max(0.1f, width),
|
||
TipAtPoint = 0f,
|
||
Color = color,
|
||
};
|
||
}
|
||
|
||
/// <summary>
|
||
/// 末端位置。<paramref name="mode"/>=<see cref="XChartArrowVectorMode.Absolute"/> 时
|
||
/// <paramref name="second"/> 是<b>方向矢量</b>本身(起点 + 方向×倍率);
|
||
/// =<see cref="XChartArrowVectorMode.Relative"/> 时它是<b>第二个点</b>(起点 + 差向量×倍率)。
|
||
/// 两种读法在同一个数据上画出来是两幅不同的图:前者"刺猬",后者"首尾相接"。
|
||
/// </summary>
|
||
public static Vector3 Tip(XChartArrowVectorMode mode, Vector3 first, Vector3 second, float scale)
|
||
{
|
||
Vector3 direction = mode == XChartArrowVectorMode.Relative ? second - first : second;
|
||
return first + direction * scale;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 一支箭头=相邻两条记录 ⇒ 给定记录数与上限,能画出几支(上限 ≤0 =不限)。
|
||
///
|
||
/// <para>单列出来是因为<b>"记录不够"与"维数不够"在画面上完全同形</b>(都是一条都不画),
|
||
/// 而 N−1 与 0 这两个数是唯一分得清它们的读数(规范 §25.1)。</para>
|
||
/// </summary>
|
||
public static int ArrowCount(int recordCount, int maxArrows)
|
||
{
|
||
if (recordCount < 2) return 0;
|
||
int pairs = recordCount - 1;
|
||
if (maxArrows > 0 && maxArrows < pairs) return maxArrows;
|
||
return pairs;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 读一组颜色维:<paramref name="hue"/> 按 <b>0..256 的色环</b>(256 与 0 是同一个颜色,
|
||
/// 取模,所以 300 也读得动),饱和度/明度/不透明度按 0..1 夹住。
|
||
///
|
||
/// <para><b>任何一个不是有限数就拒绝</b>(返回 false,调用方退回单色):
|
||
/// NaN 经取模与 HSV 换算会得到一个看着像"黑色块"的东西——那不是数据的意思,
|
||
/// 是我们在替它编一个颜色(同 §14.1 的"宁可这一帧不画")。</para>
|
||
/// </summary>
|
||
public static bool TryColor(float hue, float saturation, float value, float alpha, out Color color)
|
||
{
|
||
color = Color.white;
|
||
if (!IsFinite(hue) || !IsFinite(saturation) || !IsFinite(value) || !IsFinite(alpha)) return false;
|
||
|
||
color = HsvToRgb(Mathf.Repeat(hue / 256f, 1f), Mathf.Clamp01(saturation), Mathf.Clamp01(value));
|
||
color.a = Mathf.Clamp01(alpha);
|
||
return true;
|
||
}
|
||
|
||
private static bool IsFinite(float value)
|
||
=> !float.IsNaN(value) && !float.IsInfinity(value);
|
||
|
||
/// <summary>
|
||
/// HSV → RGB(h∈[0,1),s/v∈[0,1])。
|
||
/// <b>自己写而不是调 <c>Color.HSVToRGB</c></b>:后者是引擎侧的静态调用,
|
||
/// 离线探针(mono + CoreModule)里跑不起来,而这条换算恰恰是要离线钉住的(规范 §25)。
|
||
/// </summary>
|
||
private static Color HsvToRgb(float h, float s, float v)
|
||
{
|
||
if (s <= 0f) return new Color(v, v, v, 1f);
|
||
|
||
float sector = h * 6f;
|
||
int index = Mathf.FloorToInt(sector) % 6;
|
||
if (index < 0) index += 6;
|
||
float f = sector - Mathf.Floor(sector);
|
||
|
||
float p = v * (1f - s);
|
||
float q = v * (1f - s * f);
|
||
float t = v * (1f - s * (1f - f));
|
||
|
||
switch (index)
|
||
{
|
||
case 0: return new Color(v, t, p, 1f);
|
||
case 1: return new Color(q, v, p, 1f);
|
||
case 2: return new Color(p, v, t, 1f);
|
||
case 3: return new Color(p, q, v, 1f);
|
||
case 4: return new Color(t, p, v, 1f);
|
||
default: return new Color(v, p, q, 1f);
|
||
}
|
||
}
|
||
}
|
||
} |