Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVolumeConfigs.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

275 lines
15 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 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();
}
}
}