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

402 lines
20 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 XericLibrary.Runtime.UIGraph;
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
using XericUI.Core;
using XericUI.XChart.Mesh;
using XericUI.XChart.Space;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 散点元素:把 3D 数据点画进图的空间里。
///
/// <para><b>数据从哪儿来</b>:只认图表给的中转接口 <see cref="IXChartDataSource"/>
/// (<see cref="AutoFromData"/> 为真时按维度下标逐条取,范围用聚合量的 min/max)。
/// 元素不直接摸记录数组,所以以后要换桶/环形缓冲也不用改这里。
/// <see cref="AutoFromData"/> 为假时用脚本喂进来的 <see cref="SetCubePoints"/>(立方体单位)。</para>
///
/// <para><b>投影从哪儿来</b>:图里的 <see cref="ChartToolSpace"/>,和背景/线框/轴线<b>同一个</b>。
/// 所以"点落在盒子里"是结构保证——数据归一化到 [0,1] 再映到立方体局部 [-1,1],
/// 然后走和背景一样的 <c>基变换 ∘ 工具变换</c>。</para>
///
/// <para><b>什么时候重算</b>:数据版本号或空间版本号变了才重投影,其余帧什么都不做。</para>
///
/// 子节点结构:
/// [ScatterPoints]
/// └─ PointRenderer (XScatterPointRenderer)
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Scatter Points Tool")]
public class ChartToolScatterPoints : XChartToolBase
{
// ── 数据装配 ──────────────────────────────────────────────
private bool m_AutoFromData = true;
/// <summary>真=从图的数据源按维度下标读;假=用 <see cref="SetCubePoints"/> 喂的点</summary>
public bool AutoFromData { get => m_AutoFromData; set { m_AutoFromData = value; MarkDirty(); } }
private int m_DimensionX;
/// <summary>三个维度在数据源里的下标(绑定:点云画哪三路数据;范围归 chart 的维度行)</summary>
public int DimensionX { get => m_DimensionX; set { m_DimensionX = value; MarkDirty(); } }
private int m_DimensionY = 1;
public int DimensionY { get => m_DimensionY; set { m_DimensionY = value; MarkDirty(); } }
private int m_DimensionZ = 2;
public int DimensionZ { get => m_DimensionZ; set { m_DimensionZ = value; MarkDirty(); } }
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
/// <summary>点云自己的变换(立方体单位),用来把点整体缩进盒子里或挪一角</summary>
public XChartToolTransform Transform { get => m_Transform; set { m_Transform = value; MarkDirty(); } }
private int m_BucketTargetPoints;
/// <summary>
/// 桶采样目标点数:<c>0</c> 或 ≥ 记录数=不聚合;否则把记录按桶归约成这么多个点。
/// 目的是"几万条记录也只画 N 个点",同时让每个点代表它那一段时间。
/// </summary>
public int BucketTargetPoints { get => m_BucketTargetPoints; set { m_BucketTargetPoints = value; MarkDirty(); } }
private XChartAggregateKind m_BucketReduce = XChartAggregateKind.Last;
/// <summary>桶内取哪个统计量当这个点(抽稀 First/Last 不造新值;趋势 Mean/Median;包络 Minimum/Maximum)</summary>
public XChartAggregateKind BucketReduce { get => m_BucketReduce; set { m_BucketReduce = value; MarkDirty(); } }
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
/// <summary>
/// 数据落在显示范围之外时怎么办。<b>这一档从"夹住"改成了"原样画"(2026-10-26,§32)</b>:
/// 以前散点把超范围的点钉在盒壁上,看着像"数据到边就停",而矢量/圆柱是按比例投出去的——
/// 同一张表两幅画。要恢复旧观感就把这一档调成 <see cref="XChartValueOutOfRange.ClampToRange"/>。
/// </summary>
public XChartValueOutOfRange OutOfRange
{
get => m_OutOfRange;
set { m_OutOfRange = value; MarkDirty(); }
}
/// <summary>这一帧按策略隐掉了几个点(与"数据不可用"的坏值分开,§32)</summary>
public int HiddenCount => m_Hidden;
private int m_Hidden;
// ── 外观 ──────────────────────────────────────────────────
public float PointSize { get => m_PointSize; set { m_PointSize = Mathf.Max(0.5f, value); if (IsInitialized) SyncShapeParams(); } }
private float m_PointSize = 8f;
public PrimitiveType PointType { get => m_PointType; set { m_PointType = value; if (IsInitialized) SyncShapeParams(); } }
private PrimitiveType m_PointType = PrimitiveType.Polygon;
public SizeMode PointSizeMode { get => m_PointSizeMode; set { m_PointSizeMode = value; if (IsInitialized) SyncShapeParams(); } }
private SizeMode m_PointSizeMode = SizeMode.InscribedCircle;
public Color PointColor { get => m_PointColor; set { m_PointColor = value; if (IsInitialized) SyncShapeParams(); } }
private Color m_PointColor = new Color(0.33f, 0.67f, 1f, 1f);
public Color CenterColor { get => m_CenterColor; set { m_CenterColor = value; if (IsInitialized) SyncShapeParams(); } }
private Color m_CenterColor = Color.white;
public Color BorderColor { get => m_BorderColor; set { m_BorderColor = value; if (IsInitialized) SyncShapeParams(); } }
private Color m_BorderColor = new Color(0.2f, 0.2f, 0.2f, 1f);
public float BorderThickness { get => m_BorderThickness; set { m_BorderThickness = Mathf.Max(0f, value); if (IsInitialized) SyncShapeParams(); } }
private float m_BorderThickness = 1f;
public int SideCount { get => m_SideCount; set { m_SideCount = Mathf.Max(3, value); if (IsInitialized) SyncShapeParams(); } }
private int m_SideCount = 8;
public float ChamferSize { get => m_ChamferSize; set { m_ChamferSize = Mathf.Clamp01(value); if (IsInitialized) SyncShapeParams(); } }
private float m_ChamferSize;
public float PointAngle { get => m_PointAngle; set { m_PointAngle = value; if (IsInitialized) SyncShapeParams(); } }
private float m_PointAngle;
private bool m_EnableColorMapping;
/// <summary>按某一维的数值做颜色渐变</summary>
public bool EnableColorMapping { get => m_EnableColorMapping; set { m_EnableColorMapping = value; MarkDirty(); } }
private Color m_ColorMapMin = Color.blue;
public Color ColorMapMin { get => m_ColorMapMin; set { m_ColorMapMin = value; MarkDirty(); } }
private Color m_ColorMapMax = Color.red;
public Color ColorMapMax { get => m_ColorMapMax; set { m_ColorMapMax = value; MarkDirty(); } }
private int m_ColorMapDimension = 2;
/// <summary>拿哪一维的数值做映射</summary>
public int ColorMapDimension { get => m_ColorMapDimension; set { m_ColorMapDimension = value; MarkDirty(); } }
// ── 内部 ──────────────────────────────────────────────────
public XScatterPointRenderer PointRenderer { get; private set; }
private Matrix4x4 m_Composed = Matrix4x4.identity;
private Vector3[] m_CubePoints = new Vector3[0];
/// <summary>中位数归约用的暂存:长度按记录数上限,渲染路径里不分配</summary>
private double[] m_BucketScratch;
/// <summary>本帧桶数(=-1 表示还没算过);与源记录数一起进报表——"少画了多少"要能看到</summary>
private int m_BucketCount = -1;
private int m_SourceRecords;
private Vector2[] m_Projected = new Vector2[0];
private Color[] m_PointColors;
private float[] m_ColorValues;
private bool m_PointsDirty = true;
private long m_LastDataVersion = -1;
private int m_LastSpaceVersion = -1;
protected override void OnInitialize()
{
PointRenderer = CreateChildComponent<XScatterPointRenderer>("PointRenderer");
if (PointRenderer != null)
{
var rt = PointRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
SyncShapeParams();
}
private void SyncShapeParams()
{
if (PointRenderer == null) return;
PointRenderer.pointType = m_PointType;
PointRenderer.sizeMode = m_PointSizeMode;
PointRenderer.pointSize = m_PointSize;
PointRenderer.fillColor = m_PointColor;
PointRenderer.centerColor = m_CenterColor;
PointRenderer.borderColor = m_BorderColor;
PointRenderer.borderThickness = m_BorderThickness;
PointRenderer.sideCount = m_SideCount;
PointRenderer.chamferSize = m_ChamferSize;
PointRenderer.chamferSegments = 4;
PointRenderer.angle = m_PointAngle;
if (m_CubePoints.Length > 0) PointRenderer.UpdateShapeParams();
}
/// <summary>脚本喂点(立方体单位,[-1,1] 就是盒子内部)。配合 <see cref="AutoFromData"/>=false 用</summary>
public void SetCubePoints(Vector3[] cubePoints)
{
m_CubePoints = cubePoints ?? new Vector3[0];
m_Projected = new Vector2[m_CubePoints.Length];
m_PointColors = null;
m_ColorValues = null;
m_BucketCount = 0; // 脚本喂点这条路没有桶
m_SourceRecords = m_CubePoints.Length;
m_PointsDirty = true;
}
/// <summary>数据或变换变了(版本号比对才是真判据,这里只负责"再算一次")</summary>
public override void MarkDirty() => m_PointsDirty = true;
/// <summary>旧名字:这个工具里"数据脏"和"参数脏"是同一个字段,所以留一个字段、两个名字</summary>
public void MarkDataDirty() => MarkDirty();
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
{
base.OnRender();
if (PointRenderer == null) return;
var space = Context?.Space;
if (space == null) return;
bool spaceChanged = space.ProjectionVersion != m_LastSpaceVersion;
bool dataChanged = Data != null && Data.Version != m_LastDataVersion;
if (!m_PointsDirty && !spaceChanged && !dataChanged) return;
if (spaceChanged || dataChanged) m_PointsDirty = true;
m_LastSpaceVersion = space.ProjectionVersion;
m_LastDataVersion = Data != null ? Data.Version : -1;
m_Composed = space.Compose(Transform);
if (m_PointsDirty)
{
if (AutoFromData) BuildPointsFromDataSource(space);
RebuildProjection(space);
m_PointsDirty = false;
}
if (m_Projected.Length == 0)
{
PointRenderer.ClearAll();
return;
}
if (EnableColorMapping && m_PointColors != null) PointRenderer.SetPoints(m_Projected, m_PointColors);
else PointRenderer.SetPoints(m_Projected);
}
/// <summary>立方体单位点 → 图表局部像素</summary>
private void RebuildProjection(ChartToolSpace space)
{
if (m_Projected == null || m_Projected.Length != m_CubePoints.Length)
m_Projected = new Vector2[m_CubePoints.Length];
for (int i = 0; i < m_CubePoints.Length; i++)
m_Projected[i] = space.Project(m_CubePoints[i], m_Composed);
if (EnableColorMapping) ApplyColorMapping();
}
/// <summary>
/// 从数据源逐条取值,按每维范围归一化到 [0,1],再映到立方体局部 [-1,1]。
/// 范围优先用配置里给的手动范围,没给就用该维的聚合 min/max。
/// </summary>
private void BuildPointsFromDataSource(ChartToolSpace space)
{
var source = Data;
if (source == null || !source.HasData)
{
ClearPoints();
return;
}
int count = source.RecordCount;
// 桶采样:0 或 ≥ 记录数=不聚合(桶数就是记录数,行为与以前完全一致)
int buckets = XChartBucketMath.BucketCount(count, BucketTargetPoints);
m_BucketCount = buckets;
m_SourceRecords = count;
if (m_CubePoints.Length < buckets)
{
m_CubePoints = new Vector3[buckets];
m_Projected = new Vector2[buckets];
}
if (EnableColorMapping && (m_PointColors == null || m_PointColors.Length < buckets))
m_PointColors = new Color[buckets];
if (EnableColorMapping && (m_ColorValues == null || m_ColorValues.Length < buckets))
m_ColorValues = new float[buckets];
if (BucketReduce == XChartAggregateKind.Median && (m_BucketScratch == null || m_BucketScratch.Length < count))
m_BucketScratch = new double[count];
double minX, maxX, minY, maxY, minZ, maxZ;
ResolveRange(DimensionX, out minX, out maxX);
ResolveRange(DimensionY, out minY, out maxY);
m_Hidden = 0;
ResolveRange(DimensionZ, out minZ, out maxZ);
double colorMin, colorMax;
ResolveRange(ColorMapDimension, out colorMin, out colorMax);
int written = 0;
for (int b = 0; b < buckets; b++)
{
int first, end;
if (!XChartBucketMath.TryBucketRange(count, b, buckets, out first, out end)) continue;
double x, y, z;
if (!XChartBucketMath.TryReduce(source, DimensionX, first, end, BucketReduce, m_BucketScratch, out x)
|| !XChartBucketMath.TryReduce(source, DimensionY, first, end, BucketReduce, m_BucketScratch, out y)
|| !XChartBucketMath.TryReduce(source, DimensionZ, first, end, BucketReduce, m_BucketScratch, out z))
{
// 整桶坏值:这个桶不画,也不拿别的桶的值顶替(那会造出一个不在数据里的点)
continue;
}
// 坐标:折法与"超范围怎么办"走唯一那份(XChartCubeFoldMath)。
// 全有或全无——只夹一轴会画出一个"数据里不存在"的位置,所以 Hide 时整条不画并计数。
float fx, fy, fz;
if (!XChartCubeFoldMath.TryRatio01(x, minX, maxX, OutOfRange, out fx)
|| !XChartCubeFoldMath.TryRatio01(y, minY, maxY, OutOfRange, out fy)
|| !XChartCubeFoldMath.TryRatio01(z, minZ, maxZ, OutOfRange, out fz))
{
// 三个数都可用却被拒 ⇒ 是策略隐掉的;否则是坏数据(本来就不该画,另算)
if (!IsBad(x) && !IsBad(y) && !IsBad(z)) m_Hidden++;
continue;
}
m_CubePoints[written] = ChartToolSpace.NormalizedToCube(new Vector3(fx, fy, fz));
if (EnableColorMapping)
{
double color;
if (!XChartBucketMath.TryReduce(source, ColorMapDimension, first, end, BucketReduce, m_BucketScratch, out color))
continue;
// 颜色映射**不吃上面的开关**:越界的颜色取端色是常态(clamp),
// "隐藏超出范围的点"是坐标的事,不该把颜色梯度也变成洞
m_ColorValues[written] = Normalize(color, colorMin, colorMax);
}
written++;
}
if (written != m_CubePoints.Length) TrimPoints(written);
}
private void ClearPoints()
{
m_CubePoints = new Vector3[0];
m_Projected = new Vector2[0];
m_PointColors = null;
m_ColorValues = null;
m_BucketCount = 0;
m_SourceRecords = 0;
}
/// <summary>
/// 只保留前 <paramref name="count"/> 个点:渲染器<b>按数组长度</b>提交,
/// 不裁掉尾巴就会画出一批"上一轮的旧点"。
/// </summary>
private void TrimPoints(int count)
{
System.Array.Resize(ref m_CubePoints, count);
System.Array.Resize(ref m_Projected, count);
if (m_PointColors != null) System.Array.Resize(ref m_PointColors, count);
if (m_ColorValues != null) System.Array.Resize(ref m_ColorValues, count);
}
/// <summary>
/// 显示范围只问上下文要(覆盖优先、否则该维聚合;规则在 <see cref="XChartDomainMath"/>)。
/// <b>范围本身归 chart 的维度行</b>(数据板块),元素只说要哪一维——
/// 元素自己再存一份范围就是"点和轴对不上"的来路。
/// </summary>
private void ResolveRange(int dimension, out double min, out double max)
{
var context = Context;
if (context != null && context.TryResolveDomain(dimension, out min, out max)) return;
min = 0.0;
max = 1.0;
}
private static float Normalize(double value, double min, double max)
{
double span = max - min;
if (span <= 0.0) return 0.5f;
return Mathf.Clamp01((float)((value - min) / span));
}
/// <summary>坏数据(非有限)与"按策略隐藏"要分得开:前者是数据不可用,后者是我们主动不画</summary>
private static bool IsBad(double value)
=> double.IsNaN(value) || double.IsInfinity(value);
private void ApplyColorMapping()
{
if (m_ColorValues == null || m_PointColors == null) return;
for (int i = 0; i < m_PointColors.Length && i < m_ColorValues.Length; i++)
m_PointColors[i] = Color.Lerp(ColorMapMin, ColorMapMax, m_ColorValues[i]);
}
protected override void OnDispose()
{
PointRenderer = null;
m_CubePoints = null;
m_Projected = null;
m_PointColors = null;
m_ColorValues = null;
}
#if UNITY_EDITOR
/// <summary>报表里点名这个组件这一帧提交了多少顶点——按点数长网格的元素靠它自证没撞 65535</summary>
internal override void AppendDebugLine(System.Text.StringBuilder sb)
{
base.AppendDebugLine(sb);
sb.Append(" points=").Append(m_CubePoints != null ? m_CubePoints.Length : 0)
.Append(" pointVerts=").Append(PointRenderer != null ? PointRenderer.LiveVertexCount : 0)
// 桶采样读数:画了几个点、源有多少条、取的是哪个统计量——"少画了多少"必须能看到
.Append(" buckets=").Append(m_BucketCount)
.Append(" records=").Append(m_SourceRecords)
.Append(" reduce=").Append(BucketReduce)
// 超范围的两类"少画"分开印:hidden=策略隐的,out=这一档选的是什么(§32)
.Append(" hidden=").Append(m_Hidden)
.Append(" out=").Append(OutOfRange.ToString().ToLower());
}
#endif
}
}