Files
XericUIActionVessel/Runtime/XChart/Radar/ChartToolRadarBg.cs
T
lrss3 71629c08bf XChart P20a:MarkDirty 升成基类抽象——置脏这件事不许有静默空实现
外部按参数驱动渲染这条路要通了,第一步是把"脏位"从各工具的私有约定升成基类协议:
XChartToolBase 新增 `public abstract void MarkDirty()`。

为什么是 abstract 而不是"基类给个空实现":空实现通过基类引用调用时什么都不做——
参数改了、值也进去了、画面不动、报表也看不出错("零要说出它零在哪一层"那一族)。
抽象让编译器逼每个工具自己说清脏位是哪个字段。

- 7 个已有 MarkDirty 的工具:`public void` → `public override void`。
  漏改任何一个都会是 CS0108 隐藏:编译只出警告,而基类引用上的调用从此静默失效。
- ChartToolSpace:没有独立脏位,投影就是它唯一要重算的东西 ⇒ override 转发给
  MarkProjectionDirty(),不自立第二个标记。
- ChartToolScatterPoints:只有 MarkDataDirty() ⇒ override 接 m_PointsDirty,
  旧名字留着转发(同工具里"数据脏"与"参数脏"本来就是同一个字段,两个名字一个字段)。

离线编译门(runtime + player + editor + 3 支对照):GATE PASSED,chain_p20a.txt。
本轮只动生命周期协议,旋钮行为未变;setter 自动置脏在下一笔。
2026-10-26 08:49:34 +08:00

264 lines
10 KiB
C#

using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using TMPro;
using XericUI.Core;
namespace XericUI.XChart.Radar
{
/// <summary>
/// 雷达图网格背景工具。
///
/// 使用 UILineRendererV2 绘制:
/// 1. 同心多边形网格(外圈 + 内圈百分比环)
/// 2. 从中心到各维度的轴线
/// 3. 每个维度端点的 TMP 标签
///
/// 子节点结构:
/// [ChartTool_RadarBg]
/// ├─ GridRenderer (UILineRendererV2) — 网格线
/// ├─ AxisRenderer (UILineRendererV2) — 轴线
/// └─ [Labels] (transform)
/// ├─ Label_0 (TMP_Text)
/// ├─ Label_1 (TMP_Text)
/// └─ ...
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Radar/Radar Background Tool")]
public class ChartToolRadarBg : 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 string[] DimensionNames { get; set; } = new string[0];
/// <summary>网格环数量(含外圈)</summary>
public int RingCount { get; set; } = 4;
/// <summary>网格颜色</summary>
public Color GridColor { get; set; } = new Color(0.5f, 0.5f, 0.5f, 0.3f);
/// <summary>轴线颜色</summary>
public Color AxisColor { get; set; } = new Color(0.5f, 0.5f, 0.5f, 0.2f);
/// <summary>网格线宽</summary>
public float GridThickness { get; set; } = 1f;
/// <summary>轴线宽</summary>
public float AxisThickness { get; set; } = 1f;
/// <summary>是否显示网格</summary>
public bool ShowGrid { get; set; } = true;
/// <summary>是否显示轴线</summary>
public bool ShowAxis { get; set; } = true;
/// <summary>是否显示标签</summary>
public bool ShowLabels { get; set; } = true;
/// <summary>标签字体大小</summary>
public float LabelFontSize { get; set; } = 14f;
/// <summary>标签颜色</summary>
public Color LabelColor { get; set; } = Color.white;
/// <summary>标签相对端点的偏移量(像素)</summary>
public float LabelOffset { get; set; } = 10f;
// ── 内部组件 ──────────────────────────────────────────────
/// <summary>网格线渲染器</summary>
public UILineRendererV2 GridRenderer { get; private set; }
/// <summary>轴线渲染器</summary>
public UILineRendererV2 AxisRenderer { get; private set; }
/// <summary>
/// 维度标签的数量口径:<b>要几个就申请几个</b>,件本身由 chart 的文本槽位池发落
/// (规范 §5.4:隐藏靠少申请,不靠把发落到的槽位 <c>SetActive(false)</c>——那会被校验当无效丢弃)。
/// </summary>
private int DesiredLabelCount
=> ShowLabels && DimensionCount >= 3 ? DimensionCount : 0;
// ── 内部状态 ──────────────────────────────────────────────
private bool m_DataDirty = true;
// ── 初始化 ────────────────────────────────────────────────
protected override void OnInitialize()
{
// 创建网格线渲染器
GridRenderer = CreateChildComponent<UILineRendererV2>("GridRenderer");
if (GridRenderer != null)
{
var rt = GridRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
// 创建轴线渲染器
AxisRenderer = CreateChildComponent<UILineRendererV2>("AxisRenderer");
if (AxisRenderer != null)
{
var rt = AxisRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
}
/// <summary>申请维度标签(只登记需求,件在 chart 的池调度里发落)</summary>
public override void OnUpdate()
{
base.OnUpdate();
RequestTextSlots(DesiredLabelCount);
}
// ── 标记脏 ────────────────────────────────────────────────
public override void MarkDirty()
{
m_DataDirty = true;
}
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
{
base.OnRender();
if (!m_DataDirty) return;
m_DataDirty = false;
DrawGrid();
DrawAxis();
UpdateLabels();
// 槽位是下一轮调度才补齐的:还欠着件就保持脏,补齐后重画一次
if (TextSlotsPending) m_DataDirty = true;
}
// ── 网格绘制 ──────────────────────────────────────────────
private void DrawGrid()
{
if (GridRenderer == null) return;
GridRenderer.ClearAll();
if (!ShowGrid || DimensionCount < 3) return;
// 预计算所有维度的方向
int dims = DimensionCount;
var dirs = XChartRadarDataModel.GetDimensionDirections(dims);
// 绘制同心多边形环
for (int ring = 1; ring <= RingCount; ring++)
{
float r = Radius * ring / RingCount;
// 构建多边形顶点
var pts = new Vector2[dims + 1];
for (int i = 0; i < dims; i++)
pts[i] = Center + dirs[i] * r;
pts[dims] = pts[0]; // 闭合
// 绘制每个线段
for (int i = 0; i < dims; i++)
{
GridRenderer.DrawLine(pts[i], pts[i + 1],
GridColor, GridThickness);
}
}
}
// ── 轴线绘制 ──────────────────────────────────────────────
private void DrawAxis()
{
if (AxisRenderer == null) return;
AxisRenderer.ClearAll();
if (!ShowAxis || DimensionCount < 3) return;
int dims = DimensionCount;
var dirs = XChartRadarDataModel.GetDimensionDirections(dims);
for (int i = 0; i < dims; i++)
{
Vector2 end = Center + dirs[i] * Radius;
AxisRenderer.DrawLine(Center, end, AxisColor, AxisThickness);
}
}
// ── 标签管理 ──────────────────────────────────────────────
private void UpdateLabels()
{
int dims = DimensionCount;
var dirs = XChartRadarDataModel.GetDimensionDirections(dims);
var labels = Texts;
// 件要下一轮调度才补齐:这一帧先画已有的那些,欠着的由 OnRender 保持脏后再画一遍
int usable = Mathf.Min(dims, labels.Count);
for (int i = 0; i < usable; i++)
{
var label = labels[i];
if (label == null) continue;
// 设置文本
string name = (i < DimensionNames.Length && DimensionNames[i] != null)
? DimensionNames[i]
: $"Dim {i}";
label.text = name;
label.fontSize = LabelFontSize;
label.color = LabelColor;
// 计算标签位置:端点向外偏移
Vector2 endPos = Center + dirs[i] * Radius;
Vector2 labelPos = endPos + dirs[i] * LabelOffset;
// 对齐方式:根据方向决定
float angle = Mathf.Atan2(dirs[i].y, dirs[i].x) * Mathf.Rad2Deg;
if (angle > -45f && angle <= 45f)
label.alignment = TextAlignmentOptions.Left;
else if (angle > 45f && angle <= 135f)
label.alignment = TextAlignmentOptions.Bottom;
else if (angle > 135f || angle <= -135f)
label.alignment = TextAlignmentOptions.Right;
else
label.alignment = TextAlignmentOptions.Top;
// 应用位置(尺寸也要在这里设:槽位来自池,创建时不知道要给哪个图表用)
var rt = label.rectTransform;
rt.anchoredPosition = labelPos;
rt.anchorMin = new Vector2(0.5f, 0.5f);
rt.anchorMax = new Vector2(0.5f, 0.5f);
rt.pivot = new Vector2(0.5f, 0.5f);
rt.sizeDelta = new Vector2(100f, 24f);
}
// 没点亮的槽位必须擦空:池件是跨维度数复用的,留着上一轮的字就是残影
for (int i = usable; i < labels.Count; i++)
if (labels[i] != null) labels[i].text = string.Empty;
}
// ── 清理 ──────────────────────────────────────────────────
protected override void OnDispose()
{
GridRenderer = null;
AxisRenderer = null;
}
}
}