Files
XericUIActionVessel/Runtime/XChart/Pseudo3D/ChartToolCubeBg.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

267 lines
13 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 System.Collections.Generic;
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using XericUI.XChart.Mesh;
using XericUI.XChart.Space;
using XericUI.Core;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 伪 3D 立方体<b>线框</b>工具(元素显示名 <c>BG Cube Wire</c>)。
///
/// <para>它只做两件事:<b>12 条棱</b>(相邻面里只要有一个朝向观察者就算前向棱,与面用同一套
/// 可见性口径)+ <b>把六个面发布成 <c>mesh.face.&lt;n&gt;</c> 插槽</b>(供轴线/散点取几何)。
/// 它<b>不画面内格线、也不发布格线插槽</b>——那是 <c>BG Cube Grid</c>
/// (<see cref="ChartToolMeshBg"/>)作为唯一作者的活(规范 §22)。上一版两边都画格线、还都往
/// 同一批插槽 id 上发布,于是"关掉一边、另一边又把线显示回来",看起来就像开关反了
/// (他 2026-10-25 现场报的两条症状是同一个结构问题的两个面)。</para>
///
/// 几何与投影全部来自 <see cref="XChartCubeGeometry"/> 与 <see cref="XChartCubeView"/>,
/// 投影权威来自 <see cref="ChartToolSpace"/>(本类不自带顶点/面/棱表,也不自己算投影):
/// <see cref="ComposedMatrix"/> / <see cref="Space"/> 是对外的投影出口,
/// 数据类工具靠它对齐到同一空间。
///
/// <para><b>旋转是一个四元数,不是两轴角度</b>;<b>尺寸是半边长</b>,默认口径下它不随旋转变化
/// (旧版按投影包围盒 fit,转起来会越转越小)。理由与换算见 <see cref="XChartCubeView"/>。</para>
///
/// 子节点结构:<c>[BG Cube Wire] → CubeEdgeRenderer (UILineRendererV2)</c>
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Cube Wire Background Tool")]
public class ChartToolCubeBg : XChartToolBase
{
// ── 外观配置 ──────────────────────────────────────────────
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
/// <summary>线框自己的变换(立方体局部单位);默认恒等,即和图的空间重合</summary>
public XChartToolTransform Transform { get => m_Transform; set { m_Transform = value; MarkDirty(); } }
private Color m_FrontEdgeColor = new Color(0.7f, 0.7f, 0.7f, 1f);
/// <summary>前向棱颜色</summary>
public Color FrontEdgeColor { get => m_FrontEdgeColor; set { m_FrontEdgeColor = value; MarkDirty(); } }
private Color m_BackEdgeColor = new Color(0.4f, 0.4f, 0.4f, 0.4f);
/// <summary>后向棱颜色</summary>
public Color BackEdgeColor { get => m_BackEdgeColor; set { m_BackEdgeColor = value; MarkDirty(); } }
private float m_EdgeThickness = 2f;
/// <summary>棱线宽度</summary>
public float EdgeThickness { get => m_EdgeThickness; set { m_EdgeThickness = value; MarkDirty(); } }
private bool m_ShowBackEdges = true;
/// <summary>是否显示后向棱</summary>
public bool ShowBackEdges { get => m_ShowBackEdges; set { m_ShowBackEdges = value; MarkDirty(); } }
// ── 内部组件 ──────────────────────────────────────────────
/// <summary>棱线渲染器</summary>
public UILineRendererV2 EdgeRenderer { get; private set; }
// ── 投影状态 ──────────────────────────────────────────────
private readonly XChartFaceFrame[] m_FaceFrames = new XChartFaceFrame[XChartCubeGeometry.FaceCount];
private readonly List<LineVertexData> m_FrontEdges = new List<LineVertexData>(24);
private readonly List<LineVertexData> m_BackEdges = new List<LineVertexData>(24);
private ChartToolSpace m_Space;
private Matrix4x4 m_Composed = Matrix4x4.identity;
private int m_LastSpaceVersion = -1;
private bool m_Dirty = true;
/// <summary>发布插槽用的复用缓冲(一个面的四角 = 12 个值)</summary>
private readonly float[] m_SlotValues = new float[12];
// 本帧提交了多少:线框"整块不见了"要能分清是没空间、没提交还是提交了 0 条
private int m_EdgesDrawn;
private int m_FacesPublished;
// ── 对外出口 ──────────────────────────────────────────────
/// <summary>六个可见性判定共用的面帧(图表局部像素)</summary>
public XChartFaceFrame GetFaceFrame(XChartCubeGeometry.CubeFace face)
{
UpdateProjection();
return m_FaceFrames[(int)face];
}
/// <summary>本元素的变换变了(或想强制重取空间)时调用</summary>
public override void MarkDirty() => m_Dirty = true;
/// <summary>线框定义立方体的面(发布 <c>mesh.face.*</c> 四角)⇒ 归定义组、最先跑(规范 §11.4)</summary>
public override XChartToolCategory Category => XChartToolCategory.Definition;
/// <summary>线框用的复合矩阵。数据元素要落到同一个空间就问它要,别自己再算一遍</summary>
public Matrix4x4 ComposedMatrix { get { UpdateProjection(); return m_Composed; } }
/// <summary>空间工具(投影权威)。渲染时现找,所以注册先后顺序不影响正确性</summary>
public ChartToolSpace Space
{
get
{
m_Space = Context?.Space;
return m_Space;
}
}
// ── 插槽发布 ──────────────────────────────────────────────
/// <summary>
/// 把六个面发布成 <c>Quad3D</c> 插槽:<b>用哪个网格元素都得能供面给轴线</b>,
/// 否则"轴线跟随网格"会因为图里只放了线框而静默回落(报表里 <c>frame=cube</c> 就是那个信号)。
/// 只发四角、不发格线:格线由画它的那个元素发布(两个发布者会抢同一批 id,见规范 §22)。
/// </summary>
private void PublishFaceSlots()
{
IXChartSlotBoard board = Context?.Slots;
m_FacesPublished = 0;
if (board == null) return;
for (int i = 0; i < XChartCubeGeometry.FaceCount; i++)
{
var face = (XChartCubeGeometry.CubeFace)i;
Vector3 c00, c01, c11, c10;
XChartCubeGeometry.GetFaceCorners(face, out c00, out c01, out c11, out c10);
m_SlotValues[0] = c00.x; m_SlotValues[1] = c00.y; m_SlotValues[2] = c00.z;
m_SlotValues[3] = c01.x; m_SlotValues[4] = c01.y; m_SlotValues[5] = c01.z;
m_SlotValues[6] = c11.x; m_SlotValues[7] = c11.y; m_SlotValues[8] = c11.z;
m_SlotValues[9] = c10.x; m_SlotValues[10] = c10.y; m_SlotValues[11] = c10.z;
board.Publish(XChartCubeGeometry.FaceSlotId(face), XChartSlotMode.Quad3D,
XChartSlotAccess.ReadOnly, m_SlotValues, out string _);
m_FacesPublished++;
}
}
// ── 初始化 ────────────────────────────────────────────────
protected override void OnInitialize()
{
EdgeRenderer = CreateChildComponent<UILineRendererV2>("CubeEdgeRenderer");
if (EdgeRenderer != null)
{
EdgeRenderer.defaultColor = FrontEdgeColor;
EdgeRenderer.defaultThickness = EdgeThickness;
StretchToRoot(EdgeRenderer);
}
SetVisible(true);
}
private static void StretchToRoot(UILineRendererV2 renderer)
{
var rt = renderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
// ── 投影 ──────────────────────────────────────────────────
private void UpdateProjection()
{
var space = Space;
if (space == null) return;
if (!m_Dirty && space.ProjectionVersion == m_LastSpaceVersion) return;
m_Dirty = false;
m_LastSpaceVersion = space.ProjectionVersion;
m_Composed = space.Compose(Transform);
space.BuildFaceFrames(m_FaceFrames, m_Composed);
PublishFaceSlots();
}
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
{
base.OnRender();
if (EdgeRenderer == null) return;
UpdateProjection();
DrawEdges();
}
private void DrawEdges()
{
EdgeRenderer.ClearAll();
m_FrontEdges.Clear();
m_BackEdges.Clear();
m_EdgesDrawn = 0;
for (int e = 0; e < XChartCubeGeometry.EdgeCount; e++)
{
bool isFront = XChartCubeGeometry.IsEdgeVisible(m_Composed, e);
var list = isFront ? m_FrontEdges : m_BackEdges;
Color color = isFront ? FrontEdgeColor : BackEdgeColor;
list.Add(new LineVertexData
{
position = Space.Project(XChartCubeGeometry.Vertices[XChartCubeGeometry.Edges[e, 0]], m_Composed),
color = color,
thickness = EdgeThickness,
userData = Vector4.zero,
});
list.Add(new LineVertexData
{
position = Space.Project(XChartCubeGeometry.Vertices[XChartCubeGeometry.Edges[e, 1]], m_Composed),
color = color,
thickness = EdgeThickness,
userData = Vector4.zero,
});
}
// 先画后向棱(在底层),再画前向棱
if (ShowBackEdges)
DrawSegments(m_BackEdges);
DrawSegments(m_FrontEdges);
}
private void DrawSegments(List<LineVertexData> segments)
{
for (int i = 0; i + 1 < segments.Count; i += 2)
{
EdgeRenderer.DrawLine(
segments[i].position,
segments[i + 1].position,
segments[i].color,
segments[i].thickness);
m_EdgesDrawn++;
}
}
// ── 自述读数 ──────────────────────────────────────────────
#if UNITY_EDITOR
/// <summary>
/// 线框这一帧做了什么,全写在报表这一行里:<c>edges=</c> 提交了几条棱、
/// <c>faces=</c> 发布了几个面、<c>space=</c> 有没有投影权威、<c>renderer=</c> 渲染器在不在位。
/// "线框整个不见了"这四件事在画面上长得一样,只有这一行分得清(规范 §22)。
/// </summary>
internal override void AppendDebugLine(System.Text.StringBuilder sb)
{
base.AppendDebugLine(sb);
int valid = 0;
for (int i = 0; i < m_FaceFrames.Length; i++)
if (m_FaceFrames[i].IsValid) valid++;
sb.Append(" edges=").Append(m_EdgesDrawn)
.Append(" faces=").Append(m_FacesPublished)
.Append(" frames=").Append(valid).Append('/').Append(m_FaceFrames.Length)
.Append(" backEdges=").Append(ShowBackEdges ? "on" : "off")
.Append(" space=").Append(Context != null && Context.Space != null ? "ok" : "NULL")
.Append(" renderer=").Append(EdgeRenderer == null ? "NULL" : "ok");
}
#endif
// ── 清理 ──────────────────────────────────────────────────
protected override void OnDispose()
{
EdgeRenderer = null;
m_FrontEdges.Clear();
m_BackEdges.Clear();
}
}
}