外部数据驱动缺的那一半:工具的参数以前是裸自动属性,写进去值在、画面不动,
必须再记得叫一次 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,纯算文件一个没动。
267 lines
13 KiB
C#
267 lines
13 KiB
C#
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.<n></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();
|
||
}
|
||
}
|
||
}
|