Files
XericUIActionVessel/Runtime/XChart/Pseudo3D/ChartToolCubeBg.cs
T
lrss3 192714baf1 XChart P28:面边插槽 6×4=24——"贴哪一面的哪条棱"终于是一个可寻址的东西(规范 §31)
他数出来的两件事,都对应一个真实的形状问题(不是"漏发布"):

- "下拉里 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`)。
2026-10-26 19:31:25 +08:00

290 lines
14 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;
// 面边插槽(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();
}
}
}