Files
XericUIActionVessel/Runtime/XChart/Radar/ChartToolRadarData.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

137 lines
5.2 KiB
C#

using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using XericUI.Core;
namespace XericUI.XChart.Radar
{
/// <summary>
/// 雷达图数据线框渲染工具。
///
/// 使用 UILineRendererV2 绘制每个数据系列的多边形轮廓。
/// 仅绘制线框,无填充效果。
/// 每个系列一个闭合多边形,颜色和线宽独立配置。
///
/// 子节点结构:
/// [ChartTool_RadarData]
/// └─ DataRenderer (UILineRendererV2) — 所有数据系列的线框
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Radar/Radar Data Tool")]
public class ChartToolRadarData : XChartToolBase
{
// ── 配置 ──────────────────────────────────────────────────
/// <summary>雷达图半径(像素)</summary>
public float Radius { get; set; } = 120f;
/// <summary>中心位置</summary>
public Vector2 Center { get; set; } = Vector2.zero;
/// <summary>维度数量</summary>
public int DimensionCount { get; set; } = 5;
// ── 内部组件 ──────────────────────────────────────────────
/// <summary>数据线框渲染器</summary>
public UILineRendererV2 DataRenderer { get; private set; }
// ── 数据缓存 ──────────────────────────────────────────────
private XChartRadarDataModel.RadarSeries[] m_Series = new XChartRadarDataModel.RadarSeries[0];
private float m_MaxValue = 1f;
private bool m_DataDirty = true;
// ── 初始化 ────────────────────────────────────────────────
protected override void OnInitialize()
{
DataRenderer = CreateChildComponent<UILineRendererV2>("DataRenderer");
if (DataRenderer != null)
{
var rt = DataRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
}
// ── 数据更新 ──────────────────────────────────────────────
/// <summary>
/// 设置数据系列。
/// </summary>
/// <param name="series">数据系列数组</param>
/// <param name="maxValue">当前最大值(用于归一化)</param>
public void SetSeries(XChartRadarDataModel.RadarSeries[] series, float maxValue)
{
m_Series = series ?? new XChartRadarDataModel.RadarSeries[0];
m_MaxValue = maxValue > 0.001f ? maxValue : 1f;
m_DataDirty = true;
}
/// <summary>标记数据为脏(下次渲染时刷新)</summary>
public void MarkDirty()
{
m_DataDirty = true;
}
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
{
base.OnRender();
if (!m_DataDirty) return;
m_DataDirty = false;
if (DataRenderer == null) return;
DataRenderer.ClearAll();
if (DimensionCount < 3 || m_Series.Length == 0) return;
// 预计算方向
var dirs = XChartRadarDataModel.GetDimensionDirections(DimensionCount);
// 绘制每个数据系列的多边形轮廓
for (int si = 0; si < m_Series.Length; si++)
{
var series = m_Series[si];
if (series.values == null || series.values.Length == 0) continue;
DrawSeriesPolygon(series, dirs);
}
}
private void DrawSeriesPolygon(XChartRadarDataModel.RadarSeries series, Vector2[] dirs)
{
int dims = DimensionCount;
float invMax = 1f / m_MaxValue;
// 计算多边形顶点
var pts = new Vector2[dims + 1];
for (int i = 0; i < dims; i++)
{
float val = (i < series.values.Length) ? series.values[i] : 0f;
float r = Mathf.Clamp01(val * invMax) * Radius;
pts[i] = Center + dirs[i] * r;
}
pts[dims] = pts[0]; // 闭合
// 绘制闭合多边形线框
for (int i = 0; i < dims; i++)
{
DataRenderer.DrawLine(pts[i], pts[i + 1],
series.color, series.lineWidth);
}
}
// ── 清理 ──────────────────────────────────────────────────
protected override void OnDispose()
{
DataRenderer = null;
m_Series = null;
}
}
}