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:
@@ -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;
|
||||||
|
|||||||
@@ -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()
|
||||||
{
|
{
|
||||||
|
|||||||
@@ -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>
|
||||||
|
|||||||
@@ -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。
|
||||||
|
|||||||
@@ -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();
|
||||||
|
|
||||||
// ── 渲染 ──────────────────────────────────────────────────
|
// ── 渲染 ──────────────────────────────────────────────────
|
||||||
|
|
||||||
|
|||||||
@@ -127,7 +127,7 @@ namespace XericUI.XChart.Radar
|
|||||||
|
|
||||||
// ── 标记脏 ────────────────────────────────────────────────
|
// ── 标记脏 ────────────────────────────────────────────────
|
||||||
|
|
||||||
public void MarkDirty()
|
public override void MarkDirty()
|
||||||
{
|
{
|
||||||
m_DataDirty = true;
|
m_DataDirty = true;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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;
|
||||||
|
|||||||
@@ -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() { }
|
||||||
|
|||||||
Reference in New Issue
Block a user