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,纯算文件一个没动。
This commit is contained in:
2026-10-26 09:02:13 +08:00
parent 71629c08bf
commit 4272406330
9 changed files with 245 additions and 123 deletions
+50 -25
View File
@@ -30,55 +30,80 @@ namespace XericUI.XChart.Mesh
{
// ── 几何(立方体单位,±1 就是盒子边界) ───────────────────
public Vector3 Start { get; set; } = new Vector3(-0.6f, -0.6f, -0.6f);
public Vector3 End { get; set; } = new Vector3(0.6f, 0.6f, 0.6f);
public float Radius { get; set; } = 0.22f;
public int SegmentCount { get; set; } = 48;
private Vector3 m_Start = new Vector3(-0.6f, -0.6f, -0.6f);
public Vector3 Start { get => m_Start; set { m_Start = value; MarkDirty(); } }
private Vector3 m_End = new Vector3(0.6f, 0.6f, 0.6f);
public Vector3 End { get => m_End; set { m_End = value; MarkDirty(); } }
private float m_Radius = 0.22f;
public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }
private int m_SegmentCount = 48;
public int SegmentCount { get => m_SegmentCount; set { m_SegmentCount = value; MarkDirty(); } }
private Vector3 m_StartNormal;
/// <summary>起点端面的法线。<b>零向量=沿两端连线</b>(与旧行为一致)</summary>
public Vector3 StartNormal { get; set; }
public Vector3 StartNormal { get => m_StartNormal; set { m_StartNormal = value; MarkDirty(); } }
private Vector3 m_EndNormal;
/// <summary>终点端面的法线。零向量=沿两端连线</summary>
public Vector3 EndNormal { get; set; }
public Vector3 EndNormal { get => m_EndNormal; set { m_EndNormal = value; MarkDirty(); } }
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
/// <summary>圆柱自己的变换(叠在图的空间之上)</summary>
public XChartToolTransform Transform { get; set; } = XChartToolTransform.Identity;
public XChartToolTransform Transform { get => m_Transform; set { m_Transform = value; MarkDirty(); } }
// ── 几何来源:常量 / 数据(一组记录一根圆柱) ──
private bool m_DriveByData;
/// <summary>关=用 <see cref="Start"/>/<see cref="End"/> 的常量坐标;开=从数据源取</summary>
public bool DriveByData { get; set; }
public int DimensionX { get; set; }
public int DimensionY { get; set; } = 1;
public int DimensionZ { get; set; } = 2;
public bool DriveByData { get => m_DriveByData; set { m_DriveByData = value; MarkDirty(); } }
private int m_DimensionX;
public int DimensionX { get => m_DimensionX; set { m_DimensionX = value; MarkDirty(); } }
private int m_DimensionY = 1;
public int DimensionY { get => m_DimensionY; set { m_DimensionY = value; MarkDirty(); } }
private int m_DimensionZ = 2;
public int DimensionZ { get => m_DimensionZ; set { m_DimensionZ = value; MarkDirty(); } }
private int m_GroupSize = 2;
/// <summary>几条记录凑一根圆柱;2=两两一组(记录 0-1、2-3…,不重叠也不并入上一组)</summary>
public int GroupSize { get; set; } = 2;
public int GroupSize { get => m_GroupSize; set { m_GroupSize = value; MarkDirty(); } }
private int m_MaxCylinders = 64;
/// <summary>最多画几根</summary>
public int MaxCylinders { get; set; } = 64;
public int MaxCylinders { get => m_MaxCylinders; set { m_MaxCylinders = value; MarkDirty(); } }
// ── 呈现(各有开关) ──────────────────────────────────────
private bool m_ShowOutline = true;
/// <summary>外轮廓包边</summary>
public bool ShowOutline { get; set; } = true;
public Color OutlineColor { get; set; } = new Color(0.75f, 0.85f, 1f, 0.9f);
public float OutlineThickness { get; set; } = 2f;
public bool ShowOutline { get => m_ShowOutline; set { m_ShowOutline = value; MarkDirty(); } }
private Color m_OutlineColor = new Color(0.75f, 0.85f, 1f, 0.9f);
public Color OutlineColor { get => m_OutlineColor; set { m_OutlineColor = value; MarkDirty(); } }
private float m_OutlineThickness = 2f;
public float OutlineThickness { get => m_OutlineThickness; set { m_OutlineThickness = value; MarkDirty(); } }
private bool m_ShowFill = true;
/// <summary>轮廓填充(同一个凸包多边形)</summary>
public bool ShowFill { get; set; } = true;
public Color FillColor { get; set; } = new Color(0.34f, 0.55f, 0.85f, 0.35f);
public bool ShowFill { get => m_ShowFill; set { m_ShowFill = value; MarkDirty(); } }
private Color m_FillColor = new Color(0.34f, 0.55f, 0.85f, 0.35f);
public Color FillColor { get => m_FillColor; set { m_FillColor = value; MarkDirty(); } }
private bool m_ShowCapCross;
/// <summary>端面十字:用端面自己的采样顶点连,所以它**永远与实际端面对得上**,能看出滚转</summary>
public bool ShowCapCross { get; set; }
public Color CrossColor { get; set; } = new Color(0.9f, 0.95f, 1f, 0.85f);
public float CrossThickness { get; set; } = 1.5f;
public bool ShowCapCross { get => m_ShowCapCross; set { m_ShowCapCross = value; MarkDirty(); } }
private Color m_CrossColor = new Color(0.9f, 0.95f, 1f, 0.85f);
public Color CrossColor { get => m_CrossColor; set { m_CrossColor = value; MarkDirty(); } }
private float m_CrossThickness = 1.5f;
public float CrossThickness { get => m_CrossThickness; set { m_CrossThickness = value; MarkDirty(); } }
private bool m_ShowStartRing;
/// <summary>起点端面的闭合圆环(画满一整圈端面椭圆,=端面自己的边界)</summary>
public bool ShowStartRing { get; set; }
public bool ShowStartRing { get => m_ShowStartRing; set { m_ShowStartRing = value; MarkDirty(); } }
private bool m_ShowEndRing;
/// <summary>终点端面的闭合圆环</summary>
public bool ShowEndRing { get; set; }
public bool ShowEndRing { get => m_ShowEndRing; set { m_ShowEndRing = value; MarkDirty(); } }
private int m_GeneratrixCount;
/// <summary>内部母线数量(把两端对应点连起来;0=不画)。<b>默认 0</b>:轮廓之外的东西要显式要</summary>
public int GeneratrixCount { get; set; }
public Color GeneratrixColor { get; set; } = new Color(0.75f, 0.85f, 1f, 0.35f);
public int GeneratrixCount { get => m_GeneratrixCount; set { m_GeneratrixCount = value; MarkDirty(); } }
private Color m_GeneratrixColor = new Color(0.75f, 0.85f, 1f, 0.35f);
public Color GeneratrixColor { get => m_GeneratrixColor; set { m_GeneratrixColor = value; MarkDirty(); } }
// ── 内部 ──────────────────────────────────────────────────