Files
XericUIActionVessel/Runtime/XChart/Space/XChartScatterConfig.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

117 lines
4.7 KiB
C#

using System;
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
using XericUI.XChart.Pseudo3D;
using XericUI.XChart.Space;
namespace XericUI.XChart.Space
{
/// <summary>
/// 散点元素的配置。数据默认<b>直接读图的数据源</b>(按维度下标 + 聚合范围归一化),
/// 所以配好三个维度下标就能出图,不需要在图表上为散点再写一遍数据。
///
/// <para>关掉 <see cref="m_AutoFromData"/> 就变成"脚本喂点"模式:由调用方
/// <c>SetCubePoints</c> 给立方体单位的点([-1,1] 就是盒子内部)。</para>
/// </summary>
[Serializable]
[XChartElement("scatter", "散点", 30)]
public sealed class XChartScatterConfig : XChartElementConfig
{
[Header("数据来源")]
[SerializeField, Tooltip("真=按下面的维度下标读图的数据源;假=脚本用 SetCubePoints 喂")]
private bool m_AutoFromData = true;
[SerializeField, Tooltip("X / Y / Z 轴取哪几个维度下标(绑定;显示范围在 chart 的数据板块逐维给)")]
private int m_DimensionX;
[SerializeField] private int m_DimensionY = 1;
[SerializeField] private int m_DimensionZ = 2;
[SerializeField, Tooltip("点云自己的变换(叠在图的空间之上)")]
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
[SerializeField, Min(0), Tooltip("桶采样目标点数:0 或 ≥ 记录数=不聚合;填了数就把记录按桶归约成这么多个点")]
private int m_BucketTargetPoints;
[SerializeField, Tooltip("桶内取哪个统计量当这个点:抽稀用 First/Last(不造新值),看趋势用 Mean/Median,看包络用 Minimum/Maximum")]
private XChartAggregateKind m_BucketReduce = XChartAggregateKind.Last;
[Header("外观")]
[SerializeField, Min(0.5f), Tooltip("点的大小(像素)")]
private float m_PointSize = 8f;
[SerializeField, Tooltip("图元类型")]
private PrimitiveType m_PointType = PrimitiveType.Polygon;
[SerializeField, Tooltip("图元边数(多边形时有效)")]
private int m_SideCount = 8;
[SerializeField, Tooltip("填充色")]
private Color m_PointColor = new Color(0.33f, 0.67f, 1f, 1f);
[SerializeField, Tooltip("中心色;与填充色不同就走径向渐变")]
private Color m_CenterColor = Color.white;
[SerializeField, Tooltip("边框色")]
private Color m_BorderColor = new Color(0.2f, 0.2f, 0.2f, 1f);
[SerializeField, Min(0f), Tooltip("边框宽度")]
private float m_BorderThickness = 1f;
[Header("按数值上色")]
[SerializeField, Tooltip("用某一维的数值做颜色渐变")]
private bool m_EnableColorMapping;
[SerializeField, Tooltip("拿哪一维的数值")]
private int m_ColorMapDimension = 2;
[SerializeField, Tooltip("范围下限对应颜色")]
private Color m_ColorMapMin = Color.blue;
[SerializeField, Tooltip("范围上限对应颜色")]
private Color m_ColorMapMax = Color.red;
public override string ElementName => "Scatter";
public override XChartToolBase CreateTool() => new ChartToolScatterPoints();
public override void ApplyTo(XChartToolBase tool)
{
if (!(tool is ChartToolScatterPoints scatter)) return;
scatter.AutoFromData = m_AutoFromData;
scatter.DimensionX = m_DimensionX;
scatter.DimensionY = m_DimensionY;
scatter.DimensionZ = m_DimensionZ;
scatter.Transform = m_Transform;
scatter.BucketTargetPoints = m_BucketTargetPoints;
scatter.BucketReduce = m_BucketReduce;
scatter.PointSize = m_PointSize;
scatter.PointType = m_PointType;
scatter.SideCount = m_SideCount;
scatter.PointColor = m_PointColor;
scatter.CenterColor = m_CenterColor;
scatter.BorderColor = m_BorderColor;
scatter.BorderThickness = m_BorderThickness;
scatter.EnableColorMapping = m_EnableColorMapping;
scatter.ColorMapDimension = m_ColorMapDimension;
scatter.ColorMapMin = m_ColorMapMin;
scatter.ColorMapMax = m_ColorMapMax;
scatter.MarkDataDirty();
}
public override void CaptureFrom(XChartToolBase tool)
{
if (!(tool is ChartToolScatterPoints scatter)) return;
m_AutoFromData = scatter.AutoFromData;
m_PointSize = scatter.PointSize;
m_PointColor = scatter.PointColor;
m_Transform = scatter.Transform;
}
}
}