Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVectorFieldMath.cs
T
lrss3 f4a8df6dd7 XChart P27:显示范围只定标尺,数据图元自己决定"钳 / 藏 / 原样"(规范 §32)
他报的现象:"散点会把点钳在范围内,矢量不钳;而且四档方向来源画出来的东西看不出意义。"
两处都对得上字面,成因不同:

- 钳与不钳是**两份实现**:散点折进盒子用 Mathf.Clamp01(超范围的点钉在盒壁上,看着像"数据到边就停"),
  圆柱/矢量按 TryNormalize 比例投(可以出盒外)。两边都"看着挺对"、谁也不报错。
- 四档"没意义"里有一档是我的单位错:位置除以了跨度,方向**没有**——(−93.5,10.1,49.0) 这种原始值
  直接当立方体单位 ×0.25 ⇒ 长约 23 个盒子单位 ≈ 2700 像素,所以"一根比终点还大的矢量"。
  (另两档的小短矢量是"把位置当方向"的必然结果,第四档 ThisRecordCarriesVector 什么都不画是**对的**:
  它要 6 个数值维,那张表只有 x/y/z 三列。)

他的裁定:范围的本分是定标尺(网格多大、轴到哪儿),**不该决定数据画不画**;但有时又想看被限制住的版本
⇒ 开关交给数据图元。落法:
① 新纯算术 XChartCubeFoldMath:TryRatio01(value,min,max,behaviour,out 0..1) 是**唯一**一份"值→盒子内比例",
   TryFoldCube 是三轴全有或全无版。散点那份 Clamp01、圆柱那份 XChartBindingMath.TryNormalize、
   箭头那份 XChartVectorFieldMath.TryCubePoint ——**三份并成一份**(箭头的删掉)。
② 数据图元各一个 XChartValueOutOfRange,默认 RenderAsIs(散点从此不贴边=行为变更);
   另一处行为变更:一整列同一个数以前让矢量整条拒答(跨度≤0 ⇒ false),现在答**居中**——
   为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数(NaN/Inf)仍拒答。
   隐藏是**整条记录**,不藏一半坐标(只夹一轴会画出"数据里不存在"的位置)。
③ 轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B")。
④ 颜色映射那一档**刻意不统一**:越界取端色是常态,继续夹;"隐藏超范围"是坐标的事——注释写明,
   防下次有人"顺手统一"把梯度弄出洞。
⑤ 读数 out=asis|clamptorange|hideoutofrange、hidden=(策略隐的)与 skipped=(数据不可用的)分开印:
   "我主动不画"和"数据不能用"必须分得开。

搬家那一步被门抓了一次且抓得对:dirty_gate 的 claim F 当场 FAIL("箭头坐标不再经过折法")。
它判的是"必须经过**唯一那份**折法",不是"必须调用某个旧名字" ⇒ 正确处置是把门指向新来源,
**删判据是错的处理**;M8(把旧形状塞回去)继续红,顺带证明"搬家会被抓到"。

判据:探针 469 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上);
p4_control **71** 支 CONTROL PASSED、0 次 SETUP FAILED(新 2 支:hide 不 hide、clamp 不 clamp;
搬家 3 支重挂到新文件,点名清单按实测改:8/3/2/1/1 条各自红);
dirty_gate 正本 knobs=136 takesEffect=136(三个新旋钮都是自动置脏 setter)、九支全红;
编译门 runtime+player+editor+3 对照绿(chain_p27.txt)。

自己的两条错照记:新判据的期望值我手打算错了域(y 是 -20..20 我按 -100..50 算),第一次跑就被自己的探针红出来
(手打的数字必须有对着真输入的断言);中文第四次进了声明 coding: ascii 的门脚本。

**还没修的另一半,等他定**:方向的单位错(②那档没除以跨度)要加"差折法" TryDeltaRatio=value/(max-min)
(不减 min:位移会把朝向变成位置),四档长度才终于与盒子同尺度;顺带旧 NextRecordAsVector 那一档去留
(他预制里存的就是序号 0,删除或改默认都会改他画面)——三个选项与我的建议(把它迁到首尾相接)已回给他。
覆盖不到的:画到盒外的点会不会被别的东西挡住、"默认钳还是默认原样"好不好看,归他现场判。
2026-10-26 20:07:32 +08:00

224 lines
12 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-26 补的口径:光有"相对/绝对"两个词表达不出
/// "一条记录自带方向"和"偶数点是点、奇数点是方向"这两种存法)。
///
/// <para><b>编号是有意接旧的</b>:0/1 就是原来 <c>XChartArrowVectorMode</c> 的 Absolute/Relative,
/// 所以场景里存过的 <c>m_VectorMode</c> 值不用动就还是同一个意思(枚举换类型而序号不改=静默丢值的反面)。
/// 2/3 是新增的两档"方向是矢量"的存法。</para>
/// </summary>
public enum XChartArrowDirectionSource
{
/// <summary>相邻两条、重叠:本条=起点,下一条的<b>坐标</b>就是方向矢量(旧 Absolute)。箭数=N−1</summary>
NextRecordAsVector = 0,
/// <summary>相邻两条、重叠:本条=起点,下一条=<b>第二个点</b>(旧 Relative,首尾相接)。箭数=N−1</summary>
NextRecordAsPoint = 1,
/// <summary>一条记录自带:0~2 维是点、3~5 维是方向矢量。箭数=N(要 6 个数值维)</summary>
ThisRecordCarriesVector = 2,
/// <summary>分段:偶数记录是点、奇数记录是方向(不重叠)。箭数=N/2</summary>
AlternatingRecords = 3,
}
/// <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
{
// "数据值 → 立方体单位(以及超出显示范围怎么办)"<b>不在这里</b>:散点、矢量、圆柱都要同一套折法,
// 收在 XChartCubeFoldMath(§32)。两处各写一遍就出现过"散点把点夹在盒壁上、矢量却画到盒外"——
// 同一张表两幅画,而且两边都"看着挺对"。
/// <summary>
/// 三角形头。<paramref name="progress"/> 与 <paramref name="anchorOnPoint"/> 都夹进 [0,1];
/// <b>不是有限数就退回默认</b>(位置=末端、锚=头尖对点)——
/// NaN 一路传进库里会得到一个位置未知、也报不出错的东西,那正是"画面和读数对不上"的来路。
/// 两个尺寸都兜住最小值:0 长的头等于没画,而"没画"该由开关说话,不该由算术偷偷决定。
/// </summary>
public static XChartArrowMarker Head(float length, float width, float progress, float anchorOnPoint,
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 = AnchorToCompensation(anchorOnPoint),
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="source"/>=<see cref="XChartArrowDirectionSource.NextRecordAsPoint"/> 时
/// <paramref name="second"/> 是<b>第二个点</b>(起点 + 差向量×倍率,首尾相接);
/// 其余三档它就是<b>方向矢量</b>本身(起点 + 方向×倍率)。
/// 相邻两条的两档在同一个数据上画出来是两幅图:一片"刺猬"对一串首尾相接。
/// </summary>
public static Vector3 Tip(XChartArrowDirectionSource source, Vector3 first, Vector3 second, float scale)
{
// 只有"下一条记录是第二个点"这一档要作差;其余档里 second 本身就是方向矢量。
// 点到点这一档的两端都是投影点,所以它的 2D 长度天然是投影结果,不需要再多算一次(他 2026-10-26)
Vector3 direction = source == XChartArrowDirectionSource.NextRecordAsPoint ? second - first : second;
return first + direction * scale;
}
/// <summary>
/// 这一档方向来源<b>每个箭头自己要吃几个数值维</b>:自带方向那档要 6 个(0~2 点、3~5 方向),
/// 其余三档只要 3 个(方向从别的记录来)。
///
/// <para>面板拿它和表里现有的维数对印(§25.1):维数不够时元素一支都不画,
/// 报出来必须是"需要几个、现有几个"两个数,不能只说"没显示"。</para>
/// </summary>
public static int RequiredCoordinateDimensions(XChartArrowDirectionSource source)
=> source == XChartArrowDirectionSource.ThisRecordCarriesVector
? XChartArrowConfig.CoordinateDimensionCount * 2
: XChartArrowConfig.CoordinateDimensionCount;
/// <summary>
/// 给定记录数与上限,这一档来源能画几支。四种算法各不同,所以都得在这里,
/// 由调用方现问而不是在工具里各写一遍("N−1/N/N÷2"三个数写错一个,画面上只是少几支,最难查)。
/// </summary>
public static int ArrowCount(XChartArrowDirectionSource source, int recordCount, int maxArrows)
{
// 没有"记录数 ≤0 就先返回 0"那道闸:四档算法各自都把 0/1 条算成 0(0−1、0/2、<2 那一支),
// 加一道到不了的守卫只会多一个"看起来判过、其实永远不响"的地方(§29.4 那条教训)
int pairs;
switch (source)
{
case XChartArrowDirectionSource.ThisRecordCarriesVector: pairs = recordCount; break;
case XChartArrowDirectionSource.AlternatingRecords: pairs = recordCount / 2; break;
default: pairs = recordCount < 2 ? 0 : recordCount - 1; break; // 相邻两条那两档
}
if (maxArrows > 0 && maxArrows < pairs) return maxArrows;
return pairs;
}
/// <summary>
/// 锚点 → 库的 <c>depthCompensation</c>:<b>0=尾部落在数据点上、0.5=中心、1=头尖落在点上</b>
/// (映射就是 anchor×2−1)。默认 1:矢量场的箭头指的就是那一点。
/// 非有限数按 1 处理——"头该贴在哪"这件事不该因为一次写坏的值变成位置未知。
/// </summary>
public static float AnchorToCompensation(float anchorOnPoint)
=> IsFinite(anchorOnPoint) ? Mathf.Clamp01(anchorOnPoint) * 2f - 1f : 1f;
/// <summary>
/// <b>这条矢量的投影比例</b>:投影后画了多少像素 ÷ 它在立方体单位里该有多少像素
/// (<paramref name="projectedPixels"/>=|to−from|,<paramref name="cubeLength"/>=|tip−origin|(立方体单位),
/// <paramref name="pixelsPerCubeUnit"/>=<c>space.CubeToPixel</c>)。
/// 平行于屏幕=1,指向屏幕里→0。库的标记吃的是<b>固定像素</b>(库里那行
/// <c>pos += tangent * arrow.width * 0.5f * depthCompensation</c>),所以头的尺寸必须乘上这个比例,
/// 否则所有姿态下头一样长——他 2026-10-26 看到的就是这个:"圆周方向的长度在 2D 上的投影不可能完全一样长"。
/// 除不出来(长度为 0 或不是有限数)就答 0:宁可头缩成没有,也不要一个凭空的固定尺寸。
/// </summary>
public static float ProjectedScale(float projectedPixels, float cubeLength, float pixelsPerCubeUnit)
{
if (!IsFinite(projectedPixels) || !IsFinite(cubeLength) || !IsFinite(pixelsPerCubeUnit)) return 0f;
float reference = cubeLength * pixelsPerCubeUnit;
if (reference <= 1e-6f) return 0f;
float scale = projectedPixels / reference;
return scale > 0f ? scale : 0f;
}
/// <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);
}
}
}
}