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(); } }
// ── 内部 ──────────────────────────────────────────────────
+30 -15
View File
@@ -27,56 +27,69 @@ namespace XericUI.XChart.Mesh
{
// ── 工具变换(在图的空间之上再叠一层) ────────────────────
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 XChartCubeFaceMask m_FillFaces = XChartCubeFaceMask.None;
/// <summary>要填充哪些面</summary>
public XChartCubeFaceMask FillFaces { get; set; } = XChartCubeFaceMask.None;
public XChartCubeFaceMask FillFaces { get => m_FillFaces; set { m_FillFaces = value; MarkDirty(); } }
private Color m_FillColor = new Color(0.16f, 0.19f, 0.24f, 0.85f);
/// <summary>填充色(面边缘)</summary>
public Color FillColor { get; set; } = new Color(0.16f, 0.19f, 0.24f, 0.85f);
public Color FillColor { get => m_FillColor; set { m_FillColor = value; MarkDirty(); } }
private Color m_FillCenterColor = new Color(0.16f, 0.19f, 0.24f, 0.85f);
/// <summary>填充面中心色;与 <see cref="FillColor"/> 不同时走径向渐变</summary>
public Color FillCenterColor { get; set; } = new Color(0.16f, 0.19f, 0.24f, 0.85f);
public Color FillCenterColor { get => m_FillCenterColor; set { m_FillCenterColor = value; MarkDirty(); } }
// ── 面内网格 ──────────────────────────────────────────────
private XChartCubeFaceMask m_GridFaces = XChartCubeFaceMask.None;
/// <summary>要画网格的面</summary>
public XChartCubeFaceMask GridFaces { get; set; } = XChartCubeFaceMask.None;
public XChartCubeFaceMask GridFaces { get => m_GridFaces; set { m_GridFaces = value; MarkDirty(); } }
private Color m_GridColor = new Color(0.55f, 0.6f, 0.7f, 0.35f);
/// <summary>网格线颜色</summary>
public Color GridColor { get; set; } = new Color(0.55f, 0.6f, 0.7f, 0.35f);
public Color GridColor { get => m_GridColor; set { m_GridColor = value; MarkDirty(); } }
private float m_GridThickness = 1f;
/// <summary>网格线宽</summary>
public float GridThickness { get; set; } = 1f;
public float GridThickness { get => m_GridThickness; set { m_GridThickness = value; MarkDirty(); } }
private int m_GridDivisions = 5;
/// <summary>每个方向的网格分割数(统一值;S/T 各自给了正数时按各自的来)</summary>
public int GridDivisions { get; set; } = 5;
public int GridDivisions { get => m_GridDivisions; set { m_GridDivisions = value; MarkDirty(); } }
private int m_GridDivisionsS;
/// <summary>S 方向分格数。0=跟随 <see cref="GridDivisions"/>。
/// 等分时"沿 S 的线由 T 的分格数决定"(算式在 <see cref="XChartGridDivisions"/>,探针钉着);
/// 绑了维度时这个数是<b>那一族线的目标刻度条数</b>(不是分格数,规范 §22)。</summary>
public int GridDivisionsS { get; set; }
public int GridDivisionsS { get => m_GridDivisionsS; set { m_GridDivisionsS = value; MarkDirty(); } }
private int m_GridDivisionsT;
/// <summary>T 方向分格数。0=跟随 <see cref="GridDivisions"/></summary>
public int GridDivisionsT { get; set; }
public int GridDivisionsT { get => m_GridDivisionsT; set { m_GridDivisionsT = value; MarkDirty(); } }
private bool m_ShowFaceOutline = true;
/// <summary>是否同时描出面轮廓(没有线框元素时也能看清面的边界)</summary>
public bool ShowFaceOutline { get; set; } = true;
public bool ShowFaceOutline { get => m_ShowFaceOutline; set { m_ShowFaceOutline = value; MarkDirty(); } }
private bool m_OnlyVisibleFaces;
/// <summary>
/// 只画朝向观察者的面。默认 false——背景网格本就常画在背朝观察者的那几面(后墙/底面);
/// 想要"实体盒子"的观感时打开它。
/// </summary>
public bool OnlyVisibleFaces { get; set; }
public bool OnlyVisibleFaces { get => m_OnlyVisibleFaces; set { m_OnlyVisibleFaces = value; MarkDirty(); } }
private Color m_OutlineColor = new Color(0.7f, 0.75f, 0.85f, 0.6f);
/// <summary>网格与轮廓的颜色与线宽(轮廓更实一点)</summary>
public Color OutlineColor { get; set; } = new Color(0.7f, 0.75f, 0.85f, 0.6f);
public Color OutlineColor { get => m_OutlineColor; set { m_OutlineColor = value; MarkDirty(); } }
// ── 内部组件 ──────────────────────────────────────────────
@@ -130,11 +143,13 @@ namespace XericUI.XChart.Mesh
private float[] m_RatioScratchT;
private readonly List<double> m_TickScratch = new List<double>();
private int m_GridDimensionS = -1;
/// <summary>沿 S 的线绑哪一维(&lt;0 = 不绑,等分)</summary>
public int GridDimensionS { get; set; } = -1;
public int GridDimensionS { get => m_GridDimensionS; set { m_GridDimensionS = value; MarkDirty(); } }
private int m_GridDimensionT = -1;
/// <summary>沿 T 的线绑哪一维(&lt;0 = 不绑,等分)</summary>
public int GridDimensionT { get; set; } = -1;
public int GridDimensionT { get => m_GridDimensionT; set { m_GridDimensionT = value; MarkDirty(); } }
/// <summary>本元素的变换变了(或想强制重取空间)时调用</summary>
public override void MarkDirty() => m_Dirty = true;
+32 -16
View File
@@ -33,35 +33,49 @@ namespace XericUI.XChart.Mesh
[AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Vector Arrow Tool")]
public sealed class ChartToolVectorArrows : XChartToolBase
{
private int m_CoordinateDimension;
/// <summary>坐标的维度下标(x/y/z 三维)</summary>
public int CoordinateDimension { get; set; }
public int CoordinateDimension { get => m_CoordinateDimension; set { m_CoordinateDimension = value; MarkDirty(); } }
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
/// <summary>第二条记录怎么读成方向</summary>
public XChartArrowVectorMode VectorMode { get; set; } = XChartArrowVectorMode.Absolute;
public XChartArrowVectorMode VectorMode { get => m_VectorMode; set { m_VectorMode = value; MarkDirty(); } }
private bool m_Continuous;
/// <summary>把每条记录的坐标按顺序连成折线(此时相对/绝对不适用)</summary>
public bool Continuous { get; set; }
public bool Continuous { get => m_Continuous; set { m_Continuous = value; MarkDirty(); } }
private float m_DirectionScale = 0.25f;
/// <summary>方向向量的长度倍率(立方体单位);相对模式下作用在差向量上</summary>
public float DirectionScale { get; set; } = 0.25f;
public float DirectionScale { get => m_DirectionScale; set { m_DirectionScale = value; MarkDirty(); } }
private int m_MaxArrowCount = 512;
/// <summary>最多画多少支(一支=相邻两条记录)</summary>
public int MaxArrowCount { get; set; } = 512;
public int MaxArrowCount { get => m_MaxArrowCount; set { m_MaxArrowCount = 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_UseColorDimensions;
/// <summary>是否用额外的数值维给每支箭头上色</summary>
public bool UseColorDimensions { get; set; }
public bool UseColorDimensions { get => m_UseColorDimensions; set { m_UseColorDimensions = value; MarkDirty(); } }
private int m_ColorDimension = 3;
/// <summary>颜色维的起点(色相、饱和度、明度 [+不透明度])</summary>
public int ColorDimension { get; set; } = 3;
public int ColorDimension { get => m_ColorDimension; set { m_ColorDimension = value; MarkDirty(); } }
private bool m_HasAlphaDimension;
/// <summary>是否多读一维不透明度</summary>
public bool HasAlphaDimension { get; set; }
public bool HasAlphaDimension { get => m_HasAlphaDimension; set { m_HasAlphaDimension = value; MarkDirty(); } }
public Color ArrowColor { get; set; } = new Color(0.95f, 0.6f, 0.25f, 0.9f);
public float ShaftWidth { get; set; } = 2f;
public float HeadLength { get; set; } = 10f;
public float HeadWidth { get; set; } = 7f;
private Color m_ArrowColor = new Color(0.95f, 0.6f, 0.25f, 0.9f);
public Color ArrowColor { get => m_ArrowColor; set { m_ArrowColor = value; MarkDirty(); } }
private float m_ShaftWidth = 2f;
public float ShaftWidth { get => m_ShaftWidth; set { m_ShaftWidth = value; MarkDirty(); } }
private float m_HeadLength = 10f;
public float HeadLength { get => m_HeadLength; set { m_HeadLength = value; MarkDirty(); } }
private float m_HeadWidth = 7f;
public float HeadWidth { get => m_HeadWidth; set { m_HeadWidth = value; MarkDirty(); } }
private bool m_ShowZeroVectorsAsDots;
/// <summary>方向为零向量时什么都不画;给个数就画成一个点</summary>
public bool ShowZeroVectorsAsDots { get; set; }
public bool ShowZeroVectorsAsDots { get => m_ShowZeroVectorsAsDots; set { m_ShowZeroVectorsAsDots = value; MarkDirty(); } }
public XChartMeshFillRenderer FillRenderer { get; private set; }
@@ -71,15 +85,17 @@ namespace XericUI.XChart.Mesh
/// </summary>
public UICurveRenderer CurveRenderer { get; private set; }
private float m_HeadPosition = 1f;
/// <summary>
/// 连续绘制时<b>画到路径的哪个位置</b>(0=起点、1=整条,默认 1):
/// 箭头就放在这一处,路径在这一点被剪断(剪口之后不画)——
/// 不剪的话路径会从箭头底下穿出去,看着像"箭头朝里长"。
/// </summary>
public float HeadPosition { get; set; } = 1f;
public float HeadPosition { get => m_HeadPosition; set { m_HeadPosition = value; MarkDirty(); } }
private int m_PathSegments = 12;
/// <summary>连续绘制时每段贝塞尔细分成几节(曲线渲染器的 tessellation)</summary>
public int PathSegments { get; set; } = 12;
public int PathSegments { get => m_PathSegments; set { m_PathSegments = value; MarkDirty(); } }
private readonly List<Vector2> m_Pixels = new List<Vector2>(64);
private string m_PathRenderer = "-";