他数出来的两件事,都对应一个真实的形状问题(不是"漏发布"): - "下拉里 12 个,只有 mesh.face.1-5 有用,后面的 mesh.face.0.grid.S/T 都没用" —— 板上当时只有 `mesh.face.<0..5>`(Quad3D 面四角,6 个)与 `mesh.face.<n>.grid.S|T`(Line3D **比例数组**,12 个), 而轴线只认 Quad3D ⇒ 那 12 项在这个下拉里**永远是死项**(它们是「对齐格线」的输入,不是宿主)。 - "4 条垂直边注册不上" —— 因为"边"根本不是可寻址的东西:以前只能"选一个面 + CrossRatio=±1"去贴棱, 而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到位置上。 他给的结论正是要补的那层命名:"不可能只有 12 个,而是 4x6=24 个,命名该是 face/side"。 落法: - id 用 `mesh.face.<f>.side.<s>`(24 个)。前缀沿用 `mesh.face.`——`TryGetSlotAt` 与"轴从 id 回落读面号"都按它解析, 写成 `mesh.face0.side0` 就会同时存在两套前缀。 - **值=同一个面的四角按 <00,01,11,10> 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)。 于是它仍是 Quad3D:轴线的 AlongS/CrossRatio/刻度朝外/标签随轴旋转**一行都不用改**;绕序不变 ⇒ 不镜像 (镜像了"往面内刻度"会翻到外面去,而这件事在画面上只是"刻度朝里",很难归因)。边号 0 底·1 左·2 顶·3 右。 - 发布者只有一个:线框元素(它就是画棱的那个,`mesh.face.<n>` 也归它)。一处算式出 24 份,报表 `faces=6 sides=24`;发不出去印 `sideRefuse=<原因>`——发不出去比发错更难查,所以留名字。 - 面板下拉只列"能当宿主的",判据收成一处 `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用; 否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的",不静默少一项。 - 选中项另外在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)")。 **下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;又因为面板在值变化时故意不重建树 (那会换掉正在拖的控件),这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。 - 轴那行现成的 `slot=` / `frame=slot|cube` 已经能回答"我贴上了哪条边"(`frame=cube` 就是没读到槽、退回了硬编码), 所以没有再加新读数。 一条自证:我先在文档里写"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示裸 id)。 这句话在这一笔里被改成真的,而不是把文档改回去说假话——文档里的功能存在性也要有门。 判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向/ 24 档把 12 条棱各覆盖两次——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标", 否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支 CONTROL PASSED(新增 3 支:所有 side 旋到同一格/ 环序取成镜像/两条边名撞同一个词);`dirty_gate` 正本 knobs=133 takesEffect=133、九支全红; `slot_reset_gate` 仍 PASS(上一笔立的"被写 ⊆ 被恢复"这条没被这次改动放宽);编译门 runtime+player+editor+3 对照绿 (chain_p28.txt,面板那行加完之后又跑了一次 chain_p28b.txt 同样绿)。 本轮两次被工具拦住、都是它正常工作:`git add -A` 被分类器拒绝(一直禁用;pathspec 提交本就不需要暂存); 中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 带中文的源行在臂文件里写 `\uXXXX`)。 覆盖不到的:30 个插槽是否真进了下拉、垂直棱是否真贴住了,只有他现场判(§31.4,看 `sides=24` / `slot=` / `frame=slot`)。
290 lines
14 KiB
C#
290 lines
14 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;
|
||
// 面边插槽(6×4=24)发出去几个、卡在哪儿(§31):发不出去比发错更难查,所以留名字与原因
|
||
private int m_SidesPublished;
|
||
private string m_SidesRefused;
|
||
|
||
// ── 对外出口 ──────────────────────────────────────────────
|
||
|
||
/// <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;
|
||
m_SidesPublished = 0;
|
||
m_SidesRefused = null;
|
||
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++;
|
||
|
||
// 同一个面的 4 条边各发一份(旋到底边的那个四角,仍是 Quad3D)——
|
||
// 一根棱被两个面共享,"贴哪一面的哪条棱"必须能从 id 里说出来(§31)
|
||
for (int side = 0; side < XChartCubeGeometry.SideCount; side++)
|
||
{
|
||
XChartCubeGeometry.GetSideQuad(face, side, 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;
|
||
|
||
string why;
|
||
if (board.Publish(XChartCubeGeometry.SideSlotId(face, side), XChartSlotMode.Quad3D,
|
||
XChartSlotAccess.ReadOnly, m_SlotValues, out why)) m_SidesPublished++;
|
||
else m_SidesRefused = why;
|
||
}
|
||
}
|
||
}
|
||
|
||
// ── 初始化 ────────────────────────────────────────────────
|
||
|
||
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(" sides=").Append(m_SidesPublished)
|
||
.Append(m_SidesRefused == null ? "" : " sideRefuse=" + m_SidesRefused)
|
||
.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();
|
||
}
|
||
}
|
||
}
|