Files
XericUIActionVessel/Runtime/XChart/Axis/XChartAxisConfig.cs
T
lrss3 c51ab7a3c8 XChart 图表框架落地(P0–P17):格线单一作者、面板一行状态、矢量场
此前整个 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/,未入本仓库。)
2026-10-25 20:21:28 +08:00

138 lines
6.3 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.Mesh;
using XericUI.XChart.Space;
namespace XericUI.XChart.Axis
{
/// <summary>
/// 轴线元素的配置。一条轴 = <b>宿主面 + 面内方向 + 子区间 + 空间类型 + 刻度 + 标签来源</b>,
/// 全部走同一套面帧协议,所以它和背景/散点必然共形变(口径见 <see cref="XChartFaceFrame"/>)。
///
/// <para>要三条轴就在面板里加三个这个元素,各自选自己的面和维度——
/// 图表不必为"X 轴 / Y 轴 / Z 轴"写任何专用字段。</para>
/// </summary>
[Serializable]
[XChartElement("axis", "轴线", 20)]
public sealed class XChartAxisConfig : XChartElementConfig
{
[Header("宿主")]
[SerializeField, Tooltip("轴画在哪个面上:填插槽 id(默认 mesh.face.<面号>,由定义网格的元素发布;面号 = 0前 1后 2右 3左 4上 5下,语义同 XChartCubeFaceMask)")]
private string m_SlotId = "mesh.face.5";
[SerializeField, Tooltip("对齐格线:开启后每条主刻度会吸附到网格发布的那组线上(网格是定义方,轴只跟随);偏移超过相邻两线间距的一半就不吸")]
private bool m_AlignToGrid;
[SerializeField, Tooltip("沿面参数 s 还是 t 走")]
private XChartAxisDirection m_Direction = XChartAxisDirection.AlongS;
[SerializeField, Range(0f, 1f), Tooltip("轴在该方向上的起点比例。默认 0=从面的边开始;要和网格格线对齐就得铺满整面")]
private float m_StartRatio;
[SerializeField, Range(0f, 1f), Tooltip("轴在该方向上的终点比例。默认 1=到对面边;内缩成 0.95 这种值,两头的刻度就再也对不上格线")]
private float m_EndRatio = 1f;
[SerializeField, Range(0f, 1f), Tooltip("轴在垂直方向上的位置(0=贴这条边的起点侧)")]
private float m_CrossRatio;
[SerializeField, Tooltip("轴自己的变换(叠在图的空间之上)")]
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
[Header("值域与刻度")]
[SerializeField, Tooltip("轴读哪一维(绑定)。显示范围在 chart 的数据板块逐维给,这里不再存范围")]
private int m_Dimension;
[SerializeField, Tooltip("空间类型:线性 / 对数 / 指数")]
private XChartAxisScale m_Scale = XChartAxisScale.Linear;
[SerializeField, Tooltip("指数空间的强度(值按 exp(k·参数) 增长)")]
[Min(0.001f)] private float m_ExponentialStrength = 2f;
[SerializeField, Tooltip("真=按目标条数自动取好看步长(1/2/5×10^n);假=用下面的步长")]
private bool m_AutoStep = true;
[SerializeField, Tooltip("手动主刻度步长")]
private double m_ManualStep = 1.0;
[SerializeField, Range(1, 30), Tooltip("自动步长想要的目标主刻度条数")]
private int m_TargetMajorCount = 5;
[SerializeField, Range(0, 20), Tooltip("两个主刻度之间的次刻度份数(0=不画)")]
private int m_MinorTickCount = 4;
[Header("外观")]
[SerializeField] private Color m_LineColor = new Color(0.85f, 0.88f, 0.95f, 0.9f);
[SerializeField, Min(0.1f)] private float m_LineThickness = 2f;
[SerializeField, Min(0f)] private float m_MajorTickLength = 8f;
[SerializeField, Min(0f)] private float m_MinorTickLength = 4f;
[SerializeField, Min(0.1f)] private float m_TickThickness = 1.5f;
[SerializeField, Tooltip("刻度朝哪边:-1 朝面参数减小方向(朝外),+1 朝增大方向")]
private float m_TickSide = -1f;
[Header("标签")]
[SerializeField, Tooltip("内容来源:刻度数值 / 维度显示名 / 自定义字符串")]
private XChartAxisLabelSource m_LabelSource = XChartAxisLabelSource.TickValue;
[SerializeField, Tooltip("数值格式化串(如 0.00 或 0.#);留空=按量级自适应")]
private string m_LabelFormat;
[SerializeField, Tooltip("标签来源选\"自定义\"时,按主刻度顺序填这些文本")]
private string[] m_CustomLabels = new string[0];
[SerializeField, Min(0f), Tooltip("标签离刻度线的间距(像素)")]
private float m_LabelGap = 6f;
[SerializeField, Min(1f), Tooltip("字号")]
private float m_LabelFontSize = 14f;
[SerializeField] private Color m_LabelColor = new Color(0.85f, 0.88f, 0.95f, 0.95f);
[SerializeField] private Vector2 m_LabelSize = new Vector2(90f, 24f);
[SerializeField, Tooltip("标签跟着轴的方向转(斜面上读起来才不拧着)")]
private bool m_RotateLabelsWithAxis = true;
public override string ElementName => "Axis";
public override XChartToolBase CreateTool() => new ChartToolAxis();
public override void ApplyTo(XChartToolBase tool)
{
if (!(tool is ChartToolAxis axis)) return;
axis.SlotId = m_SlotId;
axis.AlignToGrid = m_AlignToGrid;
axis.Direction = m_Direction;
axis.StartRatio = m_StartRatio;
axis.EndRatio = m_EndRatio;
axis.CrossRatio = m_CrossRatio;
axis.Transform = m_Transform;
axis.Dimension = m_Dimension;
axis.Scale = m_Scale;
axis.ExponentialStrength = m_ExponentialStrength;
axis.AutoStep = m_AutoStep;
axis.ManualStep = m_ManualStep;
axis.TargetMajorCount = m_TargetMajorCount;
axis.MinorTickCount = m_MinorTickCount;
axis.LineColor = m_LineColor;
axis.LineThickness = m_LineThickness;
axis.MajorTickLength = m_MajorTickLength;
axis.MinorTickLength = m_MinorTickLength;
axis.TickThickness = m_TickThickness;
axis.TickSide = m_TickSide;
axis.LabelSource = m_LabelSource;
axis.LabelFormat = m_LabelFormat;
axis.CustomLabels = m_CustomLabels;
axis.LabelGap = m_LabelGap;
axis.LabelFontSize = m_LabelFontSize;
axis.LabelColor = m_LabelColor;
axis.LabelSize = m_LabelSize;
axis.RotateLabelsWithAxis = m_RotateLabelsWithAxis;
axis.MarkDirty();
}
}
}