此前整个 XChart 特性一直没有提交(分期 P0–P12 的代码与素材都还在工作区里)。这一批一并入库, 并含本轮 P13–P17 的改动(规范 Documentation/XChart-RenderFramework.md 新增 §22–§25): - P13:格线只剩一个作者——线框工具不再有"画格线 / 发布格线插槽"的代码路径;BG Cube Grid(原 MeshBg) 是唯一作者,且"画上去的线=发布给轴线的那份比例数组";插槽板新增 Unpublish(说得出"这里不再有线", 否则掩码筛掉的面会把上一轮的值留着被消费者吸走);渲染参数搬进元素表 (DeclareDefaultElements / AddDefaultElement + XChartElementTable 按类型去重,只在第一次读到表时补); 图上「立方体外观」那组字段删除、公共属性转发到元素表;面板逐行点名脚本注册的工具。 - P14 / P15:数据窗口文案收敛(行末 `-`、标题 `X [0]`、长说明退回 tooltip、范围页三行不再被压扁); 元素块收成一行状态 `▼ 名称 √ R… D… [↑][↓][-]`;**注册序由类型定死、只显示不给输入控件, 绘制序与元素在表里的位置绑定**(§24.5,他 2026-10-25 澄清);默认元素让删也让关; EnsureSpace 改成每次重建后都跑(删掉"空间"不再等于整张图空掉)。 - P17:矢量场——维数不够时不再静默不画(元素配置报需求,面板与报表同时印"需求/现有"); 相对/绝对两种读法收进纯算术 XChartVectorFieldMath;连续绘制(互斥显示把"相对/绝对"藏起来); 颜色维(色相走 0..256 色环,饱和/明度/不透明 0..1,不透明度不算硬需求);新增螺旋矢量场测试数据。 数据口径按他澄清修正为:前三维=坐标、一支箭头=相邻两条记录、第 4~7 维是颜色(§25、CHANGELOG 修正行)。 判据:编译门三臂 + 3 支对照绿;离线探针 436 项 0 失败;p4_control 55 支臂各红在自己点名的断言上; p2_control / pool_family / generator_gate / hierarchy_gate 在同一棵交付树上复跑。 (证据脚本与日志在包外的 .ximage-gate/,未入本仓库。)
245 lines
12 KiB
C#
245 lines
12 KiB
C#
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>一条记录怎么读</b>:前 3 维是"一个点",后 3 维是"另一个点",
|
||
/// 按 <see cref="VectorMode"/> 解释成一支箭头——</para>
|
||
/// <list type="bullet">
|
||
/// <item><see cref="XChartArrowVectorMode.Absolute"/>(绝对):后 3 维是<b>方向矢量</b>本身,
|
||
/// 起点 + 方向×倍率 = 箭头末端。螺旋点在这种读法下画出来是一片"刺猬"(每根朝外)。</item>
|
||
/// <item><see cref="XChartArrowVectorMode.Relative"/>(相对):后 3 维是<b>第二个点</b>,
|
||
/// 箭头 = 第一点指向第二点(差向量×倍率)。一串首尾相接的点在这种读法下就是"连着头往下转"。</item>
|
||
/// </list>
|
||
///
|
||
/// <para><b>连续绘制</b>(<see cref="Continuous"/>):把所有记录的点<b>按顺序连成一条折线</b>——
|
||
/// 这时"相对/绝对"没有意义(连起来的本来就是空间里的一条路径)⇒ 面板上那两个选项**隐藏**
|
||
/// (互斥显示,见 <see cref="IsFieldHidden"/>)。</para>
|
||
///
|
||
/// <para><b>颜色是可选的额外维度</b>:<c>[h, s, v]</c>(可选 <c>+a</c>)接在矢量后面读,
|
||
/// 于是"给每个点标颜色"不需要往表里塞非数值列——色相走 0..256 的色环,其余三个按 0..1。</para>
|
||
/// </summary>
|
||
[Serializable]
|
||
[XChartElement("arrows", "向量箭头", 50)]
|
||
public sealed class XChartArrowConfig : XChartElementConfig
|
||
{
|
||
/// <summary>3 维起点 + 3 维方向/第二点</summary>
|
||
public const int VectorDimensionCount = 6;
|
||
|
||
[Header("数据")]
|
||
[SerializeField, Tooltip("起点从第几个数值维开始(一条记录要占 6 维:起点 3 + 方向或第二点 3)")]
|
||
private int m_OriginDimension;
|
||
|
||
[SerializeField, Tooltip("绝对:后三维是方向矢量(起点→末端)。相对:后三维是第二个点," +
|
||
"箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
|
||
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
|
||
|
||
[SerializeField, Tooltip("把每条记录的点按顺序连成一条折线(只有最后一段带箭头)。" +
|
||
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
|
||
private bool m_Continuous;
|
||
|
||
[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("颜色三维从第几维开始(默认 6=紧跟在矢量后面)。" +
|
||
"这些维**不进**前面的数据语义,只是被读走做颜色")]
|
||
private int m_ColorDimension = VectorDimensionCount;
|
||
|
||
[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>
|
||
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
|
||
/// 不透明度那一维**不算硬需求**(多给就多读、没给退回单色 alpha)——算进去就成了
|
||
/// "勾一个开关,整个元素消失"。
|
||
/// </summary>
|
||
public override int RequiredNumericDimensions
|
||
=> VectorDimensionCount + (m_UseColorDimensions ? 3 : 0);
|
||
|
||
/// <summary>
|
||
/// 互斥显示:连续绘制打开时「相对/绝对」没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
|
||
/// 判据只有一处,面板照着问,不在面板里写特例。
|
||
/// </summary>
|
||
public override bool IsFieldHidden(string fieldName)
|
||
{
|
||
if (fieldName == nameof(m_VectorMode)) 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.OriginDimension = m_OriginDimension;
|
||
arrows.VectorMode = m_VectorMode;
|
||
arrows.Continuous = m_Continuous;
|
||
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();
|
||
}
|
||
}
|
||
}
|