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 自动置脏在下一笔。
This commit is contained in:
2026-10-26 08:49:34 +08:00
parent b26d533ffe
commit 71629c08bf
10 changed files with 27 additions and 8 deletions
+1 -1
View File
@@ -182,7 +182,7 @@ namespace XericUI.XChart.Axis
private double m_RangeMax = 1.0; private double m_RangeMax = 1.0;
private double m_RangeStep = 1.0; private double m_RangeStep = 1.0;
public void MarkDirty() public override void MarkDirty()
{ {
m_RangeDirty = true; m_RangeDirty = true;
m_GeometryDirty = true; m_GeometryDirty = true;
+1 -1
View File
@@ -122,7 +122,7 @@ namespace XericUI.XChart.Mesh
/// <summary>本帧几何是怎么来的(报表用):literal / data(groups …) / data-skipped(原因)</summary> /// <summary>本帧几何是怎么来的(报表用):literal / data(groups …) / data-skipped(原因)</summary>
private string m_GeometryNote = "literal"; private string m_GeometryNote = "literal";
public void MarkDirty() => m_Dirty = true; public override void MarkDirty() => m_Dirty = true;
protected override void OnInitialize() protected override void OnInitialize()
{ {
+1 -1
View File
@@ -137,7 +137,7 @@ namespace XericUI.XChart.Mesh
public int GridDimensionT { get; set; } = -1; public int GridDimensionT { get; set; } = -1;
/// <summary>本元素的变换变了(或想强制重取空间)时调用</summary> /// <summary>本元素的变换变了(或想强制重取空间)时调用</summary>
public void MarkDirty() => m_Dirty = true; public override void MarkDirty() => m_Dirty = true;
/// <summary>本工具定义网格(发布面/格线插槽、算范围)⇒ 归定义组、最先跑(规范 §11.4); /// <summary>本工具定义网格(发布面/格线插槽、算范围)⇒ 归定义组、最先跑(规范 §11.4);
/// 它"画在底下"这件事由绘制序(默认最小)表达,与分组无关</summary> /// 它"画在底下"这件事由绘制序(默认最小)表达,与分组无关</summary>
+1 -1
View File
@@ -121,7 +121,7 @@ namespace XericUI.XChart.Mesh
private static readonly Comparison<ArrowFace> s_FarToNear = private static readonly Comparison<ArrowFace> s_FarToNear =
(left, right) => left.Depth.CompareTo(right.Depth); (left, right) => left.Depth.CompareTo(right.Depth);
public void MarkDirty() => m_Dirty = true; public override void MarkDirty() => m_Dirty = true;
/// <summary> /// <summary>
/// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。 /// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。
+1 -1
View File
@@ -80,7 +80,7 @@ namespace XericUI.XChart.Pseudo3D
} }
/// <summary>本元素的变换变了(或想强制重取空间)时调用</summary> /// <summary>本元素的变换变了(或想强制重取空间)时调用</summary>
public void MarkDirty() => m_Dirty = true; public override void MarkDirty() => m_Dirty = true;
/// <summary>线框定义立方体的面(发布 <c>mesh.face.*</c> 四角)⇒ 归定义组、最先跑(规范 §11.4)</summary> /// <summary>线框定义立方体的面(发布 <c>mesh.face.*</c> 四角)⇒ 归定义组、最先跑(规范 §11.4)</summary>
public override XChartToolCategory Category => XChartToolCategory.Definition; public override XChartToolCategory Category => XChartToolCategory.Definition;
@@ -156,7 +156,10 @@ namespace XericUI.XChart.Pseudo3D
} }
/// <summary>数据或变换变了(版本号比对才是真判据,这里只负责"再算一次")</summary> /// <summary>数据或变换变了(版本号比对才是真判据,这里只负责"再算一次")</summary>
public void MarkDataDirty() => m_PointsDirty = true; public override void MarkDirty() => m_PointsDirty = true;
/// <summary>旧名字:这个工具里"数据脏"和"参数脏"是同一个字段,所以留一个字段、两个名字</summary>
public void MarkDataDirty() => MarkDirty();
// ── 渲染 ────────────────────────────────────────────────── // ── 渲染 ──────────────────────────────────────────────────
+1 -1
View File
@@ -127,7 +127,7 @@ namespace XericUI.XChart.Radar
// ── 标记脏 ──────────────────────────────────────────────── // ── 标记脏 ────────────────────────────────────────────────
public void MarkDirty() public override void MarkDirty()
{ {
m_DataDirty = true; m_DataDirty = true;
} }
+1 -1
View File
@@ -71,7 +71,7 @@ namespace XericUI.XChart.Radar
} }
/// <summary>标记数据为脏(下次渲染时刷新)</summary> /// <summary>标记数据为脏(下次渲染时刷新)</summary>
public void MarkDirty() public override void MarkDirty()
{ {
m_DataDirty = true; m_DataDirty = true;
} }
+3
View File
@@ -67,6 +67,9 @@ namespace XericUI.XChart.Space
/// <summary>投影后的平移(图表局部像素)</summary> /// <summary>投影后的平移(图表局部像素)</summary>
public Vector2 Offset { get { EnsureProjection(); return m_Offset; } } public Vector2 Offset { get { EnsureProjection(); return m_Offset; } }
/// <summary>空间的"脏"只有投影这一件事:走同一条路,不自立第二个脏位</summary>
public override void MarkDirty() => MarkProjectionDirty();
public void MarkProjectionDirty() public void MarkProjectionDirty()
{ {
m_ProjectionDirty = true; m_ProjectionDirty = true;
+13
View File
@@ -90,6 +90,19 @@ namespace XericUI.XChart
IsInitialized = true; IsInitialized = true;
} }
// ── 脏位协议 ──────────────────────────────────────────────
/// <summary>
/// 让工具<b>下一帧重算几何</b>。所有公开旋钮的 setter 都要走它——这样"从外部写参数"
/// 就是"改完直接看得到",不必再记得补一句。
///
/// <para><b>为什么是 abstract 而不是"基类给个空实现"</b>:空实现的 <c>MarkDirty()</c>
/// 通过基类引用调用时<b>静默什么都不做</b>——参数改了、值也进去了、画面不动,
/// 报表里也看不出错("零要说出它零在哪一层"那一族)。抽象把这件事交给编译器:
/// 每个工具必须自己说清"我的脏位是哪一个字段"。</para>
/// </summary>
public abstract void MarkDirty();
// ── 生命周期 ────────────────────────────────────────────── // ── 生命周期 ──────────────────────────────────────────────
protected virtual void OnInitialize() { } protected virtual void OnInitialize() { }