Files
XericUIActionVessel/Runtime/XChart/Space/ChartToolSpace.cs
T
lrss3 4272406330 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,纯算文件一个没动。
2026-10-26 09:02:13 +08:00

164 lines
8.1 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using UnityEngine;
using XericUI.Core;
using XericUI.XChart.Mesh;
namespace XericUI.XChart.Space
{
/// <summary>
/// 空间工具(<b>数据源工具</b>):一张图里<b>唯一</b>的"立方体局部空间 → 图表局部像素"权威。
///
/// <para><b>为什么要有它</b>:背景网格、线框、散点、轴线以前各算各的投影——同一份 pitch/yaw
/// 在两个类里各存一份、各推一遍,点就落不进盒子里。本工具把基变换收在一处,
/// 所有元素只问它要矩阵和面帧:<c>投影 = 基变换 ∘ 工具变换</c>,
/// 于是"点落在背景里"是结构保证,不是靠两边数值凑巧一致。</para>
///
/// <para><b>两档出口</b>:</para>
/// <list type="bullet">
/// <item><see cref="Compose"/>:基矩阵 × 工具矩阵,得到该工具用的仿射矩阵,
/// 交给 <see cref="XChartCubeGeometry.Project(Matrix4x4,float,Vector2,Vector3)"/> /
/// <see cref="XChartCubeGeometry.BuildFaceFrames"/> 复用同一套投影与面帧推导。</item>
/// <item><see cref="CubeToPixel"/> / <see cref="Offset"/>:需要自己换算长度或偏移的元素(轴线的
/// 刻度长度、标签的让位距离)用它们,不要各自再算一遍 scale。</item>
/// </list>
///
/// <para><b>版本号</b>:<see cref="ProjectionVersion"/> 在标记脏的那一刻递增,
/// 消费者拿它比对"要不要重新投影",不需要谁去清脏标记。</para>
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Space/Space Tool")]
public sealed class ChartToolSpace : XChartToolBase
{
/// <summary>图表自带的空间工具在管理器里的名字</summary>
public const string DefaultToolName = "Space";
/// <summary>空间是"投影权威":投影矩阵没算出来,谁也算不了 ⇒ 归定义组,最先跑(规范 §11.4)</summary>
public override XChartToolCategory Category => XChartToolCategory.Definition;
// ── 基变换 ────────────────────────────────────────────────
private Quaternion m_Rotation =
XChartCubeView.RotationOf(XChartCubeViewPreset.Isometric);
/// <summary>图表级姿态(四元数,唯一的旋转权威量)</summary>
public Quaternion Rotation { get => m_Rotation; set { m_Rotation = value; MarkDirty(); } }
private float m_HalfEdge = 120f;
/// <summary>半边长(UI 像素)</summary>
public float HalfEdge { get => m_HalfEdge; set { m_HalfEdge = value; MarkDirty(); } }
private XChartCubeSizeMode m_SizeMode = XChartCubeSizeMode.HalfEdgeLength;
/// <summary>尺寸口径(默认半边长:尺度不随旋转变化)</summary>
public XChartCubeSizeMode SizeMode { get => m_SizeMode; set { m_SizeMode = value; MarkDirty(); } }
private Vector2 m_CenterOffset;
/// <summary>立方体中心在图表局部像素里的偏移</summary>
public Vector2 CenterOffset { get => m_CenterOffset; set { m_CenterOffset = value; MarkDirty(); } }
// ── 派生状态 ──────────────────────────────────────────────
private Matrix4x4 m_Base;
private float m_Scale = 1f;
private Vector2 m_Offset;
private bool m_ProjectionDirty = true;
/// <summary>投影版本号(标记脏时递增)</summary>
public int ProjectionVersion { get; private set; }
/// <summary>基变换矩阵(纯旋转)</summary>
public Matrix4x4 BaseMatrix { get { EnsureProjection(); return m_Base; } }
/// <summary>立方体单位 → 像素的缩放(半边长口径下就等于 <see cref="HalfEdge"/>)</summary>
public float CubeToPixel { get { EnsureProjection(); return m_Scale; } }
/// <summary>投影后的平移(图表局部像素)</summary>
public Vector2 Offset { get { EnsureProjection(); return m_Offset; } }
/// <summary>空间的"脏"只有投影这一件事:走同一条路,不自立第二个脏位</summary>
public override void MarkDirty() => MarkProjectionDirty();
public void MarkProjectionDirty()
{
m_ProjectionDirty = true;
ProjectionVersion++;
}
private void EnsureProjection()
{
if (!m_ProjectionDirty) return;
m_ProjectionDirty = false;
m_Base = XChartCubeView.ToMatrix(Rotation);
XChartCubeView.ComputeProjection(m_Base, HalfEdge, CenterOffset, SizeMode, out m_Scale, out m_Offset);
}
// ── 出口 ──────────────────────────────────────────────────
/// <summary>基变换 ∘ 工具变换(<paramref name="tool"/> 为恒等时就只剩基矩阵)</summary>
public Matrix4x4 Compose(XChartToolTransform tool)
{
EnsureProjection();
return tool.IsIdentity ? m_Base : XChartCubeView.Compose(m_Base, tool.Build());
}
/// <summary>立方体局部点 → 图表局部像素(带工具变换)</summary>
public Vector2 Project(Vector3 cubePoint, Matrix4x4 composed)
{
EnsureProjection();
return XChartCubeGeometry.Project(composed, m_Scale, m_Offset, cubePoint);
}
/// <summary>立方体局部点 → 图表局部像素(只用基变换)</summary>
public Vector2 Project(Vector3 cubePoint)
{
EnsureProjection();
return XChartCubeGeometry.Project(m_Base, m_Scale, m_Offset, cubePoint);
}
/// <summary>深度(越大越靠近观察者),用来做画家序</summary>
public float DepthOf(Vector3 cubePoint, Matrix4x4 composed)
{
EnsureProjection();
return composed.MultiplyPoint3x4(cubePoint).z;
}
/// <summary>六个面帧(<paramref name="output"/> 长度至少 6;顺序同 <see cref="XChartCubeGeometry.CubeFace"/>)</summary>
public void BuildFaceFrames(XChartFaceFrame[] output, Matrix4x4 composed)
{
EnsureProjection();
XChartCubeGeometry.BuildFaceFrames(composed, m_Scale, m_Offset, output);
}
/// <summary>六个面帧(只用基变换)</summary>
public void BuildFaceFrames(XChartFaceFrame[] output)
{
EnsureProjection();
XChartCubeGeometry.BuildFaceFrames(m_Base, m_Scale, m_Offset, output);
}
/// <summary>某个面是否朝向观察者。注意:法线是按矩阵的线性部分转的,
/// 工具带<b>非等比缩放</b>时这只是近似(立方体场景里够用,别拿它判曲面)。</summary>
public bool IsFaceVisible(XChartCubeGeometry.CubeFace face, Matrix4x4 composed)
=> XChartCubeGeometry.IsFaceVisible(composed, face);
public bool IsFaceVisible(XChartCubeGeometry.CubeFace face)
{
EnsureProjection();
return XChartCubeGeometry.IsFaceVisible(m_Base, face);
}
// ── 数据域 → 立方体域 ─────────────────────────────────────
/// <summary>
/// 归一化数据(每维 [0,1])→ 立方体局部点([-1,1])。
/// 数据元素统一走这一条,保证"0.5 就是立方体中间"这件事只有一处定义。
/// </summary>
public static Vector3 NormalizedToCube(Vector3 zeroOne)
=> new Vector3(zeroOne.x * 2f - 1f, zeroOne.y * 2f - 1f, zeroOne.z * 2f - 1f);
protected override void OnInitialize()
{
// 空间本身不画东西:它只是别的元素的坐标系。节点仍然要建,
// 因为元素的兄弟序(= 绘制序)里得有它占的那一格
SetVisible(true);
MarkProjectionDirty();
}
}
}