Files
XericUIActionVessel/Runtime/XChart/Radar/ChartToolRadarBg.cs
T
lrss3 4272406330 XChart P20b:132 个旋钮全部"设了就生效"——122 个自动置脏,10 个走各自的 Sync
外部数据驱动缺的那一半:工具的参数以前是裸自动属性,写进去值在、画面不动,
必须再记得叫一次 MarkDirty()(他 2026-10-26 的原话:"设置的同时,属性就会自动完成脏标记")。
现在 9 个工具里每一个可写属性的 setter 都自己送变化:

    public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }

覆盖不是"改了我记得的那几个",是源码门数的(.ximage-gate/dirty_gate.py):
knobs=132 takesEffect=132 —— 122 支经 MarkDirty、10 支(散点外观)经 SyncShapeParams。
那 10 支是本轮门**查出来的**,不是我原本知道的:它们早已自带生效路径,
所以判据从"必须调 MarkDirty"改成"必须调到本文件里定义的 MarkDirty 或 Sync*/Push*/Apply*/Rebuild*"。
门另两条顺手立的判据:
- E 支:setter 靠 Sync 生效的,OnInitialize 里也必须有那一句——否则
  "if (IsInitialized) Sync()" 会把初始化之前的写全丢;
- D 支:工具自己不许在 setter 之外给自己的旋钮赋值——那会在渲染过程中把自己重新置脏、每帧重建。
  这一支第一轮报了 26 处"自赋值",全是渲染器属性的 { get; private set; }:那是只读投影不是旋钮,
  归进 views(14 个)后 0 处——真违规的一处没有(写了这条判据才知道有没有)。
  同轮另一处假红是判据把标识符里的字母当成了关键字:Offset 拼出来含 "set",
  于是只读的 Offset 被读成"有个从不调用置脏的 setter"⇒ 访问器判定改成词边界 \bset\b。
七支变异全红:M1 抹掉一个 setter 的 MarkDirty、M2 把 override 拿掉(CS0108 只是警告,
通过基类的调用从此静默失效)、M3 新增一个裸自动属性、M4 工具自赋值、M5 把一个工具从磁盘上挪走
(清单两侧都数)、M6 Sync 调用改成不存在的名字、M7 从 OnInitialize 里删掉那句 Sync。

自己的批量改写脚本先写错了一处,被门和编译门各抓一次:生成的字段行漏了等号
(private float m_Radius 0.22f;),121 个字段全中。修法是逐字节再走一遍
(.ximage-gate/knob_dirty_fix.py:判据是"这种形状的行了 0"而不是"看着差不多了")。
教训记进规范:批量改写后**先比"我说改了几处"与"实际几处合规"**,两侧都数。

ChartToolSpace 的 Rotation 初始化式跨两行,脚本按"同一行没闭合就拒绝整份"跳过了整个文件,
那 4 个旋钮手改——拒绝写比写一半好。

离线编译门(runtime + player + editor + 3 支对照):GATE PASSED,chain_p20b.txt rc=0。
mono 数学探针本轮不重跑:改的全是 MonoBehaviour 侧工具的 setter,纯算文件一个没动。
2026-10-26 09:02:13 +08:00

279 lines
12 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
{
// ── 配置 ──────────────────────────────────────────────────
private float m_Radius = 120f;
/// <summary>雷达图半径(像素)</summary>
public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }
private Vector2 m_Center = Vector2.zero;
/// <summary>中心位置</summary>
public Vector2 Center { get => m_Center; set { m_Center = value; MarkDirty(); } }
private int m_DimensionCount = 5;
/// <summary>维度数量</summary>
public int DimensionCount { get => m_DimensionCount; set { m_DimensionCount = value; MarkDirty(); } }
private string[] m_DimensionNames = new string[0];
/// <summary>维度名称列表</summary>
public string[] DimensionNames { get => m_DimensionNames; set { m_DimensionNames = value; MarkDirty(); } }
private int m_RingCount = 4;
/// <summary>网格环数量(含外圈)</summary>
public int RingCount { get => m_RingCount; set { m_RingCount = value; MarkDirty(); } }
private Color m_GridColor = new Color(0.5f, 0.5f, 0.5f, 0.3f);
/// <summary>网格颜色</summary>
public Color GridColor { get => m_GridColor; set { m_GridColor = value; MarkDirty(); } }
private Color m_AxisColor = new Color(0.5f, 0.5f, 0.5f, 0.2f);
/// <summary>轴线颜色</summary>
public Color AxisColor { get => m_AxisColor; set { m_AxisColor = value; MarkDirty(); } }
private float m_GridThickness = 1f;
/// <summary>网格线宽</summary>
public float GridThickness { get => m_GridThickness; set { m_GridThickness = value; MarkDirty(); } }
private float m_AxisThickness = 1f;
/// <summary>轴线宽</summary>
public float AxisThickness { get => m_AxisThickness; set { m_AxisThickness = value; MarkDirty(); } }
private bool m_ShowGrid = true;
/// <summary>是否显示网格</summary>
public bool ShowGrid { get => m_ShowGrid; set { m_ShowGrid = value; MarkDirty(); } }
private bool m_ShowAxis = true;
/// <summary>是否显示轴线</summary>
public bool ShowAxis { get => m_ShowAxis; set { m_ShowAxis = value; MarkDirty(); } }
private bool m_ShowLabels = true;
/// <summary>是否显示标签</summary>
public bool ShowLabels { get => m_ShowLabels; set { m_ShowLabels = value; MarkDirty(); } }
private float m_LabelFontSize = 14f;
/// <summary>标签字体大小</summary>
public float LabelFontSize { get => m_LabelFontSize; set { m_LabelFontSize = value; MarkDirty(); } }
private Color m_LabelColor = Color.white;
/// <summary>标签颜色</summary>
public Color LabelColor { get => m_LabelColor; set { m_LabelColor = value; MarkDirty(); } }
private float m_LabelOffset = 10f;
/// <summary>标签相对端点的偏移量(像素)</summary>
public float LabelOffset { get => m_LabelOffset; set { m_LabelOffset = value; MarkDirty(); } }
// ── 内部组件 ──────────────────────────────────────────────
/// <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;
}
}
}