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:
2026-10-26 20:07:32 +08:00
parent 614a676dbf
commit f4a8df6dd7
11 changed files with 248 additions and 40 deletions
+30 -7
View File
@@ -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.###"))