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

122 lines
5.2 KiB
C#

using System;
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
using XericUI.XChart.Pseudo3D;
using XericUI.XChart.Space;
namespace XericUI.XChart.Space
{
/// <summary>
/// 散点元素的配置。数据默认<b>直接读图的数据源</b>(按维度下标 + 聚合范围归一化),
/// 所以配好三个维度下标就能出图,不需要在图表上为散点再写一遍数据。
///
/// <para>关掉 <see cref="m_AutoFromData"/> 就变成"脚本喂点"模式:由调用方
/// <c>SetCubePoints</c> 给立方体单位的点([-1,1] 就是盒子内部)。</para>
/// </summary>
[Serializable]
[XChartElement("scatter", "散点", 30)]
public sealed class XChartScatterConfig : XChartElementConfig
{
[Header("数据来源")]
[SerializeField, Tooltip("真=按下面的维度下标读图的数据源;假=脚本用 SetCubePoints 喂")]
private bool m_AutoFromData = true;
[SerializeField, Tooltip("X / Y / Z 轴取哪几个维度下标(绑定;显示范围在 chart 的数据板块逐维给)")]
private int m_DimensionX;
[SerializeField] private int m_DimensionY = 1;
[SerializeField] private int m_DimensionZ = 2;
[SerializeField, Tooltip("点云自己的变换(叠在图的空间之上)")]
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
[SerializeField, Min(0), Tooltip("桶采样目标点数:0 或 ≥ 记录数=不聚合;填了数就把记录按桶归约成这么多个点")]
private int m_BucketTargetPoints;
[SerializeField, Tooltip("桶内取哪个统计量当这个点:抽稀用 First/Last(不造新值),看趋势用 Mean/Median,看包络用 Minimum/Maximum")]
private XChartAggregateKind m_BucketReduce = XChartAggregateKind.Last;
[SerializeField, Tooltip("点落在显示范围之外时怎么办:原样画(默认,2026-10-26 起;以前散点总是夹住," +
"与矢量/圆柱不一致)/ 夹到范围端点 / 整条隐藏。颜色映射那一档总是夹(越界取端色)")]
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
[Header("外观")]
[SerializeField, Min(0.5f), Tooltip("点的大小(像素)")]
private float m_PointSize = 8f;
[SerializeField, Tooltip("图元类型")]
private PrimitiveType m_PointType = PrimitiveType.Polygon;
[SerializeField, Tooltip("图元边数(多边形时有效)")]
private int m_SideCount = 8;
[SerializeField, Tooltip("填充色")]
private Color m_PointColor = new Color(0.33f, 0.67f, 1f, 1f);
[SerializeField, Tooltip("中心色;与填充色不同就走径向渐变")]
private Color m_CenterColor = Color.white;
[SerializeField, Tooltip("边框色")]
private Color m_BorderColor = new Color(0.2f, 0.2f, 0.2f, 1f);
[SerializeField, Min(0f), Tooltip("边框宽度")]
private float m_BorderThickness = 1f;
[Header("按数值上色")]
[SerializeField, Tooltip("用某一维的数值做颜色渐变")]
private bool m_EnableColorMapping;
[SerializeField, Tooltip("拿哪一维的数值")]
private int m_ColorMapDimension = 2;
[SerializeField, Tooltip("范围下限对应颜色")]
private Color m_ColorMapMin = Color.blue;
[SerializeField, Tooltip("范围上限对应颜色")]
private Color m_ColorMapMax = Color.red;
public override string ElementName => "Scatter";
public override XChartToolBase CreateTool() => new ChartToolScatterPoints();
public override void ApplyTo(XChartToolBase tool)
{
if (!(tool is ChartToolScatterPoints scatter)) return;
scatter.AutoFromData = m_AutoFromData;
scatter.DimensionX = m_DimensionX;
scatter.DimensionY = m_DimensionY;
scatter.DimensionZ = m_DimensionZ;
scatter.Transform = m_Transform;
scatter.BucketTargetPoints = m_BucketTargetPoints;
scatter.BucketReduce = m_BucketReduce;
scatter.OutOfRange = m_OutOfRange;
scatter.PointSize = m_PointSize;
scatter.PointType = m_PointType;
scatter.SideCount = m_SideCount;
scatter.PointColor = m_PointColor;
scatter.CenterColor = m_CenterColor;
scatter.BorderColor = m_BorderColor;
scatter.BorderThickness = m_BorderThickness;
scatter.EnableColorMapping = m_EnableColorMapping;
scatter.ColorMapDimension = m_ColorMapDimension;
scatter.ColorMapMin = m_ColorMapMin;
scatter.ColorMapMax = m_ColorMapMax;
scatter.MarkDataDirty();
}
public override void CaptureFrom(XChartToolBase tool)
{
if (!(tool is ChartToolScatterPoints scatter)) return;
m_AutoFromData = scatter.AutoFromData;
m_PointSize = scatter.PointSize;
m_PointColor = scatter.PointColor;
m_Transform = scatter.Transform;
}
}
}