按他 2026-10-25 的澄清(规范 §24.5 / §25 已先改对): - **序号不再是给人设的**:标题行 `R… D…` 改成文本读数(就地刷新);Body 里不再有任何序号输入控件。 新增 `RenumberDrawOrder()`:任何结构变化(上移/下移/加/删)之后把每个元素的 `m_DrawOrder` 重写成它在表里的位置 ⇒ **位置更靠后=绘得更晚=盖在上面**,位置是唯一权威; 注册序由类型定死,只显示。↑↓ 的 tooltip 也改成讲层序。 - **矢量场数据口径改对**:前三维=坐标 x/y/z(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录** (第 i 条起点、第 i+1 条按绝对/相对解释)、**第 4~7 维=颜色**(色相 0..256 色环 / 饱和 / 明度 / 不透明, 全可选)。需求印**三个数**(需要几个数值维 / 需要几条记录 / 表里各有多少)—— "记录不够"与"维数不够"在画面上同形,只有这三个数分得清。 - 支数由纯算术 `XChartVectorFieldMath.ArrowCount(记录数, 上限)` 算(N 条 ⇒ N−1 支,上限裁剪,<2 条 ⇒ 0)。 - **两端各自颜色**:杆用起点色、头用终点色(读两条记录各自的颜色维);沿杆逐顶点渐变留给 P18。 - 生成器 `螺旋矢量场` 改成 **7 维**(坐标 + 色相走满一圈 + 饱和/明度/不透明),自己补列。 判据:编译门三臂 + 3 对照绿;探针 **439** 项 0 失败(新增支数一族); `p4_control` **57/57** 支臂各红在点名断言上(新增两支:一对不再花两条记录、空表不挡而直接进算术); `p2` / `family` / `generator_gate` / `hierarchy_gate` 在同一棵交付树上复跑全绿。 过程记录:第一版给"一对不再花两条记录"点名的清单里放了一条**被更前面的守卫挡住、这支变异体碰不到** 的判据,`did not go red` 当场抓出来 ⇒ 按实测改清单,并给零/一条记录补了它自己那支变异体(§25.7)。
308 lines
15 KiB
C#
308 lines
15 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using UnityEngine;
|
||
using XericLibrary.Runtime.UIGraph;
|
||
using XericUI.Core;
|
||
using XericUI.XChart.Space;
|
||
|
||
namespace XericUI.XChart.Mesh
|
||
{
|
||
/// <summary>
|
||
/// 向量场 / 流形箭头元素。**数据口径(规范 §25.2,2026-10-25 他澄清后定稿)**:
|
||
/// <b>前三维=坐标 x/y/z</b>(与圆柱、散点同一套归一化),<b>一支箭头=相邻两条记录</b>
|
||
/// (第 i 条是起点,第 i+1 条按 <see cref="VectorMode"/> 解释成"第二个点"或"方向矢量"),
|
||
/// <b>第 4~7 维是颜色</b>(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,可选)。
|
||
///
|
||
/// <para><b>两种读法</b>:绝对 ⇒ 第二条记录的坐标就是方向(起点 + 方向×倍率),螺旋点画出来是一片"刺猬";
|
||
/// 相对 ⇒ 它是第二个点(起点 + 差向量×倍率),一串首尾相接的点读起来就是"连着头转"。</para>
|
||
///
|
||
/// <para><b>连续绘制</b>:把每条记录的坐标按顺序连成折线(只有最后一段带箭头);
|
||
/// 这时"相对/绝对"不适用 ⇒ 配置里那一项隐藏(互斥显示)。</para>
|
||
///
|
||
/// <para><b>两端各自的颜色</b>:起点读第 i 条记录、终点读第 i+1 条 ⇒ 两支记录颜色不同时,
|
||
/// 杆与头**各显一色**。真正的"沿杆逐顶点渐变"要等渲染器支持逐顶点双色(P18)。</para>
|
||
///
|
||
/// <para><b>箭头是自己拼的,没有用库里的 ArrowShape</b>:那套箭头是给曲线的屏幕空间图元用的,
|
||
/// 而这里的箭头必须跟着立方体姿态走(投影后长短和方向都在变)。做法是只让空间负责两端的投影,
|
||
/// 杆和头都在<b>像素空间</b>里量出来:杆是一段等宽四边形,头是一个退化四边形(三角形),
|
||
/// 宽度恒定所以任何姿态下都不会塌成一条线。</para>
|
||
///
|
||
/// <para><b>数据只经过中转接口</b>:按维度下标 <see cref="IXChartDataSource.GetValueAt"/> 逐条取,
|
||
/// 不碰记录数组;支数由 <see cref="MaxArrowCount"/> 兜住,免得十万条记录一口气投影。</para>
|
||
/// </summary>
|
||
[AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Vector Arrow Tool")]
|
||
public sealed class ChartToolVectorArrows : XChartToolBase
|
||
{
|
||
/// <summary>坐标的维度下标(x/y/z 三维)</summary>
|
||
public int CoordinateDimension { get; set; }
|
||
/// <summary>第二条记录怎么读成方向</summary>
|
||
public XChartArrowVectorMode VectorMode { get; set; } = XChartArrowVectorMode.Absolute;
|
||
/// <summary>把每条记录的坐标按顺序连成折线(此时相对/绝对不适用)</summary>
|
||
public bool Continuous { get; set; }
|
||
/// <summary>方向向量的长度倍率(立方体单位);相对模式下作用在差向量上</summary>
|
||
public float DirectionScale { get; set; } = 0.25f;
|
||
/// <summary>最多画多少支(一支=相邻两条记录)</summary>
|
||
public int MaxArrowCount { get; set; } = 512;
|
||
|
||
/// <summary>箭头自己的变换(叠在图的空间之上)</summary>
|
||
public XChartToolTransform Transform { get; set; } = XChartToolTransform.Identity;
|
||
|
||
// ── 颜色:可选的三到四个数值维 ────────────────────────────
|
||
|
||
/// <summary>是否用额外的数值维给每支箭头上色</summary>
|
||
public bool UseColorDimensions { get; set; }
|
||
/// <summary>颜色维的起点(色相、饱和度、明度 [+不透明度])</summary>
|
||
public int ColorDimension { get; set; } = 3;
|
||
/// <summary>是否多读一维不透明度</summary>
|
||
public bool HasAlphaDimension { get; set; }
|
||
|
||
public Color ArrowColor { get; set; } = new Color(0.95f, 0.6f, 0.25f, 0.9f);
|
||
public float ShaftWidth { get; set; } = 2f;
|
||
public float HeadLength { get; set; } = 10f;
|
||
public float HeadWidth { get; set; } = 7f;
|
||
/// <summary>方向为零向量时什么都不画;给个数就画成一个点</summary>
|
||
public bool ShowZeroVectorsAsDots { get; set; }
|
||
|
||
public XChartMeshFillRenderer FillRenderer { get; private set; }
|
||
|
||
private Matrix4x4 m_Composed = Matrix4x4.identity;
|
||
private int m_LastSpaceVersion = -1;
|
||
private long m_LastDataVersion = -1;
|
||
private bool m_Dirty = true;
|
||
|
||
private readonly List<ArrowFace> m_Faces = new List<ArrowFace>(256);
|
||
|
||
// 本帧的自述读数:算了几支 / 表里几个数值维 / 需要几个 / 几条记录
|
||
private int m_ArrowsBuilt;
|
||
private int m_DimensionsHave;
|
||
private int m_DimensionsNeed;
|
||
private int m_RecordsHave;
|
||
|
||
private struct ArrowFace
|
||
{
|
||
public Vector2 A;
|
||
public Vector2 B;
|
||
public Vector2 C;
|
||
public Vector2 D;
|
||
public float Depth;
|
||
public Color Color;
|
||
}
|
||
|
||
private static readonly Comparison<ArrowFace> s_FarToNear =
|
||
(left, right) => left.Depth.CompareTo(right.Depth);
|
||
|
||
public void MarkDirty() => m_Dirty = true;
|
||
|
||
/// <summary>
|
||
/// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。
|
||
/// <b>不透明度那一维不算硬需求</b>:多给就多读、没给退回单色 alpha——
|
||
/// 把它算进门槛的话,勾一下"有不透明度"会让整个元素突然一条都不画,
|
||
/// 那是把这一个开关变成了总闸。
|
||
/// </summary>
|
||
public int RequiredDimensionCount
|
||
=> XChartArrowConfig.CoordinateDimensionCount + (UseColorDimensions ? XChartArrowConfig.ColorDimensionCount : 0);
|
||
|
||
/// <summary>一支箭头要两条记录</summary>
|
||
public int RequiredRecordCount => 2;
|
||
|
||
protected override void OnInitialize()
|
||
{
|
||
FillRenderer = CreateChildComponent<XChartMeshFillRenderer>("ArrowFill");
|
||
if (FillRenderer != null)
|
||
{
|
||
var rect = FillRenderer.rectTransform;
|
||
rect.anchorMin = Vector2.zero;
|
||
rect.anchorMax = Vector2.one;
|
||
rect.offsetMin = Vector2.zero;
|
||
rect.offsetMax = Vector2.zero;
|
||
}
|
||
SetVisible(true);
|
||
}
|
||
|
||
public override void OnRender()
|
||
{
|
||
base.OnRender();
|
||
if (FillRenderer == null) return;
|
||
|
||
var space = Context?.Space;
|
||
if (space == null) return;
|
||
|
||
long dataVersion = Data != null ? Data.Version : -1;
|
||
if (!m_Dirty && space.ProjectionVersion == m_LastSpaceVersion && dataVersion == m_LastDataVersion)
|
||
return;
|
||
|
||
m_Dirty = false;
|
||
m_LastSpaceVersion = space.ProjectionVersion;
|
||
m_LastDataVersion = dataVersion;
|
||
m_Composed = space.Compose(Transform);
|
||
|
||
BuildFaces(space);
|
||
|
||
FillRenderer.ClearFaces();
|
||
for (int i = 0; i < m_Faces.Count; i++)
|
||
{
|
||
ArrowFace face = m_Faces[i];
|
||
FillRenderer.AddFace(face.A, face.B, face.C, face.D, face.Color, face.Color);
|
||
}
|
||
FillRenderer.Apply();
|
||
}
|
||
|
||
private void BuildFaces(ChartToolSpace space)
|
||
{
|
||
m_Faces.Clear();
|
||
m_ArrowsBuilt = 0;
|
||
m_DimensionsHave = 0;
|
||
m_RecordsHave = 0;
|
||
m_DimensionsNeed = RequiredDimensionCount;
|
||
|
||
var source = Data;
|
||
if (source == null || !source.HasData) return;
|
||
|
||
m_DimensionsHave = source.NumericDimensionCount;
|
||
m_RecordsHave = source.RecordCount;
|
||
// 形状不够就一支都不画(现象是"加了工具但什么都没显示")——需求与实际几个数都留在报表里,
|
||
// 面板也印同一对(规范 §25.1)
|
||
if (m_DimensionsHave < CoordinateDimension + RequiredDimensionCount) return;
|
||
if (m_RecordsHave < RequiredRecordCount) return;
|
||
|
||
// 一支箭头=相邻两条记录 ⇒ 支数由纯算术算(离线钉着:记录不够 vs 维数不够要分得清)
|
||
int limit = XChartVectorFieldMath.ArrowCount(m_RecordsHave, MaxArrowCount);
|
||
|
||
if (Continuous)
|
||
{
|
||
BuildContinuous(source, space, limit);
|
||
m_Faces.Sort(s_FarToNear);
|
||
return;
|
||
}
|
||
|
||
for (int i = 0; i < limit; i++)
|
||
{
|
||
Vector3 first = ReadPoint(source, i);
|
||
Vector3 second = ReadPoint(source, i + 1);
|
||
// 两种读法的算式在纯算术里(离线钉着):绝对=第二条的坐标就是方向;相对=它是第二个点
|
||
Vector3 tip = XChartVectorFieldMath.Tip(VectorMode, first, second, DirectionScale);
|
||
if (AddArrow(space, first, tip, ColorAt(source, i), ColorAt(source, i + 1))) m_ArrowsBuilt++;
|
||
}
|
||
|
||
m_Faces.Sort(s_FarToNear);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 连续绘制:把每条记录的坐标按顺序连成折线,<b>只有最后一段带箭头</b>。
|
||
/// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了)。
|
||
/// </summary>
|
||
private void BuildContinuous(IXChartDataSource source, ChartToolSpace space, int limit)
|
||
{
|
||
if (limit < 1) return;
|
||
|
||
Vector3 previous = ReadPoint(source, 0);
|
||
for (int i = 1; i <= limit; i++)
|
||
{
|
||
Vector3 current = ReadPoint(source, i);
|
||
bool last = i == limit;
|
||
// 段用"到达点"的颜色(最后一段的箭头用终点色):一串颜色维读下来就是沿路径渐变
|
||
AddArrow(space, previous, current, ColorAt(source, i - 1), ColorAt(source, i), last);
|
||
m_ArrowsBuilt++;
|
||
previous = current;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 一支箭头 = 杆(用起点色)+(可选)头(用终点色)。
|
||
/// <b>两端各显一色</b>是颜色维"随记录自带"的直接结果;真正的沿杆渐变要等渲染器支持逐顶点双色(P18)。
|
||
/// </summary>
|
||
private bool AddArrow(ChartToolSpace space, Vector3 origin, Vector3 tip, Color startColor, Color endColor,
|
||
bool withHead = true)
|
||
{
|
||
Vector2 from = space.Project(origin, m_Composed);
|
||
Vector2 to = space.Project(tip, m_Composed);
|
||
float depth = (space.DepthOf(origin, m_Composed) + space.DepthOf(tip, m_Composed)) * 0.5f;
|
||
|
||
Vector2 shaftA, shaftB, shaftC, shaftD, headA, headB, headC, headD;
|
||
if (!XChartArrowGeometry.TryBuild(from, to, ShaftWidth, HeadLength, HeadWidth,
|
||
out shaftA, out shaftB, out shaftC, out shaftD, out headA, out headB, out headC, out headD))
|
||
{
|
||
if (!ShowZeroVectorsAsDots) return false;
|
||
// 退化箭头:画一个极小的四边形,宽度至少一个像素,否则整条向量看不见
|
||
m_Faces.Add(new ArrowFace
|
||
{
|
||
A = from + new Vector2(-1f, -1f),
|
||
B = from + new Vector2(-1f, 1f),
|
||
C = from + new Vector2(1f, 1f),
|
||
D = from + new Vector2(1f, -1f),
|
||
Depth = depth,
|
||
Color = startColor,
|
||
});
|
||
return true;
|
||
}
|
||
|
||
m_Faces.Add(new ArrowFace
|
||
{
|
||
A = shaftA, B = shaftB, C = shaftC, D = shaftD, Depth = depth, Color = startColor,
|
||
});
|
||
if (!withHead) return true;
|
||
|
||
m_Faces.Add(new ArrowFace
|
||
{
|
||
A = headA, B = headB, C = headC, D = headD, Depth = depth, Color = endColor,
|
||
});
|
||
return true;
|
||
}
|
||
|
||
private Vector3 ReadPoint(IXChartDataSource source, int record)
|
||
{
|
||
return new Vector3(
|
||
(float)source.GetValueAt(record, CoordinateDimension),
|
||
(float)source.GetValueAt(record, CoordinateDimension + 1),
|
||
(float)source.GetValueAt(record, CoordinateDimension + 2));
|
||
}
|
||
|
||
/// <summary>
|
||
/// 这一条记录的颜色:没开颜色维就是单色;开了就按
|
||
/// <c>[色相(0..256 色环), 饱和度(0..1), 明度(0..1), (不透明度 0..1)]</c> 读。
|
||
/// <b>读不成(维不够或值不是有限数)就退回单色</b>——不是画成黑:黑在深色背景上等于没画,
|
||
/// 而"退回了单色"这件事在报表的 <c>colors=</c> 读数里看得见。
|
||
/// </summary>
|
||
private Color ColorAt(IXChartDataSource source, int record)
|
||
{
|
||
if (!UseColorDimensions) return ArrowColor;
|
||
if (source.NumericDimensionCount < ColorDimension + XChartArrowConfig.ColorDimensionCount) return ArrowColor;
|
||
|
||
float hue = (float)source.GetValueAt(record, ColorDimension);
|
||
float saturation = (float)source.GetValueAt(record, ColorDimension + 1);
|
||
float value = (float)source.GetValueAt(record, ColorDimension + 2);
|
||
float alpha = HasAlphaDimension
|
||
? (float)source.GetValueAt(record, ColorDimension + 3)
|
||
: ArrowColor.a;
|
||
|
||
Color color;
|
||
return XChartVectorFieldMath.TryColor(hue, saturation, value, alpha, out color) ? color : ArrowColor;
|
||
}
|
||
|
||
protected override void OnDispose()
|
||
{
|
||
FillRenderer = null;
|
||
m_Faces.Clear();
|
||
}
|
||
|
||
#if UNITY_EDITOR
|
||
/// <summary>
|
||
/// 报表里点名这一帧:<b>维数(现有/需要)与记录数</b>+算了几支+读法+颜色来源+面数/块数。
|
||
/// "加了工具什么都没显示"这件事只有这一行分得清是"维数不够"还是"记录不够"还是"算了但没提交"
|
||
/// (他 2026-10-25 现场;规范 §25.1)。
|
||
/// </summary>
|
||
internal override void AppendDebugLine(System.Text.StringBuilder sb)
|
||
{
|
||
base.AppendDebugLine(sb);
|
||
sb.Append(" dims=").Append(m_DimensionsHave).Append('/').Append(m_DimensionsNeed)
|
||
.Append(" records=").Append(m_RecordsHave)
|
||
.Append(" arrows=").Append(m_ArrowsBuilt)
|
||
.Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute"))
|
||
.Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single")
|
||
.Append(" arrowFaces=").Append(FillRenderer != null ? FillRenderer.FaceCount : 0)
|
||
.Append(" fillChunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : 0)
|
||
.Append(" fillMaxVerts=").Append(FillRenderer != null ? FillRenderer.MaxChunkVertices : 0);
|
||
}
|
||
#endif
|
||
}
|
||
} |