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,删除或改默认都会改他画面)——三个选项与我的建议(把它迁到首尾相接)已回给他。 覆盖不到的:画到盒外的点会不会被别的东西挡住、"默认钳还是默认原样"好不好看,归他现场判。
This commit is contained in:
@@ -68,6 +68,14 @@ namespace XericUI.XChart.Mesh
|
||||
/// <summary>最多画几根</summary>
|
||||
public int MaxCylinders { get => m_MaxCylinders; set { m_MaxCylinders = value; MarkDirty(); } }
|
||||
|
||||
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
|
||||
/// <summary>数据落在显示范围之外时怎么办(默认原样画,§32);隐藏是<b>整根</b>不画,不画一半坐标</summary>
|
||||
public XChartValueOutOfRange OutOfRange
|
||||
{
|
||||
get => m_OutOfRange;
|
||||
set { m_OutOfRange = value; MarkDirty(); }
|
||||
}
|
||||
|
||||
// ── 呈现(各有开关) ──────────────────────────────────────
|
||||
|
||||
private bool m_ShowOutline = true;
|
||||
@@ -378,11 +386,12 @@ namespace XericUI.XChart.Mesh
|
||||
return false;
|
||||
|
||||
float x, y, z;
|
||||
if (!XChartBindingMath.TryNormalize(raw.x, minX, maxX, out x)
|
||||
|| !XChartBindingMath.TryNormalize(raw.y, minY, maxY, out y)
|
||||
|| !XChartBindingMath.TryNormalize(raw.z, minZ, maxZ, out z)) return false;
|
||||
// 折法与"超范围怎么办"只有一处定义(XChartCubeFoldMath),散点/矢量/圆柱同源(§32)
|
||||
if (!XChartCubeFoldMath.TryRatio01(raw.x, minX, maxX, OutOfRange, out x)
|
||||
|| !XChartCubeFoldMath.TryRatio01(raw.y, minY, maxY, OutOfRange, out y)
|
||||
|| !XChartCubeFoldMath.TryRatio01(raw.z, minZ, maxZ, OutOfRange, out z)) return false;
|
||||
|
||||
unit = new Vector3(x, y, z);
|
||||
unit = new Vector3(x * 2f - 1f, y * 2f - 1f, z * 2f - 1f);
|
||||
return true;
|
||||
}
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ namespace XericUI.XChart.Mesh
|
||||
/// <summary>
|
||||
/// 向量场 / 流形箭头元素。<b>数据口径(规范 §25.2,2026-10-25 他澄清后定稿)</b>:
|
||||
/// <b>前三维=坐标 x/y/z</b>(与圆柱、散点同一套归一化,折法见
|
||||
/// <see cref="XChartVectorFieldMath.TryCubePoint"/> 与 §28),<b>一支箭头=相邻两条记录</b>
|
||||
/// <see cref="XChartCubeFoldMath.TryFoldCube"/> 与 §28/§32),<b>一支箭头=相邻两条记录</b>
|
||||
/// (第 i 条是起点,第 i+1 条按 <see cref="DirectionSource"/> 解释成"第二个点"或"方向矢量"),
|
||||
/// <b>第 4~7 维是颜色</b>(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,可选)。
|
||||
///
|
||||
@@ -55,6 +55,17 @@ namespace XericUI.XChart.Mesh
|
||||
/// <summary>箭头自己的变换(叠在图的空间之上)</summary>
|
||||
public XChartToolTransform Transform { get => m_Transform; set { m_Transform = value; MarkDirty(); } }
|
||||
|
||||
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
|
||||
/// <summary>
|
||||
/// 数据落在显示范围之外时怎么办(默认<b>原样画</b>——显示范围的本分是定标尺,不是决定数据画不画,§32)。
|
||||
/// <see cref="XChartValueOutOfRange.HideOutOfRange"/> 是整条记录不画(不是只藏越轴的那一半)。
|
||||
/// </summary>
|
||||
public XChartValueOutOfRange OutOfRange
|
||||
{
|
||||
get => m_OutOfRange;
|
||||
set { m_OutOfRange = value; MarkDirty(); }
|
||||
}
|
||||
|
||||
// ── 颜色:可选的三到四个数值维 ────────────────────────────
|
||||
|
||||
private bool m_UseColorDimensions;
|
||||
@@ -132,6 +143,8 @@ namespace XericUI.XChart.Mesh
|
||||
private int m_DimensionsNeed;
|
||||
private int m_RecordsHave;
|
||||
private int m_PointsSkipped;
|
||||
// 坏数据(非有限)与"按策略隐藏"是两件事:前者是数据不可用,后者是我们主动不画(§32)
|
||||
private int m_PointsHidden;
|
||||
|
||||
// 三条坐标轴各自的显示范围(每帧现问上下文要:覆盖优先、否则该维聚合)。
|
||||
// 数据值必须经它们折成立方体单位才投影——直接当立方体单位用会把整场箭头投到盒子外面(§28)
|
||||
@@ -217,6 +230,7 @@ namespace XericUI.XChart.Mesh
|
||||
m_DimensionsHave = 0;
|
||||
m_RecordsHave = 0;
|
||||
m_PointsSkipped = 0;
|
||||
m_PointsHidden = 0;
|
||||
m_DimensionsNeed = RequiredDimensionCount;
|
||||
m_HasDomains = false;
|
||||
|
||||
@@ -445,7 +459,7 @@ namespace XericUI.XChart.Mesh
|
||||
|
||||
/// <summary>
|
||||
/// 一条记录的第 <c>offset~offset+2</c> 维(相对坐标起点)→ <b>立方体单位</b>的点:原始值先按各维
|
||||
/// 范围折进 [-1,1] 再投影(折法在纯算术里,离线钉着:<see cref="XChartVectorFieldMath.TryCubePoint"/>)。
|
||||
/// 范围折进 [-1,1] 再投影(折法与"超范围怎么办"在纯算术里,离线钉着:<see cref="XChartCubeFoldMath"/>)。
|
||||
/// 折不出来(值非有限、或那一维跨度为 0)就返回 false,调用方计入 <c>skipped=</c>——
|
||||
/// <b>不是"静默少一支",是"少几支当场说"</b>。
|
||||
/// </summary>
|
||||
@@ -454,13 +468,20 @@ namespace XericUI.XChart.Mesh
|
||||
cube = Vector3.zero;
|
||||
if (record < 0 || record >= m_RecordsHave) return false;
|
||||
int dim = CoordinateDimension + offset;
|
||||
return XChartVectorFieldMath.TryCubePoint(
|
||||
source.GetValueAt(record, dim),
|
||||
source.GetValueAt(record, dim + 1),
|
||||
source.GetValueAt(record, dim + 2),
|
||||
m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ, out cube);
|
||||
double x = source.GetValueAt(record, dim);
|
||||
double y = source.GetValueAt(record, dim + 1);
|
||||
double z = source.GetValueAt(record, dim + 2);
|
||||
if (XChartCubeFoldMath.TryFoldCube(x, y, z,
|
||||
m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ, OutOfRange, out cube)) return true;
|
||||
// 分得清"数据不可用"与"按策略主动不画":两者在画面上同形(都少一支),只有这一对数分得开
|
||||
if (IsBad(x) || IsBad(y) || IsBad(z)) m_PointsSkipped++; else m_PointsHidden++;
|
||||
cube = Vector3.zero;
|
||||
return false;
|
||||
}
|
||||
|
||||
private static bool IsBad(double value)
|
||||
=> double.IsNaN(value) || double.IsInfinity(value);
|
||||
|
||||
/// <summary>
|
||||
/// 一条记录的三个<b>原始</b>值(方向用):<b>不折进盒子、不位移</b>——方向是矢量,
|
||||
/// 拿位置的显示范围去折它就是把"朝哪"变成"在哪"。这里只保证三个数都是有限数,
|
||||
@@ -533,6 +554,8 @@ namespace XericUI.XChart.Mesh
|
||||
: "-")
|
||||
.Append(" arrows=").Append(m_ArrowsBuilt)
|
||||
.Append(" skipped=").Append(m_PointsSkipped)
|
||||
.Append(" hidden=").Append(m_PointsHidden)
|
||||
.Append(" out=").Append(OutOfRange.ToString().ToLower())
|
||||
.Append(" src=").Append(Continuous ? "continuous" : DirectionSource.ToString().ToLower())
|
||||
.Append(" anchor=").Append(MarkerAnchor.ToString("0.###"))
|
||||
.Append(" headScale=").Append(m_HeadScale.ToString("0.###"))
|
||||
|
||||
@@ -62,32 +62,9 @@ namespace XericUI.XChart.Mesh
|
||||
/// </summary>
|
||||
public static class XChartVectorFieldMath
|
||||
{
|
||||
/// <summary>
|
||||
/// 一条记录的原始三值 → <b>立方体单位</b>:每一维按<b>它自己的显示范围</b>映到 [-1,1]
|
||||
/// (±1 就是盒子边界),与散点、圆柱走的是同一套(<see cref="XChartBindingMath.TryNormalize"/>)。
|
||||
///
|
||||
/// <para><b>为什么单独有这么一个函数</b>:箭头以前把数据值<b>直接当成立方体单位</b>用了,
|
||||
/// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有
|
||||
/// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归,
|
||||
/// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。</para>
|
||||
///
|
||||
/// <para><b>任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答</b>——
|
||||
/// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。</para>
|
||||
/// </summary>
|
||||
public static bool TryCubePoint(double x, double y, double z,
|
||||
double minX, double maxX, double minY, double maxY, double minZ, double maxZ,
|
||||
out Vector3 cube)
|
||||
{
|
||||
cube = Vector3.zero;
|
||||
|
||||
float nx, ny, nz;
|
||||
if (!XChartBindingMath.TryNormalize(x, minX, maxX, out nx)
|
||||
|| !XChartBindingMath.TryNormalize(y, minY, maxY, out ny)
|
||||
|| !XChartBindingMath.TryNormalize(z, minZ, maxZ, out nz)) return false;
|
||||
|
||||
cube = new Vector3(nx, ny, nz);
|
||||
return true;
|
||||
}
|
||||
// "数据值 → 立方体单位(以及超出显示范围怎么办)"<b>不在这里</b>:散点、矢量、圆柱都要同一套折法,
|
||||
// 收在 XChartCubeFoldMath(§32)。两处各写一遍就出现过"散点把点夹在盒壁上、矢量却画到盒外"——
|
||||
// 同一张表两幅画,而且两边都"看着挺对"。
|
||||
|
||||
/// <summary>
|
||||
/// 三角形头。<paramref name="progress"/> 与 <paramref name="anchorOnPoint"/> 都夹进 [0,1];
|
||||
|
||||
@@ -32,6 +32,10 @@ namespace XericUI.XChart.Mesh
|
||||
[SerializeField, Min(1), Tooltip("最多画几根(记录多时按组数上限截断,报表会点名截了多少)")]
|
||||
private int m_MaxCylinders = 64;
|
||||
|
||||
[SerializeField, Tooltip("数据落在显示范围之外时怎么办:原样画(默认)/ 夹到范围端点 / 整根隐藏。" +
|
||||
"显示范围的本分是定标尺(网格多大、轴到哪儿),不该顺手决定数据画不画")]
|
||||
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
|
||||
|
||||
[SerializeField, Min(0.001f), Tooltip("半径(立方体单位)")]
|
||||
private float m_Radius = 0.22f;
|
||||
[SerializeField, Range(8, 256), Tooltip("一圈分多少段(轮廓与十字的采样精度)")]
|
||||
@@ -85,6 +89,7 @@ namespace XericUI.XChart.Mesh
|
||||
cylinder.DimensionZ = m_DimensionZ;
|
||||
cylinder.GroupSize = m_GroupSize;
|
||||
cylinder.MaxCylinders = m_MaxCylinders;
|
||||
cylinder.OutOfRange = m_OutOfRange;
|
||||
cylinder.Radius = m_Radius;
|
||||
cylinder.SegmentCount = m_SegmentCount;
|
||||
cylinder.StartNormal = m_StartNormal;
|
||||
@@ -169,6 +174,11 @@ namespace XericUI.XChart.Mesh
|
||||
[SerializeField, Tooltip("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")]
|
||||
private float m_DirectionScale = 0.25f;
|
||||
|
||||
[SerializeField, Tooltip("数据落在显示范围之外时怎么办:原样画(默认——显示范围只管定标尺," +
|
||||
"不该决定数据画不画)/ 夹到范围端点 / 整条隐藏。" +
|
||||
"隐藏与\"数据不可用\"分得开:报表里 hidden= 与 skipped= 是两个数")]
|
||||
private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs;
|
||||
|
||||
[SerializeField, Range(0, 100000), Tooltip("最多画多少支(0=不限);防止十万条记录一口气铺满")]
|
||||
private int m_MaxArrowCount = 512;
|
||||
|
||||
@@ -245,6 +255,7 @@ namespace XericUI.XChart.Mesh
|
||||
arrows.PathSegments = m_PathSegments;
|
||||
arrows.DirectionScale = m_DirectionScale;
|
||||
arrows.MaxArrowCount = m_MaxArrowCount;
|
||||
arrows.OutOfRange = m_OutOfRange;
|
||||
arrows.Transform = m_Transform;
|
||||
|
||||
arrows.UseColorDimensions = m_UseColorDimensions;
|
||||
|
||||
@@ -57,6 +57,22 @@ namespace XericUI.XChart.Pseudo3D
|
||||
/// <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(); } }
|
||||
@@ -255,6 +271,7 @@ namespace XericUI.XChart.Pseudo3D
|
||||
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);
|
||||
@@ -274,14 +291,26 @@ namespace XericUI.XChart.Pseudo3D
|
||||
continue;
|
||||
}
|
||||
|
||||
m_CubePoints[written] = ChartToolSpace.NormalizedToCube(new Vector3(
|
||||
Normalize(x, minX, maxX), Normalize(y, minY, maxY), Normalize(z, minZ, maxZ)));
|
||||
// 坐标:折法与"超范围怎么办"走唯一那份(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++;
|
||||
@@ -332,6 +361,10 @@ namespace XericUI.XChart.Pseudo3D
|
||||
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;
|
||||
@@ -358,7 +391,10 @@ namespace XericUI.XChart.Pseudo3D
|
||||
// 桶采样读数:画了几个点、源有多少条、取的是哪个统计量——"少画了多少"必须能看到
|
||||
.Append(" buckets=").Append(m_BucketCount)
|
||||
.Append(" records=").Append(m_SourceRecords)
|
||||
.Append(" reduce=").Append(BucketReduce);
|
||||
.Append(" reduce=").Append(BucketReduce)
|
||||
// 超范围的两类"少画"分开印:hidden=策略隐的,out=这一档选的是什么(§32)
|
||||
.Append(" hidden=").Append(m_Hidden)
|
||||
.Append(" out=").Append(OutOfRange.ToString().ToLower());
|
||||
}
|
||||
#endif
|
||||
}
|
||||
|
||||
@@ -36,6 +36,10 @@ namespace XericUI.XChart.Space
|
||||
[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;
|
||||
@@ -86,6 +90,7 @@ namespace XericUI.XChart.Space
|
||||
scatter.Transform = m_Transform;
|
||||
scatter.BucketTargetPoints = m_BucketTargetPoints;
|
||||
scatter.BucketReduce = m_BucketReduce;
|
||||
scatter.OutOfRange = m_OutOfRange;
|
||||
|
||||
scatter.PointSize = m_PointSize;
|
||||
scatter.PointType = m_PointType;
|
||||
|
||||
@@ -0,0 +1,78 @@
|
||||
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);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
fileFormatVersion: 2
|
||||
guid: debeb5aedeacb4b47ba8ea795208068b
|
||||
MonoImporter:
|
||||
externalObjects: {}
|
||||
serializedVersion: 2
|
||||
defaultReferences: []
|
||||
executionOrder: 0
|
||||
icon: {instanceID: 0}
|
||||
userData:
|
||||
assetBundleName:
|
||||
assetBundleVariant:
|
||||
Reference in New Issue
Block a user