Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
T
lrss3 5f4c1adf0a XChart P22:箭头的杆与头改走曲线渲染器的原生标记(规范 §29,他纠正"箭头为何用的是填充")
他这句纠正指向一件我一直不知道存在的东西:

> 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。

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=)。
2026-10-26 13:15:55 +08:00

180 lines
8.9 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;
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);
}
}
}
}