Files
XericUIActionVessel/Runtime/XChart/XChartCubeFoldMath.cs
T
lrss3 890493e41e XChart P29:方向改走"差折法"(只缩不移位)——他看到的"一根比终点还大的矢量"是单位错
他试完四档报"看起来完全没有意义"。四行的成因不同,我按他自己的数字各算了一遍(规范 §33 有那张表):
`NextRecordAsVector` 用"下一条记录折好的坐标"当方向 ⇒ 最长 0.25 个盒半径(短矢量);`NextRecordAsPoint`
用相邻两点的差 ⇒ 同样短;`ThisRecordCarriesVector` 要 6 个数值维而他只有 3 列 ⇒ 一支都不画(**这是正确的拒绝**,
缺的是数据里的方向列);`AlternatingRecords` 用奇数行的**原始值**当方向、没折 ⇒ (-93.5,10.1,49.0)×0.25
≈ 23 个立方体单位 ≈ 2700 像素 ⇒ 那根"比终点还大的矢量"。

前两档没意义是因为他的表没有方向列(把位置当方向用,本来就是凑数的一档,去留等他定,见 §33.4);
**第四档是 bug**:位置除以了跨度、方向没有——同一个 DirectionScale 底下一套值两种单位。

修法:纯算术新增 XChartCubeFoldMath.TryFoldDelta = delta/span×2。三条口径写死在注释与判据里:
- **不减 min**:位置折"在这列数据里的位置",方向折"多长、朝哪";减了起点,全表整体平移就会把所有箭头挪位置
  (把"朝哪"变成"在哪")。
- **一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度;DirectionScale 回到"再乘多少倍"的本分。
- **不吃 OutOfRange**:钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向。
折不出来(某一列跨度 ≤0,或值非有限)这一条拒画,报表 hidden=(尺度没用)与 skipped=(数据坏)分开数。

判据:探针 473 项 0 失败,新 4 条打在**性质**上——"零方向仍是零"(位置折法在这儿会答 −1,这一条正是两套折法的分界)、
一个跨度=2 个单位、成比例且带符号、跨度 0/非有限拒答;p4_control 73 支各红在点名断言上
(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状);编译门三臂 + 3 对照绿(chain_p29.txt)。

没擅自动的那一半:旧 NextRecordAsVector 档的去留——他预制里存的就是序号 0,删档或改默认都会改他画面上的东西,
三个选项与我的建议(迁到首尾相接)已回给他,等他定。
2026-10-26 20:26:49 +08:00

104 lines
5.5 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;
namespace XericUI.XChart
{
/// <summary>
/// 数据落在<b>显示范围之外</b>时怎么办(每个数据图元自己选,规范 §32)。
///
/// <para>显示范围的本分是"定标尺":它决定网格多大、轴刻度到哪儿。它<b>不该</b>顺手决定数据画不画——
/// 但历史上两件事不一致过:散点把值夹进盒子(超范围的点贴在盒壁上,看着像"数据到边就停"),
/// 而矢量/圆柱直接把值按比例投出去(可以跑到盒子外面)。同一张表两套口径,
/// 症状就是"散点看着钳制对了、别的组件钳制没做"(他 2026-10-26)。</para>
/// </summary>
public enum XChartValueOutOfRange
{
/// <summary>默认:不钳、不藏,按数据自己的值投(可以画到盒子外面)——"呈现自己准确的位置"。</summary>
RenderAsIs = 0,
/// <summary>夹到范围端点上(超出部分画在盒子边上)。</summary>
ClampToRange = 1,
/// <summary>整条记录隐藏(任何一轴越界就不画这一条)。</summary>
HideOutOfRange = 2,
}
/// <summary>
/// "值 → 盒子内比例"的<b>唯一</b>折法:三个数据图元(散点、矢量箭头、圆柱)都从这里取,
/// 于是"超范围怎么处理"只有一个答案,而不是每个元素各写一遍 Clamp/不 Clamp。
/// </summary>
public static class XChartCubeFoldMath
{
/// <summary>
/// 单轴折法:<c>0=该轴的下端点、1=上端点</c>,范围外按 <paramref name="behaviour"/> 办。
///
/// <para><b>返回 false 只有两种情况</b>:值或端点不是有限数(那是坏数据,宁可不画这条,也不要拿别的值顶替)、
/// 或者选了 <see cref="XChartValueOutOfRange.HideOutOfRange"/> 而这一轴越界。
/// <b>一整列同一个数(跨度 ≤0)不算坏</b>:答居中(0.5)——为这个把整张图弄没,
/// 是把"我还没钉范围"误报成"这里没有数据"(与 §25.1 的"需求 vs 现有"同一条精神)。</para>
/// </summary>
public static bool TryRatio01(double value, double minimum, double maximum,
XChartValueOutOfRange behaviour, out float ratio01)
{
ratio01 = 0.5f;
if (!IsFinite(value) || !IsFinite(minimum) || !IsFinite(maximum)) return false;
double span = maximum - minimum;
if (span <= 0d) return true;
double r = (value - minimum) / span;
if (r < 0d || r > 1d)
{
if (behaviour == XChartValueOutOfRange.HideOutOfRange) return false;
if (behaviour == XChartValueOutOfRange.ClampToRange) r = r < 0d ? 0d : 1d;
}
ratio01 = (float)r;
return true;
}
/// <summary>
/// 三轴一起折到 <b>立方体单位</b>([-1,1],±1 就是盒子边界)。
/// <b>全有或全无</b>:任何一轴要隐藏,这一条整体不画——只藏一半坐标的点
/// 会画出一个"在数据里不存在"的位置,那比少画一条糟得多。
/// </summary>
public static bool TryFoldCube(double x, double y, double z,
double minX, double maxX, double minY, double maxY, double minZ, double maxZ,
XChartValueOutOfRange behaviour, out Vector3 cube)
{
cube = Vector3.zero;
float nx, ny, nz;
if (!TryRatio01(x, minX, maxX, behaviour, out nx)
|| !TryRatio01(y, minY, maxY, behaviour, out ny)
|| !TryRatio01(z, minZ, maxZ, behaviour, out nz)) return false;
cube = new Vector3(nx * 2f - 1f, ny * 2f - 1f, nz * 2f - 1f);
return true;
}
/// <summary>
/// <b>方向(差)的折法</b>:<c>delta / (max − min)</c> —— <b>不减 min</b>。
///
/// <para>位置折的是"在这列数据里的位置",所以要先减起点;方向折的是"多长、朝哪",
/// 减起点会把一个朝向变成一个偏移量(全表 +50 之后所有箭头一起跑偏,而他改的只是单位)。
/// 也不吃 <see cref="XChartValueOutOfRange"/>:<b>钳制/隐藏是坐标的事</b>,
/// 方向只有"多长",把它夹到盒子尺寸等于替数据改方向。</para>
///
/// <para>跨度 ≤0 或非有限 ⇒ 拒答(这一档没有可用的尺度,画出来的长度只能是编的)。</para>
/// </summary>
public static bool TryFoldDelta(double dx, double dy, double dz,
double minX, double maxX, double minY, double maxY, double minZ, double maxZ,
out Vector3 cubeDelta)
{
cubeDelta = Vector3.zero;
double spanX = maxX - minX, spanY = maxY - minY, spanZ = maxZ - minZ;
if (!IsFinite(dx) || !IsFinite(dy) || !IsFinite(dz)) return false;
if (spanX <= 0d || spanY <= 0d || spanZ <= 0d) return false;
if (!IsFinite(spanX) || !IsFinite(spanY) || !IsFinite(spanZ)) return false;
// 一个跨度折成"一个盒子半径"(与位置那套同尺度:位置铺满 [-1,1],方向的一个跨度=2 个单位)
cubeDelta = new Vector3((float)(dx / spanX * 2d), (float)(dy / spanY * 2d), (float)(dz / spanZ * 2d));
return true;
}
private static bool IsFinite(double value)
=> !double.IsNaN(value) && !double.IsInfinity(value);
}
}