Files
XericUIActionVessel/Runtime/XChart/XChartCubeFoldMath.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

79 lines
3.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;
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;
}
private static bool IsFinite(double value)
=> !double.IsNaN(value) && !double.IsInfinity(value);
}
}