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/,未入本仓库。)
This commit is contained in:
@@ -0,0 +1,137 @@
|
||||
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();
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user