XChart 图表框架落地(P0–P17):格线单一作者、面板一行状态、矢量场

此前整个 XChart 特性一直没有提交(分期 P0–P12 的代码与素材都还在工作区里)。这一批一并入库,
并含本轮 P13–P17 的改动(规范 Documentation/XChart-RenderFramework.md 新增 §22–§25):

- P13:格线只剩一个作者——线框工具不再有"画格线 / 发布格线插槽"的代码路径;BG Cube Grid(原 MeshBg)
  是唯一作者,且"画上去的线=发布给轴线的那份比例数组";插槽板新增 Unpublish(说得出"这里不再有线",
  否则掩码筛掉的面会把上一轮的值留着被消费者吸走);渲染参数搬进元素表
  (DeclareDefaultElements / AddDefaultElement + XChartElementTable 按类型去重,只在第一次读到表时补);
  图上「立方体外观」那组字段删除、公共属性转发到元素表;面板逐行点名脚本注册的工具。
- P14 / P15:数据窗口文案收敛(行末 `-`、标题 `X [0]`、长说明退回 tooltip、范围页三行不再被压扁);
  元素块收成一行状态 `▼ 名称 √ R… D… [↑][↓][-]`;**注册序由类型定死、只显示不给输入控件,
  绘制序与元素在表里的位置绑定**(§24.5,他 2026-10-25 澄清);默认元素让删也让关;
  EnsureSpace 改成每次重建后都跑(删掉"空间"不再等于整张图空掉)。
- P17:矢量场——维数不够时不再静默不画(元素配置报需求,面板与报表同时印"需求/现有");
  相对/绝对两种读法收进纯算术 XChartVectorFieldMath;连续绘制(互斥显示把"相对/绝对"藏起来);
  颜色维(色相走 0..256 色环,饱和/明度/不透明 0..1,不透明度不算硬需求);新增螺旋矢量场测试数据。
  数据口径按他澄清修正为:前三维=坐标、一支箭头=相邻两条记录、第 4~7 维是颜色(§25、CHANGELOG 修正行)。

判据:编译门三臂 + 3 支对照绿;离线探针 436 项 0 失败;p4_control 55 支臂各红在自己点名的断言上;
p2_control / pool_family / generator_gate / hierarchy_gate 在同一棵交付树上复跑。
(证据脚本与日志在包外的 .ximage-gate/,未入本仓库。)
This commit is contained in:
2026-10-25 20:21:28 +08:00
parent 216d157472
commit c51ab7a3c8
105 changed files with 13062 additions and 812 deletions
+156 -355
View File
@@ -1,38 +1,39 @@
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 立方体背景工具。
/// 伪 3D 立方体<b>线框</b>工具(元素显示名 <c>BG Cube Wire</c>)。
///
/// 使用 UILineRendererV2 绘制:
/// 1. 立方体 12 条棱的线框(前向棱使用实色,后向棱可选半透明)
/// 2. 三个可见面上的轴标线网格
/// <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>
///
/// 3D 坐标系统:
/// 立方体中心在原点,半边长 1(即 [-1, 1] 范围)。
/// 通过 pitch/yaw 旋转后进行正交投影(丢弃 Z 轴)得到 2D UI 坐标。
/// 最终通过 scale + offset 映射到 RectTransform 的像素空间。
/// 几何与投影全部来自 <see cref="XChartCubeGeometry"/> 与 <see cref="XChartCubeView"/>,
/// 投影权威来自 <see cref="ChartToolSpace"/>(本类不自带顶点/面/棱表,也不自己算投影):
/// <see cref="ComposedMatrix"/> / <see cref="Space"/> 是对外的投影出口,
/// 数据类工具靠它对齐到同一空间。
///
/// 子节点结构:
/// [ChartTool_CubeBg]
/// └─ CubeRenderer (UILineRendererV2)
/// <para><b>旋转是一个四元数,不是两轴角度</b>;<b>尺寸是半边长</b>,默认口径下它不随旋转变化
/// (旧版按投影包围盒 fit,转起来会越转越小)。理由与换算见 <see cref="XChartCubeView"/>。</para>
///
/// 子节点结构:<c>[BG Cube Wire] → CubeEdgeRenderer (UILineRendererV2)</c>
/// </summary>
[AddComponentMenu("Xeric/XChart/Pseudo3D/Cube Background Tool")]
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Cube Wire Background Tool")]
public class ChartToolCubeBg : XChartToolBase
{
// ── 外观配置 ──────────────────────────────────────────────
/// <summary>立方体半边长(UI 像素)</summary>
public float CubeHalfSize { get; set; } = 150f;
/// <summary>俯仰角(绕 X 轴旋转,度数)</summary>
public float Pitch { get; set; } = 25f;
/// <summary>偏航角(绕 Y 轴旋转,度数)</summary>
public float Yaw { get; set; } = -30f;
/// <summary>线框自己的变换(立方体局部单位);默认恒等,即和图的空间重合</summary>
public XChartToolTransform Transform { get; set; } = XChartToolTransform.Identity;
/// <summary>前向棱颜色</summary>
public Color FrontEdgeColor { get; set; } = new Color(0.7f, 0.7f, 0.7f, 1f);
@@ -43,220 +44,129 @@ namespace XericUI.XChart.Pseudo3D
/// <summary>棱线宽度</summary>
public float EdgeThickness { get; set; } = 2f;
/// <summary>网格线颜色</summary>
public Color GridLineColor { get; set; } = new Color(0.5f, 0.5f, 0.5f, 0.3f);
/// <summary>网格线宽度</summary>
public float GridLineThickness { get; set; } = 1f;
/// <summary>每轴网格分割数</summary>
public int GridDivisions { get; set; } = 5;
/// <summary>是否显示后向棱</summary>
public bool ShowBackEdges { get; set; } = true;
/// <summary>是否显示网格标线</summary>
public bool ShowGridLines { get; set; } = true;
/// <summary>立方体中心偏移</summary>
public Vector2 CenterOffset { get; set; } = Vector2.zero;
// ── 内部组件 ──────────────────────────────────────────────
/// <summary>棱线渲染器</summary>
public UILineRendererV2 EdgeRenderer { get; private set; }
/// <summary>网格线渲染器</summary>
public UILineRendererV2 GridRenderer { get; private set; }
// ── 3D 管线状态 ──────────────────────────────────────────
// 8 个立方体顶点(中心在原点,半边长 1)
private static readonly Vector3[] s_CubeVertices = new Vector3[]
{
new Vector3(-1, -1, -1), // 0: 后下左
new Vector3( 1, -1, -1), // 1: 后下右
new Vector3( 1, 1, -1), // 2: 后上右
new Vector3(-1, 1, -1), // 3: 后上左
new Vector3(-1, -1, 1), // 4: 前下左
new Vector3( 1, -1, 1), // 5: 前下右
new Vector3( 1, 1, 1), // 6: 前上右
new Vector3(-1, 1, 1), // 7: 前上左
};
// 12 条棱(顶点索引对)
private static readonly int[,] s_CubeEdges = new int[12, 2]
{
{0,1}, {1,2}, {2,3}, {3,0}, // 后面
{4,5}, {5,6}, {6,7}, {7,4}, // 前面
{0,4}, {1,5}, {2,6}, {3,7}, // 连接棱
};
// 6 个面的顶点索引 + 法线
private struct FaceDef { public int[] verts; public Vector3 normal; }
private static readonly FaceDef[] s_Faces = new FaceDef[]
{
new FaceDef { verts = new int[] {4,5,6,7}, normal = new Vector3(0, 0, 1) }, // 前
new FaceDef { verts = new int[] {0,1,2,3}, normal = new Vector3(0, 0,-1) }, // 后
new FaceDef { verts = new int[] {1,5,6,2}, normal = new Vector3(1, 0, 0) }, // 右
new FaceDef { verts = new int[] {0,4,7,3}, normal = new Vector3(-1,0, 0) }, // 左
new FaceDef { verts = new int[] {2,6,7,3}, normal = new Vector3(0, 1, 0) }, // 上
new FaceDef { verts = new int[] {0,1,5,4}, normal = new Vector3(0,-1, 0) }, // 下
};
// 每个面由两个轴定义(用于网格线方向)
private static readonly Vector3[] s_FaceAxisA = new Vector3[]
{
new Vector3(1,0,0), new Vector3(1,0,0), // 前/后: X 轴
new Vector3(0,1,0), new Vector3(0,1,0), // 右/左: Y 轴
new Vector3(1,0,0), new Vector3(1,0,0), // 上/下: X 轴
};
private static readonly Vector3[] s_FaceAxisB = new Vector3[]
{
new Vector3(0,1,0), new Vector3(0,1,0), // 前/后: Y 轴
new Vector3(0,0,1), new Vector3(0,0,1), // 右/左: Z 轴
new Vector3(0,0,1), new Vector3(0,0,1), // 上/下: Z 轴
};
// ── 投影状态 ──────────────────────────────────────────────
private Vector3[] m_RotatedVerts = new Vector3[8]; // 旋转后的 3D 顶点
private Vector2[] m_ProjectedVerts = new Vector2[8]; // 投影后的 2D 顶点
private bool m_ProjectionDirty = true;
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);
/// <summary>投影版本号(每次投影矩阵变化时递增,供外部检测变化)</summary>
public int ProjectionVersion { get; private set; } = 0;
private ChartToolSpace m_Space;
private Matrix4x4 m_Composed = Matrix4x4.identity;
private int m_LastSpaceVersion = -1;
private bool m_Dirty = true;
private Matrix4x4 m_RotationMatrix;
private float m_Scale;
private Vector2 m_Offset;
/// <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 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;
var rt = EdgeRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
// 创建网格线渲染器
GridRenderer = CreateChildComponent<UILineRendererV2>("CubeGridRenderer");
if (GridRenderer != null)
{
GridRenderer.defaultColor = GridLineColor;
GridRenderer.defaultThickness = GridLineThickness;
var rt = GridRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
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()
{
if (!m_ProjectionDirty) return;
m_ProjectionDirty = false;
var space = Space;
if (space == null) return;
if (!m_Dirty && space.ProjectionVersion == m_LastSpaceVersion) return;
m_Dirty = false;
m_LastSpaceVersion = space.ProjectionVersion;
// 1. 构建旋转矩阵:先绕 X 轴(pitch),再绕 Y 轴(yaw)
float pitchRad = Pitch * Mathf.Deg2Rad;
float yawRad = Yaw * Mathf.Deg2Rad;
m_RotationMatrix = Matrix4x4.Rotate(
Quaternion.Euler(pitchRad * Mathf.Rad2Deg, yawRad * Mathf.Rad2Deg, 0));
// 2. 旋转所有顶点
for (int i = 0; i < 8; i++)
m_RotatedVerts[i] = m_RotationMatrix.MultiplyPoint3x4(s_CubeVertices[i]);
// 3. 计算投影后的 2D 范围(丢弃 Z)
float minX = float.MaxValue, maxX = float.MinValue;
float minY = float.MaxValue, maxY = float.MinValue;
for (int i = 0; i < 8; i++)
{
float px = m_RotatedVerts[i].x;
float py = m_RotatedVerts[i].y;
if (px < minX) minX = px;
if (px > maxX) maxX = px;
if (py < minY) minY = py;
if (py > maxY) maxY = py;
}
// 4. 计算缩放和偏移,使立方体适配 CubeHalfSize
float rangeX = maxX - minX;
float rangeY = maxY - minY;
float maxRange = Mathf.Max(rangeX, rangeY);
m_Scale = (maxRange > 0.001f) ? (CubeHalfSize * 2f / maxRange) : 1f;
// 中心对齐到 CenterOffset
float centerX = (minX + maxX) * 0.5f;
float centerY = (minY + maxY) * 0.5f;
m_Offset = new Vector2(
CenterOffset.x - centerX * m_Scale,
CenterOffset.y - centerY * m_Scale);
// 5. 计算最终投影坐标
for (int i = 0; i < 8; i++)
{
m_ProjectedVerts[i] = new Vector2(
m_RotatedVerts[i].x * m_Scale + m_Offset.x,
m_RotatedVerts[i].y * m_Scale + m_Offset.y);
}
m_Composed = space.Compose(Transform);
space.BuildFaceFrames(m_FaceFrames, m_Composed);
PublishFaceSlots();
}
/// <summary>标记投影需要重新计算</summary>
public void MarkProjectionDirty()
{
m_ProjectionDirty = true;
ProjectionVersion++;
}
// ── 3D 投影辅助 ──────────────────────────────────────────
/// <summary>将 3D 点投影到 2D</summary>
public Vector2 ProjectPoint3D(Vector3 point3d)
{
UpdateProjection();
Vector3 rotated = m_RotationMatrix.MultiplyPoint3x4(point3d);
return new Vector2(rotated.x * m_Scale + m_Offset.x,
rotated.y * m_Scale + m_Offset.y);
}
/// <summary>批量投影 3D 点到 2D</summary>
public Vector2[] ProjectPoints3D(Vector3[] points3d)
{
UpdateProjection();
var result = new Vector2[points3d.Length];
for (int i = 0; i < points3d.Length; i++)
{
Vector3 rotated = m_RotationMatrix.MultiplyPoint3x4(points3d[i]);
result[i] = new Vector2(rotated.x * m_Scale + m_Offset.x,
rotated.y * m_Scale + m_Offset.y);
}
return result;
}
/// <summary>获取当前旋转矩阵</summary>
public Matrix4x4 RotationMatrix => m_RotationMatrix;
/// <summary>获取当前缩放</summary>
public float Scale => m_Scale;
/// <summary>获取当前偏移</summary>
public Vector2 Offset => m_Offset;
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
@@ -265,196 +175,87 @@ namespace XericUI.XChart.Pseudo3D
if (EdgeRenderer == null) return;
UpdateProjection();
// 绘制棱线
DrawEdges();
// 绘制网格标线
if (GridRenderer != null)
{
if (ShowGridLines)
{
DrawGridLines();
}
else
{
GridRenderer.ClearAll();
}
}
}
// ── 棱线绘制 ──────────────────────────────────────────────
private void DrawEdges()
{
EdgeRenderer.ClearAll();
m_FrontEdges.Clear();
m_BackEdges.Clear();
m_EdgesDrawn = 0;
// 确定前向棱:棱的两个顶点中,Z 值较大的为前向
// 更准确:棱所属的面中,法线 Z > 0 的面为可见面
// 简单方法:棱的两个顶点的 rotated Z 平均值 > 0 为前向
var frontVerts = new List<LineVertexData>();
var backVerts = new List<LineVertexData>();
for (int e = 0; e < 12; e++)
for (int e = 0; e < XChartCubeGeometry.EdgeCount; e++)
{
int v0 = s_CubeEdges[e, 0];
int v1 = s_CubeEdges[e, 1];
float avgZ = (m_RotatedVerts[v0].z + m_RotatedVerts[v1].z) * 0.5f;
bool isFront = avgZ >= 0;
var list = isFront ? frontVerts : backVerts;
int startIdx = list.Count;
bool isFront = XChartCubeGeometry.IsEdgeVisible(m_Composed, e);
var list = isFront ? m_FrontEdges : m_BackEdges;
Color color = isFront ? FrontEdgeColor : BackEdgeColor;
list.Add(new LineVertexData
{
position = m_ProjectedVerts[v0],
color = isFront ? FrontEdgeColor : BackEdgeColor,
position = Space.Project(XChartCubeGeometry.Vertices[XChartCubeGeometry.Edges[e, 0]], m_Composed),
color = color,
thickness = EdgeThickness,
userData = Vector4.zero,
});
list.Add(new LineVertexData
{
position = m_ProjectedVerts[v1],
color = isFront ? FrontEdgeColor : BackEdgeColor,
position = Space.Project(XChartCubeGeometry.Vertices[XChartCubeGeometry.Edges[e, 1]], m_Composed),
color = color,
thickness = EdgeThickness,
userData = Vector4.zero,
});
}
// 先画后向棱(在底层),再画前向棱(在上层)
if (ShowBackEdges && backVerts.Count > 0)
{
// 每两个顶点构成一条线段
for (int i = 0; i < backVerts.Count; i += 2)
{
EdgeRenderer.DrawLine(
backVerts[i].position,
backVerts[i + 1].position,
backVerts[i].color,
backVerts[i].thickness);
}
}
// 先画后向棱(在底层),再画前向棱
if (ShowBackEdges)
DrawSegments(m_BackEdges);
DrawSegments(m_FrontEdges);
}
for (int i = 0; i < frontVerts.Count; i += 2)
private void DrawSegments(List<LineVertexData> segments)
{
for (int i = 0; i + 1 < segments.Count; i += 2)
{
EdgeRenderer.DrawLine(
frontVerts[i].position,
frontVerts[i + 1].position,
frontVerts[i].color,
frontVerts[i].thickness);
segments[i].position,
segments[i + 1].position,
segments[i].color,
segments[i].thickness);
m_EdgesDrawn++;
}
}
// ── 网格标线绘制 ──────────────────────────────────────────
// ── 自述读数 ──────────────────────────────────────────────
private void DrawGridLines()
#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)
{
GridRenderer.ClearAll();
// 获取 3 个可见面(法线 Z 值最大的 3 个面)
var visibleFaces = GetVisibleFaces();
if (visibleFaces.Count == 0) return;
foreach (int faceIdx in visibleFaces)
{
DrawGridLinesOnFace(faceIdx);
}
}
/// <summary>获取可见面索引列表(按可见度排序,最多 3 个)</summary>
private List<int> GetVisibleFaces()
{
var result = new List<int>(3);
var faceScores = new (int index, float score)[6];
for (int i = 0; i < 6; i++)
{
// 将面法线旋转到当前视角
Vector3 rotatedNormal = m_RotationMatrix.MultiplyVector(s_Faces[i].normal);
// Z 分量越大,越面向用户
faceScores[i] = (i, rotatedNormal.z);
}
// 按 Z 值降序排列(Z 越大越面向用户)
System.Array.Sort(faceScores, (a, b) => b.score.CompareTo(a.score));
// 取前 3 个且 Z > 0 的面
for (int i = 0; i < 3 && faceScores[i].score > 0; i++)
result.Add(faceScores[i].index);
return result;
}
/// <summary>在指定面上绘制网格线</summary>
private void DrawGridLinesOnFace(int faceIdx)
{
var face = s_Faces[faceIdx];
Vector3 axisA = s_FaceAxisA[faceIdx];
Vector3 axisB = s_FaceAxisB[faceIdx];
// 面的四个顶点(在立方体局部坐标中)
Vector3 v0 = s_CubeVertices[face.verts[0]];
Vector3 v1 = s_CubeVertices[face.verts[1]];
Vector3 v2 = s_CubeVertices[face.verts[2]];
Vector3 v3 = s_CubeVertices[face.verts[3]];
// 面的范围
float minA = float.MaxValue, maxA = float.MinValue;
float minB = float.MaxValue, maxB = float.MinValue;
// 计算顶点在轴上的投影
float GetAxisValue(Vector3 v, Vector3 axis) => Vector3.Dot(v, axis);
for (int i = 0; i < 4; i++)
{
var v = s_CubeVertices[face.verts[i]];
float va = GetAxisValue(v, axisA);
float vb = GetAxisValue(v, axisB);
if (va < minA) minA = va;
if (va > maxA) maxA = va;
if (vb < minB) minB = vb;
if (vb > maxB) maxB = vb;
}
// 沿 A 轴画线(平行于 B 轴)
float stepA = (maxA - minA) / GridDivisions;
float stepB = (maxB - minB) / GridDivisions;
// 沿 A 轴方向的网格线
for (int i = 0; i <= GridDivisions; i++)
{
float aVal = minA + i * stepA;
// 线的两个端点
Vector3 p1 = face.normal + axisA * aVal + axisB * minB;
Vector3 p2 = face.normal + axisA * aVal + axisB * maxB;
Vector2 pp1 = ProjectPoint3D(p1);
Vector2 pp2 = ProjectPoint3D(p2);
// 只绘制落在面范围内的线
GridRenderer.DrawLine(pp1, pp2, GridLineColor, GridLineThickness);
}
// 沿 B 轴方向的网格线
for (int i = 0; i <= GridDivisions; i++)
{
float bVal = minB + i * stepB;
Vector3 p1 = face.normal + axisA * minA + axisB * bVal;
Vector3 p2 = face.normal + axisA * maxA + axisB * bVal;
Vector2 pp1 = ProjectPoint3D(p1);
Vector2 pp2 = ProjectPoint3D(p2);
GridRenderer.DrawLine(pp1, pp2, GridLineColor, GridLineThickness);
}
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;
GridRenderer = null;
m_FrontEdges.Clear();
m_BackEdges.Clear();
}
}
}