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:
@@ -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.<n></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();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,132 +1,115 @@
|
||||
using UnityEngine;
|
||||
using XericLibrary.Runtime.UIGraph;
|
||||
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
|
||||
using XericUI.Core;
|
||||
using XericUI.XChart.Mesh;
|
||||
using XericUI.XChart.Space;
|
||||
|
||||
namespace XericUI.XChart.Pseudo3D
|
||||
{
|
||||
/// <summary>
|
||||
/// 散点渲染工具。
|
||||
/// 散点元素:把 3D 数据点画进图的空间里。
|
||||
///
|
||||
/// 使用 XScatterPointRenderer 渲染 3D 散点数据在 2D 平面上的投影。
|
||||
/// 数据点从 3D 立方体空间投影到 UI 坐标,每个点用一个图元表示。
|
||||
/// <para><b>数据从哪儿来</b>:只认图表给的中转接口 <see cref="IXChartDataSource"/>
|
||||
/// (<see cref="AutoFromData"/> 为真时按维度下标逐条取,范围用聚合量的 min/max)。
|
||||
/// 元素不直接摸记录数组,所以以后要换桶/环形缓冲也不用改这里。
|
||||
/// <see cref="AutoFromData"/> 为假时用脚本喂进来的 <see cref="SetCubePoints"/>(立方体单位)。</para>
|
||||
///
|
||||
/// <para><b>投影从哪儿来</b>:图里的 <see cref="ChartToolSpace"/>,和背景/线框/轴线<b>同一个</b>。
|
||||
/// 所以"点落在盒子里"是结构保证——数据归一化到 [0,1] 再映到立方体局部 [-1,1],
|
||||
/// 然后走和背景一样的 <c>基变换 ∘ 工具变换</c>。</para>
|
||||
///
|
||||
/// <para><b>什么时候重算</b>:数据版本号或空间版本号变了才重投影,其余帧什么都不做。</para>
|
||||
///
|
||||
/// 子节点结构:
|
||||
/// [ChartTool_ScatterPoints]
|
||||
/// [ScatterPoints]
|
||||
/// └─ PointRenderer (XScatterPointRenderer)
|
||||
/// </summary>
|
||||
[AddComponentMenu("Xeric/XChart/Pseudo3D/Scatter Points Tool")]
|
||||
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Scatter Points Tool")]
|
||||
public class ChartToolScatterPoints : XChartToolBase
|
||||
{
|
||||
// ── 配置 ──────────────────────────────────────────────────
|
||||
// ── 数据装配 ──────────────────────────────────────────────
|
||||
|
||||
/// <summary>点的大小(像素)</summary>
|
||||
public float PointSize
|
||||
{
|
||||
get => m_PointSize;
|
||||
set { m_PointSize = Mathf.Max(0.5f, value); if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
/// <summary>真=从图的数据源按维度下标读;假=用 <see cref="SetCubePoints"/> 喂的点</summary>
|
||||
public bool AutoFromData { get; set; } = true;
|
||||
|
||||
/// <summary>三个维度在数据源里的下标(绑定:点云画哪三路数据;范围归 chart 的维度行)</summary>
|
||||
public int DimensionX { get; set; }
|
||||
public int DimensionY { get; set; } = 1;
|
||||
public int DimensionZ { get; set; } = 2;
|
||||
|
||||
/// <summary>点云自己的变换(立方体单位),用来把点整体缩进盒子里或挪一角</summary>
|
||||
public XChartToolTransform Transform { get; set; } = XChartToolTransform.Identity;
|
||||
|
||||
/// <summary>
|
||||
/// 桶采样目标点数:<c>0</c> 或 ≥ 记录数=不聚合;否则把记录按桶归约成这么多个点。
|
||||
/// 目的是"几万条记录也只画 N 个点",同时让每个点代表它那一段时间。
|
||||
/// </summary>
|
||||
public int BucketTargetPoints { get; set; }
|
||||
|
||||
/// <summary>桶内取哪个统计量当这个点(抽稀 First/Last 不造新值;趋势 Mean/Median;包络 Minimum/Maximum)</summary>
|
||||
public XChartAggregateKind BucketReduce { get; set; } = XChartAggregateKind.Last;
|
||||
|
||||
// ── 外观 ──────────────────────────────────────────────────
|
||||
|
||||
public float PointSize { get => m_PointSize; set { m_PointSize = Mathf.Max(0.5f, value); if (IsInitialized) SyncShapeParams(); } }
|
||||
private float m_PointSize = 8f;
|
||||
|
||||
/// <summary>图元类型</summary>
|
||||
public PrimitiveType PointType
|
||||
{
|
||||
get => m_PointType;
|
||||
set { m_PointType = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public PrimitiveType PointType { get => m_PointType; set { m_PointType = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private PrimitiveType m_PointType = PrimitiveType.Polygon;
|
||||
|
||||
/// <summary>尺寸模式</summary>
|
||||
public SizeMode SizeMode
|
||||
{
|
||||
get => m_SizeMode;
|
||||
set { m_SizeMode = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
private SizeMode m_SizeMode = SizeMode.InscribedCircle;
|
||||
public SizeMode PointSizeMode { get => m_PointSizeMode; set { m_PointSizeMode = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private SizeMode m_PointSizeMode = SizeMode.InscribedCircle;
|
||||
|
||||
/// <summary>填充颜色</summary>
|
||||
public Color PointColor
|
||||
{
|
||||
get => m_PointColor;
|
||||
set { m_PointColor = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public Color PointColor { get => m_PointColor; set { m_PointColor = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private Color m_PointColor = new Color(0.33f, 0.67f, 1f, 1f);
|
||||
|
||||
/// <summary>中心渐变颜色</summary>
|
||||
public Color CenterColor
|
||||
{
|
||||
get => m_CenterColor;
|
||||
set { m_CenterColor = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public Color CenterColor { get => m_CenterColor; set { m_CenterColor = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private Color m_CenterColor = Color.white;
|
||||
|
||||
/// <summary>边框颜色</summary>
|
||||
public Color BorderColor
|
||||
{
|
||||
get => m_BorderColor;
|
||||
set { m_BorderColor = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public Color BorderColor { get => m_BorderColor; set { m_BorderColor = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private Color m_BorderColor = new Color(0.2f, 0.2f, 0.2f, 1f);
|
||||
|
||||
/// <summary>边框宽度</summary>
|
||||
public float BorderThickness
|
||||
{
|
||||
get => m_BorderThickness;
|
||||
set { m_BorderThickness = Mathf.Max(0f, value); if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public float BorderThickness { get => m_BorderThickness; set { m_BorderThickness = Mathf.Max(0f, value); if (IsInitialized) SyncShapeParams(); } }
|
||||
private float m_BorderThickness = 1f;
|
||||
|
||||
/// <summary>多边形边数</summary>
|
||||
public int SideCount
|
||||
{
|
||||
get => m_SideCount;
|
||||
set { m_SideCount = Mathf.Max(3, value); if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
public int SideCount { get => m_SideCount; set { m_SideCount = Mathf.Max(3, value); if (IsInitialized) SyncShapeParams(); } }
|
||||
private int m_SideCount = 8;
|
||||
|
||||
/// <summary>倒角大小</summary>
|
||||
public float ChamferSize
|
||||
{
|
||||
get => m_ChamferSize;
|
||||
set { m_ChamferSize = Mathf.Clamp01(value); if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
private float m_ChamferSize = 0f;
|
||||
public float ChamferSize { get => m_ChamferSize; set { m_ChamferSize = Mathf.Clamp01(value); if (IsInitialized) SyncShapeParams(); } }
|
||||
private float m_ChamferSize;
|
||||
|
||||
/// <summary>图元旋转角度</summary>
|
||||
public float PointAngle
|
||||
{
|
||||
get => m_PointAngle;
|
||||
set { m_PointAngle = value; if (IsInitialized) SyncShapeParams(); }
|
||||
}
|
||||
private float m_PointAngle = 0f;
|
||||
public float PointAngle { get => m_PointAngle; set { m_PointAngle = value; if (IsInitialized) SyncShapeParams(); } }
|
||||
private float m_PointAngle;
|
||||
|
||||
/// <summary>是否使用颜色渐变(按数据范围)</summary>
|
||||
public bool EnableColorMapping { get; set; } = false;
|
||||
/// <summary>按某一维的数值做颜色渐变</summary>
|
||||
public bool EnableColorMapping { get; set; }
|
||||
|
||||
/// <summary>颜色映射渐变起始色</summary>
|
||||
public Color ColorMapMin { get; set; } = Color.blue;
|
||||
|
||||
/// <summary>颜色映射渐变结束色</summary>
|
||||
public Color ColorMapMax { get; set; } = Color.red;
|
||||
|
||||
/// <summary>颜色映射轴(0=X, 1=Y, 2=Z)</summary>
|
||||
public int ColorMapAxis { get; set; } = 2;
|
||||
/// <summary>拿哪一维的数值做映射</summary>
|
||||
public int ColorMapDimension { get; set; } = 2;
|
||||
|
||||
// ── 内部组件 ──────────────────────────────────────────────
|
||||
// ── 内部 ──────────────────────────────────────────────────
|
||||
|
||||
/// <summary>散点渲染器</summary>
|
||||
public XScatterPointRenderer PointRenderer { get; private set; }
|
||||
|
||||
/// <summary>对 CubeBg 工具的引用(用于投影)</summary>
|
||||
public ChartToolCubeBg CubeBg { get; set; }
|
||||
private Matrix4x4 m_Composed = Matrix4x4.identity;
|
||||
|
||||
// ── 数据缓存 ──────────────────────────────────────────────
|
||||
private Vector3[] m_CubePoints = new Vector3[0];
|
||||
/// <summary>中位数归约用的暂存:长度按记录数上限,渲染路径里不分配</summary>
|
||||
private double[] m_BucketScratch;
|
||||
/// <summary>本帧桶数(=-1 表示还没算过);与源记录数一起进报表——"少画了多少"要能看到</summary>
|
||||
private int m_BucketCount = -1;
|
||||
private int m_SourceRecords;
|
||||
private Vector2[] m_Projected = new Vector2[0];
|
||||
private Color[] m_PointColors;
|
||||
private float[] m_ColorValues;
|
||||
|
||||
private Vector3[] m_NormalizedPoints = new Vector3[0];
|
||||
private Vector2[] m_ProjectedPoints = new Vector2[0];
|
||||
private bool m_DataDirty = true;
|
||||
private int m_LastProjectionVersion = -1;
|
||||
|
||||
// ── 初始化 ────────────────────────────────────────────────
|
||||
private bool m_PointsDirty = true;
|
||||
private long m_LastDataVersion = -1;
|
||||
private int m_LastSpaceVersion = -1;
|
||||
|
||||
protected override void OnInitialize()
|
||||
{
|
||||
@@ -139,17 +122,14 @@ namespace XericUI.XChart.Pseudo3D
|
||||
rt.offsetMin = Vector2.zero;
|
||||
rt.offsetMax = Vector2.zero;
|
||||
}
|
||||
|
||||
SyncShapeParams();
|
||||
}
|
||||
|
||||
// ── 形状参数同步 ──────────────────────────────────────────
|
||||
|
||||
private void SyncShapeParams()
|
||||
{
|
||||
if (PointRenderer == null) return;
|
||||
PointRenderer.pointType = m_PointType;
|
||||
PointRenderer.sizeMode = m_SizeMode;
|
||||
PointRenderer.sizeMode = m_PointSizeMode;
|
||||
PointRenderer.pointSize = m_PointSize;
|
||||
PointRenderer.fillColor = m_PointColor;
|
||||
PointRenderer.centerColor = m_CenterColor;
|
||||
@@ -160,101 +140,212 @@ namespace XericUI.XChart.Pseudo3D
|
||||
PointRenderer.chamferSegments = 4;
|
||||
PointRenderer.angle = m_PointAngle;
|
||||
|
||||
// 如果已有数据,触发形状重建
|
||||
if (m_NormalizedPoints.Length > 0)
|
||||
{
|
||||
PointRenderer.UpdateShapeParams();
|
||||
}
|
||||
if (m_CubePoints.Length > 0) PointRenderer.UpdateShapeParams();
|
||||
}
|
||||
|
||||
// ── 数据更新 ──────────────────────────────────────────────
|
||||
|
||||
/// <summary>
|
||||
/// 设置要渲染的 3D 点(归一化到 [-1, 1] 立方体空间)。
|
||||
/// </summary>
|
||||
public void SetNormalizedPoints(Vector3[] normalizedPoints)
|
||||
/// <summary>脚本喂点(立方体单位,[-1,1] 就是盒子内部)。配合 <see cref="AutoFromData"/>=false 用</summary>
|
||||
public void SetCubePoints(Vector3[] cubePoints)
|
||||
{
|
||||
m_NormalizedPoints = normalizedPoints ?? new Vector3[0];
|
||||
m_ProjectedPoints = new Vector2[m_NormalizedPoints.Length];
|
||||
m_DataDirty = true;
|
||||
m_CubePoints = cubePoints ?? new Vector3[0];
|
||||
m_Projected = new Vector2[m_CubePoints.Length];
|
||||
m_PointColors = null;
|
||||
m_ColorValues = null;
|
||||
m_BucketCount = 0; // 脚本喂点这条路没有桶
|
||||
m_SourceRecords = m_CubePoints.Length;
|
||||
m_PointsDirty = true;
|
||||
}
|
||||
|
||||
/// <summary>标记数据需要重新投影</summary>
|
||||
public void MarkDataDirty()
|
||||
{
|
||||
m_DataDirty = true;
|
||||
}
|
||||
/// <summary>数据或变换变了(版本号比对才是真判据,这里只负责"再算一次")</summary>
|
||||
public void MarkDataDirty() => m_PointsDirty = true;
|
||||
|
||||
// ── 渲染 ──────────────────────────────────────────────────
|
||||
|
||||
public override void OnRender()
|
||||
{
|
||||
base.OnRender();
|
||||
if (PointRenderer == null || CubeBg == null) return;
|
||||
if (m_NormalizedPoints.Length == 0) return;
|
||||
if (PointRenderer == null) return;
|
||||
|
||||
bool projectionChanged = CubeBg.ProjectionVersion != m_LastProjectionVersion;
|
||||
var space = Context?.Space;
|
||||
if (space == null) return;
|
||||
|
||||
// 如果数据脏了或立方体投影发生了变化,重新投影所有点
|
||||
if (m_DataDirty || projectionChanged)
|
||||
bool spaceChanged = space.ProjectionVersion != m_LastSpaceVersion;
|
||||
bool dataChanged = Data != null && Data.Version != m_LastDataVersion;
|
||||
if (!m_PointsDirty && !spaceChanged && !dataChanged) return;
|
||||
|
||||
if (spaceChanged || dataChanged) m_PointsDirty = true;
|
||||
m_LastSpaceVersion = space.ProjectionVersion;
|
||||
m_LastDataVersion = Data != null ? Data.Version : -1;
|
||||
m_Composed = space.Compose(Transform);
|
||||
|
||||
if (m_PointsDirty)
|
||||
{
|
||||
m_LastProjectionVersion = CubeBg.ProjectionVersion;
|
||||
|
||||
// 使用 CubeBg 的投影能力将 3D 点投影到 2D
|
||||
for (int i = 0; i < m_NormalizedPoints.Length; i++)
|
||||
{
|
||||
m_ProjectedPoints[i] = CubeBg.ProjectPoint3D(m_NormalizedPoints[i]);
|
||||
}
|
||||
|
||||
// 颜色映射
|
||||
if (EnableColorMapping)
|
||||
{
|
||||
ApplyColorMapping();
|
||||
}
|
||||
|
||||
// 批量更新到渲染器
|
||||
if (EnableColorMapping && m_PointColors != null)
|
||||
{
|
||||
PointRenderer.SetPoints(m_ProjectedPoints, m_PointColors);
|
||||
}
|
||||
else
|
||||
{
|
||||
PointRenderer.SetPoints(m_ProjectedPoints);
|
||||
}
|
||||
|
||||
m_DataDirty = false;
|
||||
if (AutoFromData) BuildPointsFromDataSource(space);
|
||||
RebuildProjection(space);
|
||||
m_PointsDirty = false;
|
||||
}
|
||||
|
||||
if (m_Projected.Length == 0)
|
||||
{
|
||||
PointRenderer.ClearAll();
|
||||
return;
|
||||
}
|
||||
|
||||
if (EnableColorMapping && m_PointColors != null) PointRenderer.SetPoints(m_Projected, m_PointColors);
|
||||
else PointRenderer.SetPoints(m_Projected);
|
||||
}
|
||||
|
||||
// ── 颜色映射 ──────────────────────────────────────────────
|
||||
/// <summary>立方体单位点 → 图表局部像素</summary>
|
||||
private void RebuildProjection(ChartToolSpace space)
|
||||
{
|
||||
if (m_Projected == null || m_Projected.Length != m_CubePoints.Length)
|
||||
m_Projected = new Vector2[m_CubePoints.Length];
|
||||
|
||||
private Color[] m_PointColors;
|
||||
for (int i = 0; i < m_CubePoints.Length; i++)
|
||||
m_Projected[i] = space.Project(m_CubePoints[i], m_Composed);
|
||||
|
||||
if (EnableColorMapping) ApplyColorMapping();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 从数据源逐条取值,按每维范围归一化到 [0,1],再映到立方体局部 [-1,1]。
|
||||
/// 范围优先用配置里给的手动范围,没给就用该维的聚合 min/max。
|
||||
/// </summary>
|
||||
private void BuildPointsFromDataSource(ChartToolSpace space)
|
||||
{
|
||||
var source = Data;
|
||||
if (source == null || !source.HasData)
|
||||
{
|
||||
ClearPoints();
|
||||
return;
|
||||
}
|
||||
|
||||
int count = source.RecordCount;
|
||||
|
||||
// 桶采样:0 或 ≥ 记录数=不聚合(桶数就是记录数,行为与以前完全一致)
|
||||
int buckets = XChartBucketMath.BucketCount(count, BucketTargetPoints);
|
||||
m_BucketCount = buckets;
|
||||
m_SourceRecords = count;
|
||||
|
||||
if (m_CubePoints.Length < buckets)
|
||||
{
|
||||
m_CubePoints = new Vector3[buckets];
|
||||
m_Projected = new Vector2[buckets];
|
||||
}
|
||||
if (EnableColorMapping && (m_PointColors == null || m_PointColors.Length < buckets))
|
||||
m_PointColors = new Color[buckets];
|
||||
if (EnableColorMapping && (m_ColorValues == null || m_ColorValues.Length < buckets))
|
||||
m_ColorValues = new float[buckets];
|
||||
if (BucketReduce == XChartAggregateKind.Median && (m_BucketScratch == null || m_BucketScratch.Length < count))
|
||||
m_BucketScratch = new double[count];
|
||||
|
||||
double minX, maxX, minY, maxY, minZ, maxZ;
|
||||
ResolveRange(DimensionX, out minX, out maxX);
|
||||
ResolveRange(DimensionY, out minY, out maxY);
|
||||
ResolveRange(DimensionZ, out minZ, out maxZ);
|
||||
double colorMin, colorMax;
|
||||
ResolveRange(ColorMapDimension, out colorMin, out colorMax);
|
||||
|
||||
int written = 0;
|
||||
for (int b = 0; b < buckets; b++)
|
||||
{
|
||||
int first, end;
|
||||
if (!XChartBucketMath.TryBucketRange(count, b, buckets, out first, out end)) continue;
|
||||
|
||||
double x, y, z;
|
||||
if (!XChartBucketMath.TryReduce(source, DimensionX, first, end, BucketReduce, m_BucketScratch, out x)
|
||||
|| !XChartBucketMath.TryReduce(source, DimensionY, first, end, BucketReduce, m_BucketScratch, out y)
|
||||
|| !XChartBucketMath.TryReduce(source, DimensionZ, first, end, BucketReduce, m_BucketScratch, out z))
|
||||
{
|
||||
// 整桶坏值:这个桶不画,也不拿别的桶的值顶替(那会造出一个不在数据里的点)
|
||||
continue;
|
||||
}
|
||||
|
||||
m_CubePoints[written] = ChartToolSpace.NormalizedToCube(new Vector3(
|
||||
Normalize(x, minX, maxX), Normalize(y, minY, maxY), Normalize(z, minZ, maxZ)));
|
||||
|
||||
if (EnableColorMapping)
|
||||
{
|
||||
double color;
|
||||
if (!XChartBucketMath.TryReduce(source, ColorMapDimension, first, end, BucketReduce, m_BucketScratch, out color))
|
||||
continue;
|
||||
m_ColorValues[written] = Normalize(color, colorMin, colorMax);
|
||||
}
|
||||
written++;
|
||||
}
|
||||
|
||||
if (written != m_CubePoints.Length) TrimPoints(written);
|
||||
}
|
||||
|
||||
private void ClearPoints()
|
||||
{
|
||||
m_CubePoints = new Vector3[0];
|
||||
m_Projected = new Vector2[0];
|
||||
m_PointColors = null;
|
||||
m_ColorValues = null;
|
||||
m_BucketCount = 0;
|
||||
m_SourceRecords = 0;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 只保留前 <paramref name="count"/> 个点:渲染器<b>按数组长度</b>提交,
|
||||
/// 不裁掉尾巴就会画出一批"上一轮的旧点"。
|
||||
/// </summary>
|
||||
private void TrimPoints(int count)
|
||||
{
|
||||
System.Array.Resize(ref m_CubePoints, count);
|
||||
System.Array.Resize(ref m_Projected, count);
|
||||
if (m_PointColors != null) System.Array.Resize(ref m_PointColors, count);
|
||||
if (m_ColorValues != null) System.Array.Resize(ref m_ColorValues, count);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 显示范围只问上下文要(覆盖优先、否则该维聚合;规则在 <see cref="XChartDomainMath"/>)。
|
||||
/// <b>范围本身归 chart 的维度行</b>(数据板块),元素只说要哪一维——
|
||||
/// 元素自己再存一份范围就是"点和轴对不上"的来路。
|
||||
/// </summary>
|
||||
private void ResolveRange(int dimension, out double min, out double max)
|
||||
{
|
||||
var context = Context;
|
||||
if (context != null && context.TryResolveDomain(dimension, out min, out max)) return;
|
||||
min = 0.0;
|
||||
max = 1.0;
|
||||
}
|
||||
|
||||
private static float Normalize(double value, double min, double max)
|
||||
{
|
||||
double span = max - min;
|
||||
if (span <= 0.0) return 0.5f;
|
||||
return Mathf.Clamp01((float)((value - min) / span));
|
||||
}
|
||||
|
||||
private void ApplyColorMapping()
|
||||
{
|
||||
if (m_NormalizedPoints.Length == 0) return;
|
||||
|
||||
if (m_PointColors == null || m_PointColors.Length != m_NormalizedPoints.Length)
|
||||
m_PointColors = new Color[m_NormalizedPoints.Length];
|
||||
|
||||
for (int i = 0; i < m_NormalizedPoints.Length; i++)
|
||||
{
|
||||
float value = m_NormalizedPoints[i][ColorMapAxis];
|
||||
// 从 [-1, 1] 映射到 [0, 1]
|
||||
float t = Mathf.Clamp01((value + 1f) * 0.5f);
|
||||
m_PointColors[i] = Color.Lerp(ColorMapMin, ColorMapMax, t);
|
||||
}
|
||||
if (m_ColorValues == null || m_PointColors == null) return;
|
||||
for (int i = 0; i < m_PointColors.Length && i < m_ColorValues.Length; i++)
|
||||
m_PointColors[i] = Color.Lerp(ColorMapMin, ColorMapMax, m_ColorValues[i]);
|
||||
}
|
||||
|
||||
// ── 清理 ──────────────────────────────────────────────────
|
||||
|
||||
protected override void OnDispose()
|
||||
{
|
||||
PointRenderer = null;
|
||||
CubeBg = null;
|
||||
m_NormalizedPoints = null;
|
||||
m_ProjectedPoints = null;
|
||||
m_CubePoints = null;
|
||||
m_Projected = null;
|
||||
m_PointColors = null;
|
||||
m_ColorValues = null;
|
||||
}
|
||||
|
||||
#if UNITY_EDITOR
|
||||
/// <summary>报表里点名这个组件这一帧提交了多少顶点——按点数长网格的元素靠它自证没撞 65535</summary>
|
||||
internal override void AppendDebugLine(System.Text.StringBuilder sb)
|
||||
{
|
||||
base.AppendDebugLine(sb);
|
||||
sb.Append(" points=").Append(m_CubePoints != null ? m_CubePoints.Length : 0)
|
||||
.Append(" pointVerts=").Append(PointRenderer != null ? PointRenderer.LiveVertexCount : 0)
|
||||
// 桶采样读数:画了几个点、源有多少条、取的是哪个统计量——"少画了多少"必须能看到
|
||||
.Append(" buckets=").Append(m_BucketCount)
|
||||
.Append(" records=").Append(m_SourceRecords)
|
||||
.Append(" reduce=").Append(BucketReduce);
|
||||
}
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,89 @@
|
||||
using System;
|
||||
using UnityEngine;
|
||||
using XericUI.XChart.Mesh;
|
||||
using XericUI.XChart.Space;
|
||||
|
||||
namespace XericUI.XChart.Pseudo3D
|
||||
{
|
||||
/// <summary>
|
||||
/// 立方体<b>线框</b>元素的配置(面板上叫 <c>BG Cube Wire</c>)。
|
||||
///
|
||||
/// <para><b>它只管 12 条棱</b>:前向一套色、后向一套色,后向棱可整体关掉。
|
||||
/// 面内格线不在这里——那是 <see cref="XChartMeshBgConfig"/>(<c>BG Cube Grid</c>)的活。
|
||||
/// 上一版两边都能画格线、还都往 <c>mesh.face.*.grid.S/.T</c> 同一批插槽上发布,
|
||||
/// 于是"关掉一边另一边又亮回来"+"改完别的再刷新一下这边的状态又反了"
|
||||
/// (他 2026-10-25 现场报的两条症状,同一个结构问题的两个面,规范 §22)。</para>
|
||||
///
|
||||
/// <para>姿态/半边长/中心偏移仍归 <see cref="XChartSpaceConfig"/>:投影是
|
||||
/// <c>基变换 ∘ 工具变换</c>,这里只出自己的工具变换。</para>
|
||||
///
|
||||
/// <para><b>为什么单独立一个元素配置</b>:这些旋钮原先是 <c>XPseudo3DScatterChart</c> 的
|
||||
/// 图级字段(面板「基础 → 立方体外观」)。渲染参数挂在图上,就有两个后果——
|
||||
/// 面板里它不在「工具」下("既然是工具就要放在工具下面"),以及换一张图/加第二个背景时
|
||||
/// 那份旋钮并不能复用。搬进元素表后,参数随元素走、脚本注册与配置注册同一条路(规范 §22)。</para>
|
||||
/// </summary>
|
||||
[Serializable]
|
||||
[XChartElement("cube-wire", "BG Cube Wire", 9)]
|
||||
public sealed class XChartCubeWireConfig : XChartElementConfig
|
||||
{
|
||||
[Header("工具变换")]
|
||||
[SerializeField, Tooltip("线框自己的缩放/旋转/平移。默认恒等——线框就占满图的空间")]
|
||||
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
|
||||
|
||||
[Header("棱线")]
|
||||
[SerializeField, Tooltip("前向棱颜色(至少有一端面朝向观察者)")]
|
||||
private Color m_FrontEdgeColor = new Color(0.7f, 0.7f, 0.7f, 1f);
|
||||
|
||||
[SerializeField, Tooltip("后向棱颜色(两面都背朝观察者的棱);透明度低一点就是\"透过去看到的淡线\"")]
|
||||
private Color m_BackEdgeColor = new Color(0.4f, 0.4f, 0.4f, 0.4f);
|
||||
|
||||
[SerializeField, Min(0.1f), Tooltip("棱线宽度(像素)")]
|
||||
private float m_EdgeThickness = 2f;
|
||||
|
||||
[SerializeField, Tooltip("显示后向棱:关掉就只剩看得见的那一面外壳")]
|
||||
private bool m_ShowBackEdges = true;
|
||||
|
||||
/// <summary>元素在 ToolsRoot 下的名字</summary>
|
||||
public override string ElementName => "BG Cube Wire";
|
||||
|
||||
// 脚本入口:写的就是下面这些序列化字段(配置是权威,工具在 ApplyTo 里读它),
|
||||
// 所以不存在"脚本改了一份、面板显示另一份"
|
||||
/// <summary>前向棱颜色</summary>
|
||||
public Color FrontEdgeColor { get => m_FrontEdgeColor; set => m_FrontEdgeColor = value; }
|
||||
|
||||
/// <summary>后向棱颜色</summary>
|
||||
public Color BackEdgeColor { get => m_BackEdgeColor; set => m_BackEdgeColor = value; }
|
||||
|
||||
/// <summary>棱线宽度</summary>
|
||||
public float EdgeThickness { get => m_EdgeThickness; set => m_EdgeThickness = Mathf.Max(0.1f, value); }
|
||||
|
||||
/// <summary>是否显示后向棱</summary>
|
||||
public bool ShowBackEdges { get => m_ShowBackEdges; set => m_ShowBackEdges = value; }
|
||||
|
||||
public override XChartToolBase CreateTool() => new ChartToolCubeBg();
|
||||
|
||||
public override void ApplyTo(XChartToolBase tool)
|
||||
{
|
||||
if (!(tool is ChartToolCubeBg wire)) return;
|
||||
|
||||
wire.Transform = m_Transform;
|
||||
wire.FrontEdgeColor = m_FrontEdgeColor;
|
||||
wire.BackEdgeColor = m_BackEdgeColor;
|
||||
wire.EdgeThickness = m_EdgeThickness;
|
||||
wire.ShowBackEdges = m_ShowBackEdges;
|
||||
|
||||
wire.MarkDirty();
|
||||
}
|
||||
|
||||
public override void CaptureFrom(XChartToolBase tool)
|
||||
{
|
||||
if (!(tool is ChartToolCubeBg wire)) return;
|
||||
|
||||
m_Transform = wire.Transform;
|
||||
m_FrontEdgeColor = wire.FrontEdgeColor;
|
||||
m_BackEdgeColor = wire.BackEdgeColor;
|
||||
m_EdgeThickness = wire.EdgeThickness;
|
||||
m_ShowBackEdges = wire.ShowBackEdges;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
fileFormatVersion: 2
|
||||
guid: ef9b3c372cf02f44b9a32242b420cbef
|
||||
MonoImporter:
|
||||
externalObjects: {}
|
||||
serializedVersion: 2
|
||||
defaultReferences: []
|
||||
executionOrder: 0
|
||||
icon: {instanceID: 0}
|
||||
userData:
|
||||
assetBundleName:
|
||||
assetBundleVariant:
|
||||
@@ -1,48 +1,44 @@
|
||||
using UnityEngine;
|
||||
using XericLibrary.Runtime.UIGraph;
|
||||
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
|
||||
using XericUI.Core;
|
||||
using XericUI.XChart.Mesh;
|
||||
using XericUI.XChart.Space;
|
||||
|
||||
namespace XericUI.XChart.Pseudo3D
|
||||
{
|
||||
/// <summary>
|
||||
/// 伪 3D 散点图主组件。
|
||||
///
|
||||
/// 在 UI 平面上绘制一个带有透视效果的 3D 散点图:
|
||||
/// - 立方体线框代表三维空间边界
|
||||
/// - 三个可见面上的标线网格帮助定位
|
||||
/// - 数据点以图元(多边形/矩形)形式渲染在立方体内部
|
||||
/// <para><b>这张图自己不画任何东西</b>(规范 §22):立方体线框、面内格线、散点都是「工具」,
|
||||
/// 参数在面板「工具」下的那一块块里。立方体三件(空间 / 线框 / 网格)在元素表空时由
|
||||
/// <see cref="DeclareDefaultElements"/> 补成默认元素——所以新挂一张图就是能用的样子,
|
||||
/// 而每一块都能被单独删掉、复制、改序。</para>
|
||||
///
|
||||
/// 使用方式:
|
||||
/// 1. 在场景中创建空 GameObject,挂载本组件
|
||||
/// 2. 设置数据:chart.SetData(xs, ys, zs)
|
||||
/// 3. 调整外观参数
|
||||
/// 3. 外观参数在面板「工具」下改(旧版这里是「基础 → 立方体外观」,那份字段已删)
|
||||
///
|
||||
/// 子节点结构:
|
||||
/// [XPseudo3DScatterChart]
|
||||
/// └─ [XChartTools]
|
||||
/// ├─ [ChartTool_CubeBg] ← 立方体线框 + 网格
|
||||
/// │ ├─ CubeEdgeRenderer (UILineRendererV2)
|
||||
/// │ └─ CubeGridRenderer (UILineRendererV2)
|
||||
/// └─ [ChartTool_ScatterPoints]
|
||||
/// └─ PointRenderer (XScatterPointRenderer)
|
||||
/// 子节点结构(工具根节点下,名字=元素名):
|
||||
/// [XChartTools]
|
||||
/// ├─ Space ← 基变换(四元数 + 半边长)
|
||||
/// ├─ BG Cube Wire ← 12 条棱;发布 mesh.face.* 四角
|
||||
/// ├─ BG Cube Grid ← 面填充 + 面内格线;格线的唯一作者(也发布 .grid.S/.T)
|
||||
/// └─ ChartTool_ScatterPoints
|
||||
/// └─ PointRenderer (XScatterPointRenderer)
|
||||
/// </summary>
|
||||
[AddComponentMenu("Xeric/XChart/Pseudo3D/Pseudo3D Scatter Chart")]
|
||||
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Pseudo3D Scatter Chart")]
|
||||
[ExecuteAlways]
|
||||
public class XPseudo3DScatterChart : XChartBase
|
||||
{
|
||||
// ── 串行化字段(Inspector 可编辑) ────────────────────────
|
||||
|
||||
[Header("立方体外观")]
|
||||
[SerializeField] private float m_CubeHalfSize = 150f;
|
||||
[SerializeField] private float m_Pitch = 25f;
|
||||
[SerializeField] private float m_Yaw = -30f;
|
||||
[SerializeField] private Color m_FrontEdgeColor = new Color(0.7f, 0.7f, 0.7f, 1f);
|
||||
[SerializeField] private Color m_BackEdgeColor = new Color(0.4f, 0.4f, 0.4f, 0.3f);
|
||||
[SerializeField] private float m_EdgeThickness = 2f;
|
||||
[SerializeField] private Color m_GridLineColor = new Color(0.5f, 0.5f, 0.5f, 0.25f);
|
||||
[SerializeField] private int m_GridDivisions = 5;
|
||||
[SerializeField] private bool m_ShowBackEdges = true;
|
||||
[SerializeField] private bool m_ShowGridLines = true;
|
||||
//
|
||||
// 「立方体外观」那组字段以前住在这里(半边长 / 四元数 / 尺寸口径 / 前后棱颜色 / 格线颜色 /
|
||||
// 分格数 S,T / 两个显示开关)。它们是**渲染参数**,挂在图上就有两个毛病:面板里它不在
|
||||
// 「工具」下、换一张图不能复用。现在它们各自是元素表里的一条配置
|
||||
// (<see cref="XChartSpaceConfig"/> / <see cref="XChartCubeWireConfig"/> /
|
||||
// <see cref="XChartMeshBgConfig"/>),默认值由 <see cref="DeclareDefaultElements"/> 给。
|
||||
|
||||
[Header("散点外观")]
|
||||
[SerializeField] private PrimitiveType m_PointType = PrimitiveType.Polygon;
|
||||
@@ -67,7 +63,6 @@ namespace XericUI.XChart.Pseudo3D
|
||||
|
||||
// ── 工具引用 ──────────────────────────────────────────────
|
||||
|
||||
private ChartToolCubeBg m_CubeBg;
|
||||
private ChartToolScatterPoints m_ScatterPoints;
|
||||
|
||||
// ── 数据模型 ──────────────────────────────────────────────
|
||||
@@ -77,12 +72,51 @@ namespace XericUI.XChart.Pseudo3D
|
||||
/// <summary>3D 数据模型(只读)</summary>
|
||||
public XChartDataModel3D DataModel3D => m_DataModel;
|
||||
|
||||
// ── 默认元素 ──────────────────────────────────────────────
|
||||
|
||||
/// <summary>
|
||||
/// 立方体这三件(坐标系 / 线框 / 网格)默认就是图的一部分:元素表空着时补上,
|
||||
/// 补完之后它们就在面板「工具」下,可以单独删、单独调、可以复制一份变成两个背景。
|
||||
///
|
||||
/// <para><b>网格那份的默认值=旧版「立方体外观」那组字段的默认行为</b>:不填面(填充是网格元素
|
||||
/// 自己的可选项,旧图没有)、六面都画格线但只画朝向观察者的那几面(=旧线框工具的画法)、
|
||||
/// 不描面轮廓(轮廓由线框那 12 条棱管,描两遍只会让边变粗)。
|
||||
/// 其余参数取各类配置自己的默认值,所以新挂一张图的样子和以前一致。</para>
|
||||
/// </summary>
|
||||
protected override void DeclareDefaultElements()
|
||||
{
|
||||
AddDefaultElement(new XChartSpaceConfig { OrderIndex = -1000 });
|
||||
AddDefaultElement(new XChartCubeWireConfig { OrderIndex = 0, DrawOrder = 0 });
|
||||
AddDefaultElement(new XChartMeshBgConfig
|
||||
{
|
||||
OrderIndex = 1,
|
||||
DrawOrder = 1,
|
||||
FillFaces = XChartCubeFaceMask.None,
|
||||
GridFaces = XChartCubeFaceMask.All,
|
||||
OnlyVisibleFaces = true,
|
||||
ShowFaceOutline = false,
|
||||
});
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 元素表里某一类配置的第一个实例(脚本要改外观参数就走它,不再自带一份字段——
|
||||
/// 两处存同一件事就是"改了没反应"的来路)。没有就返回 null,调用方不当没发生也不崩。
|
||||
/// </summary>
|
||||
private T ElementOf<T>() where T : XChartElementConfig
|
||||
{
|
||||
return XChartElementTable.FirstOfKind(Elements, typeof(T)) as T;
|
||||
}
|
||||
|
||||
// ── 初始化 ────────────────────────────────────────────────
|
||||
|
||||
protected override void OnEnable()
|
||||
{
|
||||
base.OnEnable();
|
||||
EnsureToolsCreated();
|
||||
// 维度定义要在<b>没有数据的时候</b>就存在:面板的"数据"板块是按维度逐行给的,
|
||||
// 只在第一次喂点时定义维度,就会出现"图里还没数据 ⇒ 一行都没有、无处填范围"
|
||||
// (P4 验收现场:"没有看到维度数据行"就是这一条)
|
||||
EnsureSharedDimensions();
|
||||
}
|
||||
|
||||
private void Start()
|
||||
@@ -94,55 +128,25 @@ namespace XericUI.XChart.Pseudo3D
|
||||
|
||||
private void EnsureToolsCreated()
|
||||
{
|
||||
if (m_CubeBg != null && m_ScatterPoints != null) return;
|
||||
if (m_ScatterPoints != null) return;
|
||||
|
||||
// 创建立方体背景工具(OrderIndex 0,先渲染)
|
||||
if (m_CubeBg == null)
|
||||
{
|
||||
m_CubeBg = AddTool<ChartToolCubeBg>("ChartTool_CubeBg", 0);
|
||||
}
|
||||
|
||||
// 创建散点工具(OrderIndex 10,后渲染,在上层)
|
||||
if (m_ScatterPoints == null)
|
||||
{
|
||||
m_ScatterPoints = AddTool<ChartToolScatterPoints>("ChartTool_ScatterPoints", 10);
|
||||
m_ScatterPoints.CubeBg = m_CubeBg;
|
||||
}
|
||||
// 散点是"这张图必需的那个读数据的工具",所以走脚本注册(OrderIndex 10,画在背景之上)。
|
||||
// 立方体的三件(空间/线框/网格)不在这里:它们是元素表里的配置,面板上看得见能改。
|
||||
m_ScatterPoints = AddTool<ChartToolScatterPoints>("ChartTool_ScatterPoints", 10);
|
||||
}
|
||||
|
||||
// ── 参数同步 ──────────────────────────────────────────────
|
||||
|
||||
private void SyncAllParams()
|
||||
{
|
||||
SyncCubeParams();
|
||||
SyncPointParams();
|
||||
}
|
||||
|
||||
private void SyncCubeParams()
|
||||
{
|
||||
if (m_CubeBg == null) return;
|
||||
m_CubeBg.CubeHalfSize = m_CubeHalfSize;
|
||||
m_CubeBg.Pitch = m_Pitch;
|
||||
m_CubeBg.Yaw = m_Yaw;
|
||||
m_CubeBg.FrontEdgeColor = m_FrontEdgeColor;
|
||||
m_CubeBg.BackEdgeColor = m_BackEdgeColor;
|
||||
m_CubeBg.EdgeThickness = m_EdgeThickness;
|
||||
m_CubeBg.GridLineColor = m_GridLineColor;
|
||||
m_CubeBg.GridDivisions = m_GridDivisions;
|
||||
m_CubeBg.ShowBackEdges = m_ShowBackEdges;
|
||||
m_CubeBg.ShowGridLines = m_ShowGridLines;
|
||||
m_CubeBg.MarkProjectionDirty();
|
||||
|
||||
// 投影变化时,散点需要重新投影
|
||||
if (m_ScatterPoints != null)
|
||||
m_ScatterPoints.MarkDataDirty();
|
||||
}
|
||||
|
||||
private void SyncPointParams()
|
||||
{
|
||||
if (m_ScatterPoints == null) return;
|
||||
m_ScatterPoints.PointType = m_PointType;
|
||||
m_ScatterPoints.SizeMode = m_PointSizeMode;
|
||||
m_ScatterPoints.PointSizeMode = m_PointSizeMode;
|
||||
m_ScatterPoints.PointSize = m_PointSize;
|
||||
m_ScatterPoints.PointColor = m_PointColor;
|
||||
m_ScatterPoints.CenterColor = m_PointCenterColor;
|
||||
@@ -154,7 +158,7 @@ namespace XericUI.XChart.Pseudo3D
|
||||
m_ScatterPoints.EnableColorMapping = m_EnableColorMapping;
|
||||
m_ScatterPoints.ColorMapMin = m_ColorMapMin;
|
||||
m_ScatterPoints.ColorMapMax = m_ColorMapMax;
|
||||
m_ScatterPoints.ColorMapAxis = m_ColorMapAxis;
|
||||
m_ScatterPoints.ColorMapDimension = m_ColorMapAxis;
|
||||
}
|
||||
|
||||
// ── 每帧更新 ──────────────────────────────────────────────
|
||||
@@ -174,26 +178,23 @@ namespace XericUI.XChart.Pseudo3D
|
||||
|
||||
#region 公共 API
|
||||
|
||||
/// <summary>刷新图表(重新投影所有数据点)</summary>
|
||||
/// <summary>
|
||||
/// 刷新图表:让散点重读数据源、让空间重投影。
|
||||
/// <b>点现在是从图共享的序列化数据源里读的</b>(散点元素自己按维度下标 + 聚合范围归一化),
|
||||
/// 所以存进预制体的数据重开预制体后还在——以前读的是本组件那份非序列化的 3D 模型,一重载就空。
|
||||
/// </summary>
|
||||
public void RefreshChart()
|
||||
{
|
||||
EnsureToolsCreated();
|
||||
|
||||
// 标记立方体投影需要重新计算
|
||||
if (m_CubeBg != null)
|
||||
m_CubeBg.MarkProjectionDirty();
|
||||
var space = Space;
|
||||
if (space != null) space.MarkProjectionDirty();
|
||||
|
||||
// 获取归一化数据点并传递给散点工具
|
||||
if (m_ScatterPoints != null && m_DataModel.HasData)
|
||||
if (m_ScatterPoints != null)
|
||||
{
|
||||
var normalized = m_DataModel.GetNormalizedPoints();
|
||||
m_ScatterPoints.SetNormalizedPoints(normalized);
|
||||
m_ScatterPoints.AutoFromData = true;
|
||||
m_ScatterPoints.MarkDataDirty();
|
||||
}
|
||||
else if (m_ScatterPoints != null)
|
||||
{
|
||||
m_ScatterPoints.SetNormalizedPoints(null);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>设置散点数据</summary>
|
||||
@@ -255,73 +256,140 @@ namespace XericUI.XChart.Pseudo3D
|
||||
public void ClearData()
|
||||
{
|
||||
m_DataModel.ClearAll();
|
||||
DataModel.Clear();
|
||||
RefreshChart();
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
// ── 外观属性(运行时属性) ─────────────────────────────────
|
||||
// ── 外观属性(转发到元素表) ───────────────────────────────
|
||||
|
||||
#region 运行时属性
|
||||
|
||||
/// <summary>
|
||||
/// 这一组属性以前<b>各配一个序列化字段</b>,再由 <c>SyncCubeParams</c> 灌进工具:
|
||||
/// 于是"面板上改元素"与"脚本改属性"写的是两处状态,谁后跑谁赢——他报的"勾选了反而消失"
|
||||
/// 就是这类结构的一个面(规范 §22)。现在读写的是<b>元素表里那份配置本身</b>:
|
||||
/// 脚本、面板、预制体看到的是同一个数,没有第二份需要同步。
|
||||
/// </summary>
|
||||
private void PushCubeLook()
|
||||
{
|
||||
ReapplyElements();
|
||||
ForceRefresh();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 坐标系元素(姿态 / 半边长 / 尺寸口径的权威)。基类保证图里有一个 <see cref="XChartBase.Space"/>
|
||||
/// 工具,但<b>配置</b>可以整条删掉——删了这里就是 null:getter 给中性值、setter 什么都不做,
|
||||
/// 既不抛也不背着他造一个元素回来。
|
||||
/// </summary>
|
||||
public XChartSpaceConfig SpaceElement => ElementOf<XChartSpaceConfig>();
|
||||
|
||||
/// <summary>线框元素(前后棱颜色 / 棱宽 / 后向棱开关的权威)</summary>
|
||||
public XChartCubeWireConfig WireElement => ElementOf<XChartCubeWireConfig>();
|
||||
|
||||
/// <summary>网格元素(格线颜色 / 分格数 / 画哪些面的权威)</summary>
|
||||
public XChartMeshBgConfig GridElement => ElementOf<XChartMeshBgConfig>();
|
||||
|
||||
public float CubeHalfSize
|
||||
{
|
||||
get => m_CubeHalfSize;
|
||||
set { m_CubeHalfSize = value; SyncCubeParams(); }
|
||||
get { var e = SpaceElement; return e != null ? e.HalfEdge : 0f; }
|
||||
set { var e = SpaceElement; if (e == null) return; e.HalfEdge = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public float Pitch
|
||||
/// <summary>姿态四元数——唯一的旋转权威量(没有相机位置可调)</summary>
|
||||
public Quaternion Rotation
|
||||
{
|
||||
get => m_Pitch;
|
||||
set { m_Pitch = value; SyncCubeParams(); }
|
||||
get { var e = SpaceElement; return e != null ? e.Rotation : Quaternion.identity; }
|
||||
set { var e = SpaceElement; if (e == null) return; e.Rotation = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public float Yaw
|
||||
/// <summary>一步跳到某个预设视角,等价于把那个四元数写进 <see cref="Rotation"/></summary>
|
||||
public void ApplyViewPreset(XChartCubeViewPreset preset)
|
||||
{
|
||||
get => m_Yaw;
|
||||
set { m_Yaw = value; SyncCubeParams(); }
|
||||
var e = SpaceElement;
|
||||
if (e == null) return;
|
||||
e.ApplyViewPreset(preset);
|
||||
PushCubeLook();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 立方体尺寸口径(默认半边长:立方体大小不随旋转变化)。
|
||||
/// 名字必须带 Cube 前缀:本类还有散点用的 <c>SizeMode</c>(UIGraph 那个类型),
|
||||
/// 同名会让散点那份字段的初始化器把类型名解成这个属性(CS0236)。
|
||||
/// </summary>
|
||||
public XChartCubeSizeMode CubeSizeMode
|
||||
{
|
||||
get { var e = SpaceElement; return e != null ? e.SizeMode : XChartCubeSizeMode.HalfEdgeLength; }
|
||||
set { var e = SpaceElement; if (e == null) return; e.SizeMode = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public Color FrontEdgeColor
|
||||
{
|
||||
get => m_FrontEdgeColor;
|
||||
set { m_FrontEdgeColor = value; SyncCubeParams(); }
|
||||
get { var e = WireElement; return e != null ? e.FrontEdgeColor : Color.clear; }
|
||||
set { var e = WireElement; if (e == null) return; e.FrontEdgeColor = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public Color BackEdgeColor
|
||||
{
|
||||
get => m_BackEdgeColor;
|
||||
set { m_BackEdgeColor = value; SyncCubeParams(); }
|
||||
get { var e = WireElement; return e != null ? e.BackEdgeColor : Color.clear; }
|
||||
set { var e = WireElement; if (e == null) return; e.BackEdgeColor = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public float EdgeThickness
|
||||
{
|
||||
get => m_EdgeThickness;
|
||||
set { m_EdgeThickness = value; SyncCubeParams(); }
|
||||
}
|
||||
|
||||
public Color GridLineColor
|
||||
{
|
||||
get => m_GridLineColor;
|
||||
set { m_GridLineColor = value; SyncCubeParams(); }
|
||||
}
|
||||
|
||||
public int GridDivisions
|
||||
{
|
||||
get => m_GridDivisions;
|
||||
set { m_GridDivisions = Mathf.Max(1, value); SyncCubeParams(); }
|
||||
get { var e = WireElement; return e != null ? e.EdgeThickness : 0f; }
|
||||
set { var e = WireElement; if (e == null) return; e.EdgeThickness = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public bool ShowBackEdges
|
||||
{
|
||||
get => m_ShowBackEdges;
|
||||
set { m_ShowBackEdges = value; SyncCubeParams(); }
|
||||
get { var e = WireElement; return e != null && e.ShowBackEdges; }
|
||||
set { var e = WireElement; if (e == null) return; e.ShowBackEdges = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
/// <summary>格线颜色(旧名 GridLineColor,现归网格元素)</summary>
|
||||
public Color GridLineColor
|
||||
{
|
||||
get { var e = GridElement; return e != null ? e.GridColor : Color.clear; }
|
||||
set { var e = GridElement; if (e == null) return; e.GridColor = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public int GridDivisions
|
||||
{
|
||||
get { var e = GridElement; return e != null ? e.GridDivisions : 0; }
|
||||
set { var e = GridElement; if (e == null) return; e.GridDivisions = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
/// <summary>S 方向分格数(0=跟随统一值)。按方向分是为了让两条轴各自都能和格线对齐</summary>
|
||||
public int GridDivisionsS
|
||||
{
|
||||
get { var e = GridElement; return e != null ? e.GridDivisionsS : 0; }
|
||||
set { var e = GridElement; if (e == null) return; e.GridDivisionsS = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
public int GridDivisionsT
|
||||
{
|
||||
get { var e = GridElement; return e != null ? e.GridDivisionsT : 0; }
|
||||
set { var e = GridElement; if (e == null) return; e.GridDivisionsT = value; PushCubeLook(); }
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 格线开关的旧写法。<b>它现在的真身是网格元素的 <see cref="XChartMeshBgConfig.GridFaces"/> 掩码</b>:
|
||||
/// 开=六面都画,关=一面都不画。以前图上这个 bool 和线框里的另一套开关并存,
|
||||
/// 两边都往同一批格线插槽上发布,才有"关掉一边另一边又亮回来"(规范 §22)。
|
||||
/// 只画后墙那类"部分面"请直接改掩码。
|
||||
/// </summary>
|
||||
public bool ShowGridLines
|
||||
{
|
||||
get => m_ShowGridLines;
|
||||
set { m_ShowGridLines = value; SyncCubeParams(); }
|
||||
get { var e = GridElement; return e != null && e.GridFaces != XChartCubeFaceMask.None; }
|
||||
set
|
||||
{
|
||||
var e = GridElement;
|
||||
if (e == null) return;
|
||||
e.GridFaces = value ? XChartCubeFaceMask.All : XChartCubeFaceMask.None;
|
||||
PushCubeLook();
|
||||
}
|
||||
}
|
||||
|
||||
public float PointSize
|
||||
@@ -382,18 +450,24 @@ namespace XericUI.XChart.Pseudo3D
|
||||
|
||||
// ── 编辑器 ────────────────────────────────────────────────
|
||||
|
||||
#if UNITY_EDITOR
|
||||
private void OnValidate()
|
||||
/// <summary>
|
||||
/// 必须 override 基类的 OnValidate 并调 base——以前这里写的是 <c>private void OnValidate()</c>,
|
||||
/// 它把基类那份遮掉了,导致基类的"重灌元素 + 强制刷新"对这个组件从未执行。
|
||||
/// 本图还没迁到 <c>OnChartRefresh</c>,所以自己那套参数同步仍在自己的 delayCall 里推。
|
||||
/// </summary>
|
||||
protected override void OnValidate()
|
||||
{
|
||||
if (m_GridDivisions < 1) m_GridDivisions = 1;
|
||||
if (m_PointSideCount < 3) m_PointSideCount = 3;
|
||||
if (m_PointSize < 0.5f) m_PointSize = 0.5f;
|
||||
if (m_CubeHalfSize < 10f) m_CubeHalfSize = 10f;
|
||||
if (m_ColorMapAxis < 0) m_ColorMapAxis = 0;
|
||||
if (m_ColorMapAxis > 2) m_ColorMapAxis = 2;
|
||||
|
||||
// 编辑器下延迟同步,确保 Awake/Start 已执行
|
||||
if (isActiveAndEnabled && m_CubeBg != null)
|
||||
base.OnValidate();
|
||||
|
||||
#if UNITY_EDITOR
|
||||
// 编辑器下延迟一拍再同步,确保 Awake/OnEnable 已执行
|
||||
// (立方体那几件不归这里管了:基类的 base.OnValidate 已经"重灌元素 + 强制刷新"过)
|
||||
if (isActiveAndEnabled)
|
||||
{
|
||||
UnityEditor.EditorApplication.delayCall += () =>
|
||||
{
|
||||
@@ -404,7 +478,7 @@ namespace XericUI.XChart.Pseudo3D
|
||||
}
|
||||
};
|
||||
}
|
||||
}
|
||||
#endif
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
using UnityEngine;
|
||||
using XericLibrary.Runtime.UIGraph;
|
||||
using UIPrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
|
||||
using XericUI.Core;
|
||||
|
||||
namespace XericUI.XChart.Pseudo3D
|
||||
{
|
||||
@@ -12,7 +13,7 @@ namespace XericUI.XChart.Pseudo3D
|
||||
///
|
||||
/// 相比为每个点创建独立的 UIPrimitiveRenderer,本组件大幅减少 GameObject 数量和 Draw Call。
|
||||
/// </summary>
|
||||
[AddComponentMenu("Xeric/XChart/Pseudo3D/Scatter Point Renderer")]
|
||||
[AddComponentMenu(XericRegistrationPaths.Chart + "/Pseudo3D/Scatter Point Renderer")]
|
||||
public class XScatterPointRenderer : PrimitiveCacheRendererBase
|
||||
{
|
||||
// ── 全局形状参数 ──────────────────────────────────────────
|
||||
@@ -64,6 +65,14 @@ namespace XericUI.XChart.Pseudo3D
|
||||
/// <param name="colors">可选:每个点的颜色(null 则使用 fillColor)</param>
|
||||
public void SetPoints(Vector2[] positions, Color[] colors = null)
|
||||
{
|
||||
// null 的意思是"没有点了,清空"。当成数据去读 .Length 就是一条 NRE,
|
||||
// 而这条 NRE 会把管理器渲染循环里后面的所有工具一起带走(现象:加一个元素,全图不显示)。
|
||||
if (positions == null)
|
||||
{
|
||||
ClearAll();
|
||||
return;
|
||||
}
|
||||
|
||||
ClearAll();
|
||||
|
||||
for (int i = 0; i < positions.Length; i++)
|
||||
|
||||
Reference in New Issue
Block a user