Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartVolumeConfigs.cs
T
lrss3 5f4c1adf0a XChart P22:箭头的杆与头改走曲线渲染器的原生标记(规范 §29,他纠正"箭头为何用的是填充")
他这句纠正指向一件我一直不知道存在的东西:

> 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。

P18 那次我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API——`AddCurve`/`CurveCacheEntry` 猜对了,
于是**没有回头把那个包读一遍**,它旁边的 `ArrowHeadData` 我一直不知道,就用填充四边形自己拼了杆和头。
包其实就在工作区隔壁(com.lrss3.deconstruction),API 一直写在
Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs。教训写进 §29.1:
**照着调用点猜出来能跑之后,要把那个来源补读一遍**——"我猜对了"证明不了"我看见全了"。

画法(一套几何,没有第二条路):
- 杆=一条**共线**三次贝塞尔(新纯算术 XChartArrowPathMath.Straight:内控制点落在 1/3、2/3),
  宽度=ShaftWidth,startColor/endColor 就是沿杆渐变——P18 我要的那个效果原来是条目的原生能力。
- 头=原生标记 ArrowHeadData:width=头长(沿切线)、height=头宽(垂直切线)、
  depthCompensation=+1 ⇒ **头尖对准那个数据点**。尺寸与位置先走我们自己的纯算术 XChartArrowMarker
  (离线探针引不到库那个 assembly,判据打在纯算术上,工具里只做对号入座)。
- 连续绘制的头挂在 ResolvePosition 算出的那一节上、progress=节内参数;**路径不再剪断**——
  "必须剪否则线穿箭头"是我上一版自己加的机制,Split 因此没有调用方,随四角绕序一起删。
- 零向量=一个 Circle 标记(开关关掉则整条不画,计入 skipped=)。
- **曲线渲染器不在位 ⇒ path=none、一支都不画**。不再有"退回填充画法"那第二条路:两套画法就是两套口径,
  而这次的 bug 恰恰长在第二条路上。

撤掉:XChartArrowGeometry(BuildShaft/BuildHead/TryBuild)整个类删、XChartArrowPathMath.Split 删。
留着:XChartMeshFillRenderer.AddFaceLinear 与 XChartFaceFillKind.Linear——那是填充渲染器自己的上色模式
(预算 VerticesPerFace(Linear)==4 与判据都在),只是箭头不再用它;别的元素要渐变填充时不必再写第二套。
配置里 HeadPosition 的 tooltip 一起改(原文写着"路径在这一处剪断",§29 之后不剪,留着就是面板说谎)。

**为什么这一改仍然不算把 bug 修好**(§29.3 写清):P13 遗留的"填充面改了没作用"与今天"杆与头都不画"
是同一坏点的两种症状,都走 XChartMeshFillRenderer。硬证据是他工程里那份报表(我打开开关后跑出来的):
`arrows=31 arrowFaces=62 fillChunks=1 fillMaxVerts=248`(=62×4 顶点一个不多)且
`dom=x[-100..100] y[-49.936..49.936] z[-49.743..50]` ⇒ 坐标已折进盒子、面提交了、子块建了、网格真填了顶点,
画面上却没有 ⇒ 坏点在填充渲染器到 Canvas 的那一跳。箭头不再经过那一跳,所以箭头上屏了,
而那一跳本身没修(P23 专门查;绕过去不等于修好)。同一行还抓到一条会撒谎的读数:
curves=0 却 curveVerts=66,而圆柱那一行也印 66 ⇒ UICurveRenderer.LiveVertexCount 不是本实例的数,
不能当"我这条曲线画了多少顶点"读(一并立进 P23)。

判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;
新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、progress 夹进 [0,1]、NaN 位置落到末端、0 尺寸兜底、
Straight 每个采样都落在那条直线上、切线方向与矢量平行);p4_control **65** 支 CONTROL PASSED
(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / progress 不夹 / 头尖不对点,各红 1/2/1 条点名断言);
dirty_gate 正本 knobs=132 takesEffect=132 findings=0、八支变异全红(claim F 判"坐标必须经 TryCubePoint",
改写后仍判得住);编译门 runtime+player+editor+3 对照 GATE PASSED(chain_p22.txt,
tooltip 那次改动之后重跑一次 chain_p22b.txt 同样绿)。

本轮我自己两次把臂写坏,两次都是 harness 拒绝而不是假判,记进规范:
① 单行锚 `AcrossTangent = Mathf.Max(0.1f, width),` 被我新写的孪生函数 Head/Dot 撞成 2 命中 ⇒ SETUP FAILED,
整轮作废 ⇒ 锚要加宽到"只有那一处才有的形状"(这次用两行块);
② 替换值给对象初始化器里那一行写了分号(`Progress = progress;`)⇒ 变异体 CS1513,又是 SETUP FAILED
⇒ 替换值要保持它所在语法位置的标点。
另外 run_gate 学到一件事(同轮改动):rsp 是项目取的快照,删掉一个源文件后那份快照还列着它 ⇒ CS2001,
整道门红得像"产品编译不过"。现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**
(判决要说出它判的是哪棵树)——这不是吞错:CS2001 说的是快照过期,Unity 重导入会自己重生成 rsp。

顺带把 P18 那个还欠着的 .meta(XChartArrowPathMath.cs.meta,Unity 早生成好了、我一直没提交)一起入仓。
覆盖不到的照旧:观感归他现场判(§29.5 四条:成对模式 31 支直线+三角头、连续绘制拖 HeadPosition 头沿线滑动、
颜色维沿程渐变、什么都没有时读 path=/arrows=/markers=/curveVerts=)。
2026-10-26 13:15:55 +08:00

260 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 XericUI.XChart.Space;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 一条记录里的两个点怎么变成一支箭头。
///
/// <para><b>绝对</b>:后三点是方向矢量本身(起点 + 方向×倍率=末端)。螺旋点这样画出来是"刺猬"。
/// <b>相对</b>:后三点是第二个点,箭头=第一点指向第二点(差向量×倍率)。
/// 连续绘制模式下两者都不适用(连起来的是一条空间路径)。</para>
/// </summary>
public enum XChartArrowVectorMode
{
/// <summary>后三维=方向矢量</summary>
Absolute = 0,
/// <summary>后三维=第二个点(箭头由第一点指向它)</summary>
Relative = 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="VectorMode"/> 解释成
/// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。</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("绝对:第二条记录的坐标当作方向矢量(起点→末端)。" +
"相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
[SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" +
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
private bool m_Continuous;
[SerializeField, Range(0f, 1f), Tooltip("连续绘制时箭头放在路径的哪个位置(0=起点、1=末端):" +
"它是曲线渲染器那个标记在曲线上的参数位置,路径不剪断、标记叠在线上。" +
"只有连续绘制用得上")]
private float m_HeadPosition = 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>
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
/// 坐标 3 +(可选)颜色 3;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha)——
/// 算进门槛的话,勾一下"有不透明度"会让整个元素因维数不够突然消失。
/// </summary>
public override int RequiredNumericDimensions
=> CoordinateDimensionCount + (m_UseColorDimensions ? ColorDimensionCount : 0);
/// <summary>一支箭头要两条记录 ⇒ 记录少于 2 条时一支都画不出来(面板/报表同样要印出来)</summary>
public override int RequiredRecordCount => 2;
/// <summary>
/// 互斥显示:连续绘制打开时「相对/绝对」没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
/// 判据只有一处,面板照着问,不在面板里写特例。
/// </summary>
public override bool IsFieldHidden(string fieldName)
{
if (fieldName == nameof(m_VectorMode)) 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.VectorMode = m_VectorMode;
arrows.Continuous = m_Continuous;
arrows.HeadPosition = m_HeadPosition;
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();
}
}
}