From 71629c08bf678ef3a8f1e803fa70ef09e654b36d Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Mon, 26 Oct 2026 08:49:34 +0800 Subject: [PATCH] =?UTF-8?q?XChart=20P20a=EF=BC=9AMarkDirty=20=E5=8D=87?= =?UTF-8?q?=E6=88=90=E5=9F=BA=E7=B1=BB=E6=8A=BD=E8=B1=A1=E2=80=94=E2=80=94?= =?UTF-8?q?=E7=BD=AE=E8=84=8F=E8=BF=99=E4=BB=B6=E4=BA=8B=E4=B8=8D=E8=AE=B8?= =?UTF-8?q?=E6=9C=89=E9=9D=99=E9=BB=98=E7=A9=BA=E5=AE=9E=E7=8E=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 外部按参数驱动渲染这条路要通了,第一步是把"脏位"从各工具的私有约定升成基类协议: 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 自动置脏在下一笔。 --- Runtime/XChart/Axis/ChartToolAxis.cs | 2 +- Runtime/XChart/Mesh/ChartToolCylinder.cs | 2 +- Runtime/XChart/Mesh/ChartToolMeshBg.cs | 2 +- Runtime/XChart/Mesh/ChartToolVectorArrows.cs | 2 +- Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs | 2 +- Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs | 5 ++++- Runtime/XChart/Radar/ChartToolRadarBg.cs | 2 +- Runtime/XChart/Radar/ChartToolRadarData.cs | 2 +- Runtime/XChart/Space/ChartToolSpace.cs | 3 +++ Runtime/XChart/XChartToolBase.cs | 13 +++++++++++++ 10 files changed, 27 insertions(+), 8 deletions(-) diff --git a/Runtime/XChart/Axis/ChartToolAxis.cs b/Runtime/XChart/Axis/ChartToolAxis.cs index c36f503..4e780e8 100644 --- a/Runtime/XChart/Axis/ChartToolAxis.cs +++ b/Runtime/XChart/Axis/ChartToolAxis.cs @@ -182,7 +182,7 @@ namespace XericUI.XChart.Axis private double m_RangeMax = 1.0; private double m_RangeStep = 1.0; - public void MarkDirty() + public override void MarkDirty() { m_RangeDirty = true; m_GeometryDirty = true; diff --git a/Runtime/XChart/Mesh/ChartToolCylinder.cs b/Runtime/XChart/Mesh/ChartToolCylinder.cs index 7ba5cd7..b55bc67 100644 --- a/Runtime/XChart/Mesh/ChartToolCylinder.cs +++ b/Runtime/XChart/Mesh/ChartToolCylinder.cs @@ -122,7 +122,7 @@ namespace XericUI.XChart.Mesh /// 本帧几何是怎么来的(报表用):literal / data(groups …) / data-skipped(原因) private string m_GeometryNote = "literal"; - public void MarkDirty() => m_Dirty = true; + public override void MarkDirty() => m_Dirty = true; protected override void OnInitialize() { diff --git a/Runtime/XChart/Mesh/ChartToolMeshBg.cs b/Runtime/XChart/Mesh/ChartToolMeshBg.cs index e1cd817..d804f3d 100644 --- a/Runtime/XChart/Mesh/ChartToolMeshBg.cs +++ b/Runtime/XChart/Mesh/ChartToolMeshBg.cs @@ -137,7 +137,7 @@ namespace XericUI.XChart.Mesh public int GridDimensionT { get; set; } = -1; /// 本元素的变换变了(或想强制重取空间)时调用 - public void MarkDirty() => m_Dirty = true; + public override void MarkDirty() => m_Dirty = true; /// 本工具定义网格(发布面/格线插槽、算范围)⇒ 归定义组、最先跑(规范 §11.4); /// 它"画在底下"这件事由绘制序(默认最小)表达,与分组无关 diff --git a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs index 6200127..3a1d05f 100644 --- a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs +++ b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs @@ -121,7 +121,7 @@ namespace XericUI.XChart.Mesh private static readonly Comparison s_FarToNear = (left, right) => left.Depth.CompareTo(right.Depth); - public void MarkDirty() => m_Dirty = true; + public override void MarkDirty() => m_Dirty = true; /// /// 这个元素要几个数值维:坐标 3 +(可选)颜色 3。 diff --git a/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs b/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs index 72a3243..b0d55d5 100644 --- a/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs +++ b/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs @@ -80,7 +80,7 @@ namespace XericUI.XChart.Pseudo3D } /// 本元素的变换变了(或想强制重取空间)时调用 - public void MarkDirty() => m_Dirty = true; + public override void MarkDirty() => m_Dirty = true; /// 线框定义立方体的面(发布 mesh.face.* 四角)⇒ 归定义组、最先跑(规范 §11.4) public override XChartToolCategory Category => XChartToolCategory.Definition; diff --git a/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs b/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs index 4411c8d..d9bf96b 100644 --- a/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs +++ b/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs @@ -156,7 +156,10 @@ namespace XericUI.XChart.Pseudo3D } /// 数据或变换变了(版本号比对才是真判据,这里只负责"再算一次") - public void MarkDataDirty() => m_PointsDirty = true; + public override void MarkDirty() => m_PointsDirty = true; + + /// 旧名字:这个工具里"数据脏"和"参数脏"是同一个字段,所以留一个字段、两个名字 + public void MarkDataDirty() => MarkDirty(); // ── 渲染 ────────────────────────────────────────────────── diff --git a/Runtime/XChart/Radar/ChartToolRadarBg.cs b/Runtime/XChart/Radar/ChartToolRadarBg.cs index 8c91437..27caaca 100644 --- a/Runtime/XChart/Radar/ChartToolRadarBg.cs +++ b/Runtime/XChart/Radar/ChartToolRadarBg.cs @@ -127,7 +127,7 @@ namespace XericUI.XChart.Radar // ── 标记脏 ──────────────────────────────────────────────── - public void MarkDirty() + public override void MarkDirty() { m_DataDirty = true; } diff --git a/Runtime/XChart/Radar/ChartToolRadarData.cs b/Runtime/XChart/Radar/ChartToolRadarData.cs index 4fb3b5e..54fdfcb 100644 --- a/Runtime/XChart/Radar/ChartToolRadarData.cs +++ b/Runtime/XChart/Radar/ChartToolRadarData.cs @@ -71,7 +71,7 @@ namespace XericUI.XChart.Radar } /// 标记数据为脏(下次渲染时刷新) - public void MarkDirty() + public override void MarkDirty() { m_DataDirty = true; } diff --git a/Runtime/XChart/Space/ChartToolSpace.cs b/Runtime/XChart/Space/ChartToolSpace.cs index ffa031a..f30d4b8 100644 --- a/Runtime/XChart/Space/ChartToolSpace.cs +++ b/Runtime/XChart/Space/ChartToolSpace.cs @@ -67,6 +67,9 @@ namespace XericUI.XChart.Space /// 投影后的平移(图表局部像素) public Vector2 Offset { get { EnsureProjection(); return m_Offset; } } + /// 空间的"脏"只有投影这一件事:走同一条路,不自立第二个脏位 + public override void MarkDirty() => MarkProjectionDirty(); + public void MarkProjectionDirty() { m_ProjectionDirty = true; diff --git a/Runtime/XChart/XChartToolBase.cs b/Runtime/XChart/XChartToolBase.cs index 1d986f9..7ba7877 100644 --- a/Runtime/XChart/XChartToolBase.cs +++ b/Runtime/XChart/XChartToolBase.cs @@ -90,6 +90,19 @@ namespace XericUI.XChart IsInitialized = true; } + // ── 脏位协议 ────────────────────────────────────────────── + + /// + /// 让工具下一帧重算几何。所有公开旋钮的 setter 都要走它——这样"从外部写参数" + /// 就是"改完直接看得到",不必再记得补一句。 + /// + /// 为什么是 abstract 而不是"基类给个空实现":空实现的 MarkDirty() + /// 通过基类引用调用时静默什么都不做——参数改了、值也进去了、画面不动, + /// 报表里也看不出错("零要说出它零在哪一层"那一族)。抽象把这件事交给编译器: + /// 每个工具必须自己说清"我的脏位是哪一个字段"。 + /// + public abstract void MarkDirty(); + // ── 生命周期 ────────────────────────────────────────────── protected virtual void OnInitialize() { }