外部数据驱动缺的那一半:工具的参数以前是裸自动属性,写进去值在、画面不动,
必须再记得叫一次 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,纯算文件一个没动。
279 lines
12 KiB
C#
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;
|
|
}
|
|
}
|
|
}
|