他报的现象:"散点会把点钳在范围内,矢量不钳;而且四档方向来源画出来的东西看不出意义。" 两处都对得上字面,成因不同: - 钳与不钳是**两份实现**:散点折进盒子用 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,删除或改默认都会改他画面)——三个选项与我的建议(把它迁到首尾相接)已回给他。 覆盖不到的:画到盒外的点会不会被别的东西挡住、"默认钳还是默认原样"好不好看,归他现场判。
275 lines
15 KiB
C#
275 lines
15 KiB
C#
using System;
|
||
using UnityEngine;
|
||
using UnityEngine.Serialization;
|
||
using XericUI.XChart.Space;
|
||
|
||
namespace XericUI.XChart.Mesh
|
||
{
|
||
// 方向来源的枚举在 XChartVectorFieldMath.cs 里(XChartArrowDirectionSource):
|
||
// 算箭数的四种算法也在那里,配置只存"选哪一种"——两边各写一遍就会答得不一样(§25.1 那一族)。
|
||
|
||
/// <summary>圆柱元素的配置(几何单位都是立方体局部:±1 就是盒子边界)。</summary>
|
||
[Serializable]
|
||
[XChartElement("cylinder", "圆柱", 40)]
|
||
public sealed class XChartCylinderConfig : XChartElementConfig
|
||
{
|
||
[Header("几何")]
|
||
[SerializeField, Tooltip("起点圆心(立方体单位)")]
|
||
private Vector3 m_Start = new Vector3(-0.6f, -0.6f, -0.6f);
|
||
[SerializeField, Tooltip("终点圆心(立方体单位);两端不重合就是斜圆柱")]
|
||
private Vector3 m_End = new Vector3(0.6f, 0.6f, 0.6f);
|
||
|
||
[SerializeField, Tooltip("几何来源:关=用上面的常量坐标;开=从数据取(每组的首尾两条记录=这条圆柱的两端)")]
|
||
private bool m_DriveByData;
|
||
[SerializeField, Tooltip("数据模式下 X 取哪一维")]
|
||
private int m_DimensionX;
|
||
[SerializeField, Tooltip("数据模式下 Y 取哪一维")]
|
||
private int m_DimensionY = 1;
|
||
[SerializeField, Tooltip("数据模式下 Z 取哪一维")]
|
||
private int m_DimensionZ = 2;
|
||
[SerializeField, Min(2), Tooltip("几条记录凑一根圆柱(2=两两一组:记录 0-1、2-3…,不重叠也不并入上一组)")]
|
||
private int m_GroupSize = 2;
|
||
[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("一圈分多少段(轮廓与十字的采样精度)")]
|
||
private int m_SegmentCount = 48;
|
||
|
||
[SerializeField, Tooltip("起点端面的法线。零=沿两端连线(与旧行为一致)")]
|
||
private Vector3 m_StartNormal = Vector3.zero;
|
||
[SerializeField, Tooltip("终点端面的法线。零=沿两端连线。两端各给各的,就能做出端面不平行的那种")]
|
||
private Vector3 m_EndNormal = Vector3.zero;
|
||
|
||
[SerializeField, Tooltip("圆柱自己的变换(叠在图的空间之上)")]
|
||
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
|
||
|
||
[Header("呈现(各有开关)")]
|
||
[SerializeField, Tooltip("外轮廓包边(视角下的轮廓,不是把所有母线都连起来)")]
|
||
private bool m_ShowOutline = true;
|
||
[SerializeField] private Color m_OutlineColor = new Color(0.75f, 0.85f, 1f, 0.9f);
|
||
[SerializeField, Min(0.1f)] private float m_OutlineThickness = 2f;
|
||
|
||
[SerializeField, Tooltip("轮廓填充(与包边同一个凸包多边形)")]
|
||
private bool m_ShowFill = true;
|
||
[SerializeField] private Color m_FillColor = new Color(0.34f, 0.55f, 0.85f, 0.35f);
|
||
|
||
[SerializeField, Tooltip("端面十字:用端面自己的采样顶点连成,所以永远与实际端面对得上,能看出滚转")]
|
||
private bool m_ShowCapCross;
|
||
[SerializeField] private Color m_CrossColor = new Color(0.9f, 0.95f, 1f, 0.85f);
|
||
[SerializeField, Min(0.1f)] private float m_CrossThickness = 1.5f;
|
||
|
||
[SerializeField, Tooltip("起点端面的闭合圆环(端面自己的边界,整圈闭合)")]
|
||
private bool m_ShowStartRing;
|
||
[SerializeField, Tooltip("终点端面的闭合圆环")]
|
||
private bool m_ShowEndRing;
|
||
|
||
[SerializeField, Range(0, 64), Tooltip("内部母线数量(两端对应点相连;0=不画)")]
|
||
private int m_GeneratrixCount;
|
||
[SerializeField] private Color m_GeneratrixColor = new Color(0.75f, 0.85f, 1f, 0.35f);
|
||
|
||
public override string ElementName => "Cylinder";
|
||
|
||
public override XChartToolBase CreateTool() => new ChartToolCylinder();
|
||
|
||
public override void ApplyTo(XChartToolBase tool)
|
||
{
|
||
if (!(tool is ChartToolCylinder cylinder)) return;
|
||
|
||
cylinder.Start = m_Start;
|
||
cylinder.End = m_End;
|
||
cylinder.DriveByData = m_DriveByData;
|
||
cylinder.DimensionX = m_DimensionX;
|
||
cylinder.DimensionY = m_DimensionY;
|
||
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;
|
||
cylinder.EndNormal = m_EndNormal;
|
||
cylinder.Transform = m_Transform;
|
||
|
||
cylinder.ShowOutline = m_ShowOutline;
|
||
cylinder.OutlineColor = m_OutlineColor;
|
||
cylinder.OutlineThickness = m_OutlineThickness;
|
||
|
||
cylinder.ShowFill = m_ShowFill;
|
||
cylinder.FillColor = m_FillColor;
|
||
|
||
cylinder.ShowCapCross = m_ShowCapCross;
|
||
cylinder.CrossColor = m_CrossColor;
|
||
cylinder.CrossThickness = m_CrossThickness;
|
||
|
||
cylinder.ShowStartRing = m_ShowStartRing;
|
||
cylinder.ShowEndRing = m_ShowEndRing;
|
||
|
||
cylinder.GeneratrixCount = m_GeneratrixCount;
|
||
cylinder.GeneratrixColor = m_GeneratrixColor;
|
||
|
||
cylinder.MarkDirty();
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 向量箭头(矢量场)元素的配置。
|
||
///
|
||
/// <para><b>数据口径(2026-10-25 他澄清后定稿,规范 §25.2)</b>:</para>
|
||
/// <list type="bullet">
|
||
/// <item><b>前三维=坐标 x/y/z</b>(立方体单位,与圆柱、散点同一套归一化)——不是"两组三维"。</item>
|
||
/// <item><b>一支箭头=相邻两条记录</b>:第 i 条是起点,第 i+1 条按 <see cref="m_DirectionSource"/> 解释成
|
||
/// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。
|
||
/// 2026-10-26 又补了两档来源:本条记录自带方向(0~2 点、3~5 方向)、以及"偶数是点、奇数是方向"的分段存法。</item>
|
||
/// <item><b>第 4~7 维是颜色</b>:色相(0..256 色环)/ 饱和度 / 明度 / 不透明度,全部可选。
|
||
/// 颜色随记录自带 ⇒ 一支箭头的起点色与终点色可以不同(七维信息的那个用法)。</item>
|
||
/// </list>
|
||
///
|
||
/// <para><b>连续绘制</b>(<see cref="Continuous"/>):把每条记录的坐标按顺序连成折线——
|
||
/// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两项**隐藏**
|
||
/// (互斥显示,见 <see cref="IsFieldHidden"/>)。</para>
|
||
/// </summary>
|
||
[Serializable]
|
||
[XChartElement("arrows", "向量箭头", 50)]
|
||
public sealed class XChartArrowConfig : XChartElementConfig
|
||
{
|
||
/// <summary>坐标要占几个数值维(x/y/z)</summary>
|
||
public const int CoordinateDimensionCount = 3;
|
||
/// <summary>颜色要几个数值维(色相/饱和度/明度 [+不透明度])</summary>
|
||
public const int ColorDimensionCount = 3;
|
||
|
||
[Header("数据")]
|
||
[SerializeField, Tooltip("坐标从第几个数值维开始(一条记录 3 维:x/y/z);一支箭头由**相邻两条记录**构成")]
|
||
private int m_CoordinateDimension;
|
||
|
||
[SerializeField, Tooltip("方向从哪来(旧「相对/绝对」就是这里的前两项,存的值不用重设):" +
|
||
"相邻两条·下一条的坐标当方向 / 相邻两条·下一条是第二个点(首尾相接) / " +
|
||
"本条记录自带方向(0~2 是点、3~5 是方向) / 分段(偶数记录是点、奇数是方向)")]
|
||
[FormerlySerializedAs("m_VectorMode")]
|
||
private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsVector;
|
||
|
||
[SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" +
|
||
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
|
||
private bool m_Continuous;
|
||
|
||
[SerializeField, Range(0f, 1f), Tooltip("连续绘制时箭头放在路径的哪个位置(0=起点、1=末端):" +
|
||
"它是曲线渲染器那个标记在曲线上的参数位置,路径不剪断、标记叠在线上。" +
|
||
"只有连续绘制用得上")]
|
||
private float m_HeadPosition = 1f;
|
||
|
||
[SerializeField, Range(0f, 1f), Tooltip("头贴在矢量端点的哪一处:0=尾部落在点上(向前伸)、" +
|
||
"0.5=中心对点、1=头尖落在点上(默认)。" +
|
||
"头的长短还会按这条矢量的投影比例缩放,指向屏幕里就会缩没")]
|
||
private float m_MarkerAnchor = 1f;
|
||
|
||
[SerializeField, Range(2, 64), Tooltip("连续绘制时每段路径细分成几节(曲线渲染器的 tessellation)。" +
|
||
"越大越圆也越贵。只有连续绘制用得上")]
|
||
private int m_PathSegments = 12;
|
||
|
||
[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;
|
||
|
||
[SerializeField, Tooltip("箭头自己的变换(叠在图的空间之上)")]
|
||
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
|
||
|
||
[Header("颜色(可选维度)")]
|
||
[SerializeField, Tooltip("用额外的数值维给每支箭头上色。三个维依次是 色相(0..256 色环) / 饱和度(0..1) / 明度(0..1)")]
|
||
private bool m_UseColorDimensions;
|
||
|
||
[SerializeField, Tooltip("颜色三维从第几维开始(默认 3=紧跟在坐标后面)。" +
|
||
"这些维**不进**坐标语义,只是被读走做颜色;起止两端各自读自己那条记录的颜色")]
|
||
private int m_ColorDimension = 3;
|
||
|
||
[SerializeField, Tooltip("再加一维不透明度(0..1),读颜色起点维 +3")]
|
||
private bool m_HasAlphaDimension;
|
||
|
||
[Header("外观")]
|
||
[SerializeField, Tooltip("没有给颜色维度时用的单色")]
|
||
private Color m_ArrowColor = new Color(0.95f, 0.6f, 0.25f, 0.9f);
|
||
[SerializeField, Min(0.1f), Tooltip("杆宽(像素)")]
|
||
private float m_ShaftWidth = 2f;
|
||
[SerializeField, Min(0.1f), Tooltip("箭头长(像素)")]
|
||
private float m_HeadLength = 10f;
|
||
[SerializeField, Min(0.1f), Tooltip("箭头宽(像素)")]
|
||
private float m_HeadWidth = 7f;
|
||
[SerializeField, Tooltip("零向量也画成一个极小四边形(不画的话它会整条消失)")]
|
||
private bool m_ShowZeroVectorsAsDots;
|
||
|
||
public override string ElementName => "Arrows";
|
||
|
||
/// <summary>
|
||
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
|
||
/// <b>坐标那一半随方向来源变</b>:本条自带方向那档要 6 个(0~2 点、3~5 方向),其余三档 3 个;
|
||
/// 再加(可选)颜色 3。<b>不透明度那一维不算硬需求</b>(多给就多读、没给退回单色 alpha)——
|
||
/// 算进门槛的话,勾一下"有不透明度"会让整个元素因维数不够突然消失。
|
||
/// </summary>
|
||
public override int RequiredNumericDimensions
|
||
=> XChartVectorFieldMath.RequiredCoordinateDimensions(m_DirectionSource)
|
||
+ (m_UseColorDimensions ? ColorDimensionCount : 0);
|
||
|
||
/// <summary>
|
||
/// 一支箭头要几条记录:本条自带方向那档<b>一条就够</b>;
|
||
/// 相邻两条与"偶点奇向"那两档要两条(后者是同一支的两半,前者是重叠取)。
|
||
/// </summary>
|
||
public override int RequiredRecordCount
|
||
=> m_DirectionSource == XChartArrowDirectionSource.ThisRecordCarriesVector ? 1 : 2;
|
||
|
||
/// <summary>
|
||
/// 互斥显示:连续绘制打开时"方向从哪来"没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
|
||
/// 判据只有一处,面板照着问,不在面板里写特例。
|
||
/// </summary>
|
||
public override bool IsFieldHidden(string fieldName)
|
||
{
|
||
if (fieldName == nameof(m_DirectionSource)) return m_Continuous;
|
||
// 这两项是"路径上的箭头"才有的概念:一支一支画的时候头永远在末端
|
||
if (fieldName == nameof(m_HeadPosition) || fieldName == nameof(m_PathSegments)) return !m_Continuous;
|
||
if (fieldName == nameof(m_ColorDimension) || fieldName == nameof(m_HasAlphaDimension))
|
||
return !m_UseColorDimensions;
|
||
return false;
|
||
}
|
||
|
||
public override XChartToolBase CreateTool() => new ChartToolVectorArrows();
|
||
|
||
public override void ApplyTo(XChartToolBase tool)
|
||
{
|
||
if (!(tool is ChartToolVectorArrows arrows)) return;
|
||
|
||
arrows.CoordinateDimension = m_CoordinateDimension;
|
||
arrows.DirectionSource = m_DirectionSource;
|
||
arrows.Continuous = m_Continuous;
|
||
arrows.HeadPosition = m_HeadPosition;
|
||
arrows.MarkerAnchor = m_MarkerAnchor;
|
||
arrows.PathSegments = m_PathSegments;
|
||
arrows.DirectionScale = m_DirectionScale;
|
||
arrows.MaxArrowCount = m_MaxArrowCount;
|
||
arrows.OutOfRange = m_OutOfRange;
|
||
arrows.Transform = m_Transform;
|
||
|
||
arrows.UseColorDimensions = m_UseColorDimensions;
|
||
arrows.ColorDimension = m_ColorDimension;
|
||
arrows.HasAlphaDimension = m_HasAlphaDimension;
|
||
|
||
arrows.ArrowColor = m_ArrowColor;
|
||
arrows.ShaftWidth = m_ShaftWidth;
|
||
arrows.HeadLength = m_HeadLength;
|
||
arrows.HeadWidth = m_HeadWidth;
|
||
arrows.ShowZeroVectorsAsDots = m_ShowZeroVectorsAsDots;
|
||
|
||
arrows.MarkDirty();
|
||
}
|
||
}
|
||
}
|