Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
T
lrss3 cb759fe583 XChart P21:矢量场没渲染的根因是箭头把数据值当立方体单位用了——现在它也折进盒子
他报"矢量场现在没有在渲染"。我先从他自己的资产里取状态,不猜:
SP_盾构机掘进姿态 Variant.prefab 里那份表是 x/y/z 三个数值维、记录值量级 -100..50(三条以上),
箭头元素 m_Enabled=1、VectorMode=Absolute、Continuous=0、UseColorDimensions=0、MaxArrowCount=512。
⇒ 形状是够的(需要 3、现有 3,面板那句"一条都不画"不会亮),问题在**尺度**。

根因(我这边的缺陷,不是 P20 改坏的):ChartToolVectorArrows.ReadPoint 把 GetValueAt 的原始值
**直接当立方体单位**(±1=盒子边界)用,一份 -100..50 的表就把每支箭头投到一万多像素之外——
支数在算、面在提交、画面什么都没有。散点与圆柱一直是"按各维显示范围折进盒子"
(context.TryResolveDomain + XChartBindingMath.TryNormalize),只有箭头这一条路径漏了:
同一件事两套口径,坏的那一套不报错,只是看不见。P20 那次提交 33/17 行全在属性形状上,
他的 Editor.log 里这次导入只有一条无关的 CS0414,也排除了"是我刚改坏的"。

修法:
- 纯算术新增 XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube):每一维按自己的范围
  映到 [-1,1];**任何一维折不出来(跨度 ≤0、值或端点非有限)就整体拒答**——半归一化的坐标比不
  归一化的更难查,它会画出"看着像个箭头但方向不对"的东西。折法放纯算术里才离线钉得住。
- 工具每帧现问三条轴的范围(范围不归元素存,与散点同一条规矩);读点改 TryReadPoint,
  读不出来的点计入 skipped=,不静默少画。
- 报表多了两个读数:dom=x[..] y[..] z[..](折不出来印 dom=-,那时一支都不画,原因当场可见)、
  skipped=。他那份表应当印出 dom=x[-100..50] ... 且 arrows=记录数-1。

判据:探针 458 项 0 失败(新增 8 条 vector field cube:域两端落 ±1、域中落 0、他表里那种量级的
记录 (-93.5, 10.1, 49.0) 在给定域下折进盒子内、域外**保持成比例而不是被夹住**、零跨度拒答、非有限拒答、坏一轴整体拒答);
p4_control 新增 3 支臂(不折、坏一轴也答、偷偷夹住)各红在自己点名的断言上(分别 5/3/1 条),
全套 64 支 CONTROL PASSED:"arms 0-63 of 64 went red on their named assertions";
dirty_gate 新增 claim F(箭头的坐标必须经 TryCubePoint;原始值直接进 Vector3 就红)并配一支变异 M8,
**八支全红**、正本 knobs=132 takesEffect=132 findings=0;编译门 runtime+player+editor+3 对照
GATE PASSED(chain_p21.txt)。

一条"判据的判据"本轮现形:M8 第一版**是绿的**——不是判据太弱,是 claim F 用来认文件的参数
被 claim C 的 `for name in names` 循环重新绑定了(judge(lines, name) 里 name 既是文件名又当旋钮名,
循环跑完它就变成最后一个旋钮的名字 ⇒ F 支永远不执行)。"臂能红"这件事第一次是靠它自己抓到的:
不红 ⇒ 追下去 ⇒ 抓到参数遮蔽。规矩:给"按文件生效的判据"传参,参数名不许与函数体内的循环变量同名
(这次改成 source)。另记一条 py2 的:门脚本声明 coding: ascii,我把中文写进注释就直接
SyntaxError(中文只进仓内文档,不进脚本)。

如实留给现场/下一轮的两条,我没偷改:
① Absolute 下"方向=下一条记录的坐标",他那串姿态点用 **Relative** 才对(首尾相接=轨迹方向);
② XMeshPreviewChart 的示例数据还是**旧的"一条记录 6 维"口径**(方向存第 4~6 维),
   新口径下那三列是死数据——要按"相邻两条"重造那份 demo,得先确认它还想不想同时喂散点元素。
2026-10-26 10:17:37 +08:00

117 lines
5.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>
/// 矢量场(箭头)的<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="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);
}
}
}
}