Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVolumeConfigs.cs
T
lrss3 d60d204ec1 XChart P24:方向来源四档、头的尺寸吃投影、锚点字段(规范 §30)
他这轮给了三条,我先只回答"是不是真的",再动手。

1) "矢量被归一化到屏幕空间再算了"——是真的,而且成因在库那一行:
   CurveMeshGenerator.cs:150   pos += tangent * arrow.width * 0.5f * arrow.depthCompensation
   标记的**方向**跟曲线切线走(对),**尺寸是固定像素**(不是投影结果)。杆随姿态缩短、头不缩 ⇒
   整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 ProjectedScale(投影像素, 立方体长度, CubeToPixel)
   =这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取
   **这一节自己**的比例,所以弯到背面去的那一节头跟着缩;除不出来(NaN、零长、零比例)就答 0——
   宁可头缩成没有,也不要一个凭空的固定像素尺寸。
2) Absolute 下"方向从哪来"要可选,支数跟着变(他的算术:32 个点两两一组 ⇒ 16 支,而不是现在的 32 支)。
   新增 XChartArrowDirectionSource 四档:NextRecordAsVector(旧 Absolute,N−1)/NextRecordAsPoint
   (旧 Relative,N−1,点到点不用再算一次投影,所以 Tip 只在这一档作差)/ThisRecordCarriesVector
   (同一条记录 0~2 是点、3~5 是方向,N 支、要 6 维)/AlternatingRecords(偶数是点、奇数是方向,N÷2 支)。
   **支数与维数只有 ArrowCount(source,…) 和 RequiredCoordinateDimensions(source) 这一个实现**:
   四档算法在工具里各写一遍,画面上只是"少几支",那是最难查的一类错。
3) 锚点:MarkerAnchor [0,1] → 库的 depthCompensation(anchor×2−1;0=尾部落点、0.5=中心、1=头尖落点=默认),
   非有限退回 1——"头该贴在哪"不该因为一次写坏的值变成位置未知。

另外两条顺手立的规矩:
- **方向是原始矢量,绝不按位置的显示范围折**(TryReadRaw):折一次就把"朝哪"变成"在哪"
  ((0,1,0) 会被折成一个偏移量,整场箭头一起跑偏);尺度交给 DirectionScale。
  顺带:XMeshPreviewChart 那份"一条记录 6 维、方向存 3~5"的旧示例数据在 ThisRecordCarriesVector 下
  正好合法(§28.5 说的"死数据"有了读法)——默认值我没替他改。
- **颜色维撞上方向维**(自带方向那档吃 0~5 六列,颜色起点默认仍是 3):撞了就退回单色并印 colors=overlap,
  不静默把方向当色相读。
- **序列化兼容**:新枚举的 0/1 就是旧 XChartArrowVectorMode 的 Absolute/Relative,字段再加
  [FormerlySerializedAs("m_VectorMode")] ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。

判据:探针 462 项 0 失败(新增 10 条:四档各自支数、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、
越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0);p4_control 66 支
(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫
在新算术下已经到不了,**没有靶子的臂不当证据用**);编译门三臂 + 3 对照绿(chain_p24.txt)。

**门自己这轮现了一次瞎,这是本轮最值钱的自证**:`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,
所以总数是 132 而不是 133——而"132/132 VERDICT: PASS"是绿的、却已经不等于"每个旋钮都看得见"
(我这次把 DirectionSource 写成了多行形状,正好撞上)。补 match_head(认得大括号在下一行的声明),
并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 MarkDirty()**,门必须红——
看不见形状的门会放行一个不置脏的旋钮。补完后 knobs=133 takesEffect=133、九支变异全红。

两次 harness 正常工作也记在这里(都是它拒绝,而不是假判):CJK 第三次进了声明 coding: ascii 的脚本
(⇒ 中文只进仓内文档);一支臂的单行锚被我新写的孪生函数撞成 2 命中 ⇒ SETUP FAILED 整轮作废
(锚点加宽成两行块)。

覆盖不到的照旧:头的绝对大小好不好看归他现场判(§30.6 五条:换 AlternatingRecords 应见 16 支、
换 ThisRecordCarriesVector 应见 32 支且 colors=overlap 时把颜色起点调到 6、转立方体时长短不一且
headScale 读数跟着变、拖 MarkerAnchor 头尾互换、以及报表 src= anchor= headScale= 三个新读数)。
P25(自己写简单填充、替掉 chunk 式填充渲染器,顺带解掉 P23)按他的指示排在下一轮。
2026-10-26 17:44:13 +08:00

264 lines
14 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, 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.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, 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.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();
}
}
}