添加图表功能。

This commit is contained in:
2026-08-21 11:52:08 +08:00
parent b132e8e167
commit 5a28ab5c59
27 changed files with 3102 additions and 0 deletions
+461
View File
@@ -0,0 +1,461 @@
using System.Collections.Generic;
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 伪 3D 立方体背景工具。
///
/// 使用 UILineRendererV2 绘制:
/// 1. 立方体 12 条棱的线框(前向棱使用实色,后向棱可选半透明)
/// 2. 三个可见面上的轴标线网格
///
/// 3D 坐标系统:
/// 立方体中心在原点,半边长 1(即 [-1, 1] 范围)。
/// 通过 pitch/yaw 旋转后进行正交投影(丢弃 Z 轴)得到 2D UI 坐标。
/// 最终通过 scale + offset 映射到 RectTransform 的像素空间。
///
/// 子节点结构:
/// [ChartTool_CubeBg]
/// └─ CubeRenderer (UILineRendererV2)
/// </summary>
[AddComponentMenu("Xeric/XChart/Pseudo3D/Cube 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 Color FrontEdgeColor { get; set; } = new Color(0.7f, 0.7f, 0.7f, 1f);
/// <summary>后向棱颜色</summary>
public Color BackEdgeColor { get; set; } = new Color(0.4f, 0.4f, 0.4f, 0.4f);
/// <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;
/// <summary>投影版本号(每次投影矩阵变化时递增,供外部检测变化)</summary>
public int ProjectionVersion { get; private set; } = 0;
private Matrix4x4 m_RotationMatrix;
private float m_Scale;
private Vector2 m_Offset;
// ── 初始化 ────────────────────────────────────────────────
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;
}
SetVisible(true);
}
// ── 更新投影矩阵 ──────────────────────────────────────────
private void UpdateProjection()
{
if (!m_ProjectionDirty) return;
m_ProjectionDirty = false;
// 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);
}
}
/// <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()
{
base.OnRender();
if (EdgeRenderer == null) return;
UpdateProjection();
// 绘制棱线
DrawEdges();
// 绘制网格标线
if (GridRenderer != null)
{
if (ShowGridLines)
{
DrawGridLines();
GridRenderer.RootObject.SetActive(true);
}
else
{
GridRenderer.RootObject.SetActive(false);
}
}
}
// ── 棱线绘制 ──────────────────────────────────────────────
private void DrawEdges()
{
EdgeRenderer.ClearAll();
// 确定前向棱:棱的两个顶点中,Z 值较大的为前向
// 更准确:棱所属的面中,法线 Z > 0 的面为可见面
// 简单方法:棱的两个顶点的 rotated Z 平均值 > 0 为前向
var frontVerts = new List<LineVertexData>();
var backVerts = new List<LineVertexData>();
for (int e = 0; e < 12; 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;
list.Add(new LineVertexData
{
position = m_ProjectedVerts[v0],
color = isFront ? FrontEdgeColor : BackEdgeColor,
thickness = EdgeThickness,
userData = Vector4.zero,
});
list.Add(new LineVertexData
{
position = m_ProjectedVerts[v1],
color = isFront ? FrontEdgeColor : BackEdgeColor,
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);
}
}
for (int i = 0; i < frontVerts.Count; i += 2)
{
EdgeRenderer.DrawLine(
frontVerts[i].position,
frontVerts[i + 1].position,
frontVerts[i].color,
frontVerts[i].thickness);
}
}
// ── 网格标线绘制 ──────────────────────────────────────────
private void DrawGridLines()
{
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);
}
}
// ── 清理 ──────────────────────────────────────────────────
protected override void OnDispose()
{
EdgeRenderer = null;
GridRenderer = null;
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 032a5991fdcc71d4491a44248dc05d19
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
@@ -0,0 +1,261 @@
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
using PrimitiveType = XericLibrary.Runtime.UIGraph.PrimitiveType;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 散点渲染工具。
///
/// 使用 XScatterPointRenderer 渲染 3D 散点数据在 2D 平面上的投影。
/// 数据点从 3D 立方体空间投影到 UI 坐标,每个点用一个图元表示。
///
/// 子节点结构:
/// [ChartTool_ScatterPoints]
/// └─ PointRenderer (XScatterPointRenderer)
/// </summary>
[AddComponentMenu("Xeric/XChart/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(); }
}
private float m_PointSize = 8f;
/// <summary>图元类型</summary>
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;
/// <summary>填充颜色</summary>
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(); }
}
private Color m_CenterColor = Color.white;
/// <summary>边框颜色</summary>
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(); }
}
private float m_BorderThickness = 1f;
/// <summary>多边形边数</summary>
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;
/// <summary>图元旋转角度</summary>
public float PointAngle
{
get => m_PointAngle;
set { m_PointAngle = value; if (IsInitialized) SyncShapeParams(); }
}
private float m_PointAngle = 0f;
/// <summary>是否使用颜色渐变(按数据范围)</summary>
public bool EnableColorMapping { get; set; } = false;
/// <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 XScatterPointRenderer PointRenderer { get; private set; }
/// <summary>对 CubeBg 工具的引用(用于投影)</summary>
public ChartToolCubeBg CubeBg { get; set; }
// ── 数据缓存 ──────────────────────────────────────────────
private Vector3[] m_NormalizedPoints = new Vector3[0];
private Vector2[] m_ProjectedPoints = new Vector2[0];
private bool m_DataDirty = true;
private int m_LastProjectionVersion = -1;
// ── 初始化 ────────────────────────────────────────────────
protected override void OnInitialize()
{
PointRenderer = CreateChildComponent<XScatterPointRenderer>("PointRenderer");
if (PointRenderer != null)
{
var rt = PointRenderer.rectTransform;
rt.anchorMin = Vector2.zero;
rt.anchorMax = Vector2.one;
rt.offsetMin = Vector2.zero;
rt.offsetMax = Vector2.zero;
}
SyncShapeParams();
SetVisible(true);
}
// ── 形状参数同步 ──────────────────────────────────────────
private void SyncShapeParams()
{
if (PointRenderer == null) return;
PointRenderer.pointType = m_PointType;
PointRenderer.sizeMode = m_SizeMode;
PointRenderer.pointSize = m_PointSize;
PointRenderer.fillColor = m_PointColor;
PointRenderer.centerColor = m_CenterColor;
PointRenderer.borderColor = m_BorderColor;
PointRenderer.borderThickness = m_BorderThickness;
PointRenderer.sideCount = m_SideCount;
PointRenderer.chamferSize = m_ChamferSize;
PointRenderer.chamferSegments = 4;
PointRenderer.angle = m_PointAngle;
// 如果已有数据,触发形状重建
if (m_NormalizedPoints.Length > 0)
{
PointRenderer.UpdateShapeParams();
}
}
// ── 数据更新 ──────────────────────────────────────────────
/// <summary>
/// 设置要渲染的 3D 点(归一化到 [-1, 1] 立方体空间)。
/// </summary>
public void SetNormalizedPoints(Vector3[] normalizedPoints)
{
m_NormalizedPoints = normalizedPoints ?? new Vector3[0];
m_ProjectedPoints = new Vector2[m_NormalizedPoints.Length];
m_DataDirty = true;
}
/// <summary>标记数据需要重新投影</summary>
public void MarkDataDirty()
{
m_DataDirty = true;
}
// ── 渲染 ──────────────────────────────────────────────────
public override void OnRender()
{
base.OnRender();
if (PointRenderer == null || CubeBg == null) return;
if (m_NormalizedPoints.Length == 0) return;
bool projectionChanged = CubeBg.ProjectionVersion != m_LastProjectionVersion;
// 如果数据脏了或立方体投影发生了变化,重新投影所有点
if (m_DataDirty || projectionChanged)
{
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;
}
}
// ── 颜色映射 ──────────────────────────────────────────────
private Color[] m_PointColors;
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);
}
}
// ── 清理 ──────────────────────────────────────────────────
protected override void OnDispose()
{
PointRenderer = null;
CubeBg = null;
m_NormalizedPoints = null;
m_ProjectedPoints = null;
m_PointColors = null;
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 63688f4e07bc3a44197a1fe0cec994a9
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
@@ -0,0 +1,386 @@
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 伪 3D 散点图主组件。
///
/// 在 UI 平面上绘制一个带有透视效果的 3D 散点图:
/// - 立方体线框代表三维空间边界
/// - 三个可见面上的标线网格帮助定位
/// - 数据点以图元(多边形/矩形)形式渲染在立方体内部
///
/// 使用方式:
/// 1. 在场景中创建空 GameObject,挂载本组件
/// 2. 设置数据:chart.SetData(xs, ys, zs)
/// 3. 调整外观参数
///
/// 子节点结构:
/// [XPseudo3DScatterChart]
/// └─ [XChartTools]
/// ├─ [ChartTool_CubeBg] ← 立方体线框 + 网格
/// │ ├─ CubeEdgeRenderer (UILineRendererV2)
/// │ └─ CubeGridRenderer (UILineRendererV2)
/// └─ [ChartTool_ScatterPoints]
/// └─ PointRenderer (XScatterPointRenderer)
/// </summary>
[AddComponentMenu("Xeric/XChart/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;
[Header("散点外观")]
[SerializeField] private PrimitiveType m_PointType = PrimitiveType.Polygon;
[SerializeField] private SizeMode m_PointSizeMode = SizeMode.InscribedCircle;
[SerializeField] private float m_PointSize = 8f;
[SerializeField] private Color m_PointColor = new Color(0.33f, 0.67f, 1f, 1f);
[SerializeField] private Color m_PointCenterColor = Color.white;
[SerializeField] private Color m_PointBorderColor = new Color(0.2f, 0.2f, 0.2f, 1f);
[SerializeField] private float m_PointBorderThickness = 1f;
[SerializeField] private int m_PointSideCount = 8;
[SerializeField] private float m_PointChamfer = 0f;
[SerializeField] private float m_PointAngle = 0f;
[Header("颜色映射")]
[SerializeField] private bool m_EnableColorMapping = false;
[SerializeField] private Color m_ColorMapMin = Color.blue;
[SerializeField] private Color m_ColorMapMax = Color.red;
[SerializeField] private int m_ColorMapAxis = 2;
[Header("数据")]
[SerializeField] private bool m_AutoUpdate = true;
// ── 工具引用 ──────────────────────────────────────────────
private ChartToolCubeBg m_CubeBg;
private ChartToolScatterPoints m_ScatterPoints;
// ── 数据模型 ──────────────────────────────────────────────
private XChartDataModel3D m_DataModel = new XChartDataModel3D();
/// <summary>数据模型(只读)</summary>
public XChartDataModel3D DataModel => m_DataModel;
// ── 初始化 ────────────────────────────────────────────────
protected override void OnEnable()
{
base.OnEnable();
EnsureToolsCreated();
}
private void Start()
{
EnsureToolsCreated();
SyncAllParams();
RefreshChart();
}
private void EnsureToolsCreated()
{
if (m_CubeBg != null && 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;
}
}
// ── 参数同步 ──────────────────────────────────────────────
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.PointSize = m_PointSize;
m_ScatterPoints.PointColor = m_PointColor;
m_ScatterPoints.CenterColor = m_PointCenterColor;
m_ScatterPoints.BorderColor = m_PointBorderColor;
m_ScatterPoints.BorderThickness = m_PointBorderThickness;
m_ScatterPoints.SideCount = m_PointSideCount;
m_ScatterPoints.ChamferSize = m_PointChamfer;
m_ScatterPoints.PointAngle = m_PointAngle;
m_ScatterPoints.EnableColorMapping = m_EnableColorMapping;
m_ScatterPoints.ColorMapMin = m_ColorMapMin;
m_ScatterPoints.ColorMapMax = m_ColorMapMax;
m_ScatterPoints.ColorMapAxis = m_ColorMapAxis;
}
// ── 每帧更新 ──────────────────────────────────────────────
protected override void Update()
{
base.Update();
if (m_AutoUpdate && m_DataModel.IsDirty(XChartDataModel3D.DirtyFlags.DataChanged))
{
RefreshChart();
m_DataModel.ClearDirty(XChartDataModel3D.DirtyFlags.DataChanged);
}
}
// ── 公共 API ──────────────────────────────────────────────
#region 公共 API
/// <summary>刷新图表(重新投影所有数据点)</summary>
public void RefreshChart()
{
EnsureToolsCreated();
// 标记立方体投影需要重新计算
if (m_CubeBg != null)
m_CubeBg.MarkProjectionDirty();
// 获取归一化数据点并传递给散点工具
if (m_ScatterPoints != null && m_DataModel.HasData)
{
var normalized = m_DataModel.GetNormalizedPoints();
m_ScatterPoints.SetNormalizedPoints(normalized);
m_ScatterPoints.MarkDataDirty();
}
else if (m_ScatterPoints != null)
{
m_ScatterPoints.SetNormalizedPoints(null);
}
}
/// <summary>设置散点数据</summary>
/// <param name="xs">X 坐标数组</param>
/// <param name="ys">Y 坐标数组</param>
/// <param name="zs">Z 坐标数组</param>
public void SetData(double[] xs, double[] ys, double[] zs)
{
m_DataModel.SetPoints(xs, ys, zs);
RefreshChart();
}
/// <summary>设置散点数据(Vector3 数组)</summary>
public void SetData(Vector3[] points)
{
var xs = new double[points.Length];
var ys = new double[points.Length];
var zs = new double[points.Length];
for (int i = 0; i < points.Length; i++)
{
xs[i] = points[i].x;
ys[i] = points[i].y;
zs[i] = points[i].z;
}
SetData(xs, ys, zs);
}
/// <summary>添加一个数据点</summary>
public void AddDataPoint(double x, double y, double z)
{
m_DataModel.AddPoint(x, y, z);
RefreshChart();
}
/// <summary>清空所有数据</summary>
public void ClearData()
{
m_DataModel.ClearAll();
RefreshChart();
}
#endregion
// ── 外观属性(运行时属性) ─────────────────────────────────
#region 运行时属性
public float CubeHalfSize
{
get => m_CubeHalfSize;
set { m_CubeHalfSize = value; SyncCubeParams(); }
}
public float Pitch
{
get => m_Pitch;
set { m_Pitch = value; SyncCubeParams(); }
}
public float Yaw
{
get => m_Yaw;
set { m_Yaw = value; SyncCubeParams(); }
}
public Color FrontEdgeColor
{
get => m_FrontEdgeColor;
set { m_FrontEdgeColor = value; SyncCubeParams(); }
}
public Color BackEdgeColor
{
get => m_BackEdgeColor;
set { m_BackEdgeColor = value; SyncCubeParams(); }
}
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(); }
}
public bool ShowBackEdges
{
get => m_ShowBackEdges;
set { m_ShowBackEdges = value; SyncCubeParams(); }
}
public bool ShowGridLines
{
get => m_ShowGridLines;
set { m_ShowGridLines = value; SyncCubeParams(); }
}
public float PointSize
{
get => m_PointSize;
set { m_PointSize = Mathf.Max(0.5f, value); SyncPointParams(); }
}
public PrimitiveType PointType
{
get => m_PointType;
set { m_PointType = value; SyncPointParams(); }
}
public Color PointColor
{
get => m_PointColor;
set { m_PointColor = value; SyncPointParams(); }
}
public int PointSideCount
{
get => m_PointSideCount;
set { m_PointSideCount = Mathf.Max(3, value); SyncPointParams(); }
}
public float PointChamfer
{
get => m_PointChamfer;
set { m_PointChamfer = Mathf.Clamp01(value); SyncPointParams(); }
}
public bool EnableColorMapping
{
get => m_EnableColorMapping;
set { m_EnableColorMapping = value; SyncPointParams(); }
}
public Color ColorMapMin
{
get => m_ColorMapMin;
set { m_ColorMapMin = value; SyncPointParams(); }
}
public Color ColorMapMax
{
get => m_ColorMapMax;
set { m_ColorMapMax = value; SyncPointParams(); }
}
public int ColorMapAxis
{
get => m_ColorMapAxis;
set { m_ColorMapAxis = Mathf.Clamp(value, 0, 2); SyncPointParams(); }
}
#endregion
// ── 编辑器 ────────────────────────────────────────────────
#if UNITY_EDITOR
private 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)
{
UnityEditor.EditorApplication.delayCall += () =>
{
if (this != null && isActiveAndEnabled)
{
SyncAllParams();
RefreshChart();
}
};
}
}
#endif
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 5857501cfde29c94ab1a0aa2896b652b
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
@@ -0,0 +1,155 @@
using UnityEngine;
using XericLibrary.Runtime.UIGraph;
namespace XericUI.XChart.Pseudo3D
{
/// <summary>
/// 散点图元渲染器。
///
/// 继承 PrimitiveCacheRendererBase,支持在一个 MaskableGraphic 中批量渲染多个图元。
/// 所有散点共享同一套形状参数,但位置和颜色可独立设置。
///
/// 相比为每个点创建独立的 UIPrimitiveRenderer,本组件大幅减少 GameObject 数量和 Draw Call。
/// </summary>
[AddComponentMenu("Xeric/XChart/Pseudo3D/Scatter Point Renderer")]
public class XScatterPointRenderer : PrimitiveCacheRendererBase
{
// ── 全局形状参数 ──────────────────────────────────────────
/// <summary>图元类型(多边形 / 矩形)</summary>
public PrimitiveType pointType = PrimitiveType.Polygon;
/// <summary>尺寸模式</summary>
public SizeMode sizeMode = SizeMode.InscribedCircle;
/// <summary>点大小(像素)</summary>
public float pointSize = 8f;
/// <summary>填充颜色</summary>
public Color fillColor = Color.white;
/// <summary>中心颜色(渐变中心)</summary>
public Color centerColor = Color.white;
/// <summary>边框颜色</summary>
public Color borderColor = Color.black;
/// <summary>边框宽度</summary>
public float borderThickness = 1f;
/// <summary>多边形边数(仅 polygon 类型有效)</summary>
[Range(3, 64)]
public int sideCount = 8;
/// <summary>倒角大小</summary>
[Range(0f, 1f)]
public float chamferSize = 0f;
/// <summary>倒角分段数</summary>
[Range(1, 16)]
public int chamferSegments = 4;
/// <summary>旋转角度</summary>
[Range(-180f, 180f)]
public float angle = 0f;
// ── 公共 API ──────────────────────────────────────────────
/// <summary>
/// 批量设置散点位置。
/// 清除所有现有图元,用新位置重建。
/// </summary>
/// <param name="positions">2D 位置数组</param>
/// <param name="colors">可选:每个点的颜色(null 则使用 fillColor)</param>
public void SetPoints(Vector2[] positions, Color[] colors = null)
{
ClearAll();
for (int i = 0; i < positions.Length; i++)
{
Color c = (colors != null && i < colors.Length) ? colors[i] : fillColor;
var entry = new PrimitiveCacheEntry
{
type = pointType,
sizeMode = sizeMode,
center = positions[i],
size = new Vector2(pointSize, pointSize),
angle = angle,
@params = new PrimitiveParams
{
axisScaleX = 1f,
axisScaleY = 1f,
sideCount = sideCount,
chamferSize = chamferSize,
chamferSegments = chamferSegments,
bgColor = c,
centerColor = centerColor,
borderColor = borderColor,
borderThickness = borderThickness,
},
};
AddPrimitive(entry);
}
}
/// <summary>
/// 更新单个点的位置(不重建所有点,仅标记脏)。
/// </summary>
public void UpdatePointPosition(int index, Vector2 position)
{
if (index < 0 || index >= m_Primitives.Count) return;
var entry = m_Primitives[index];
entry.center = position;
m_Primitives[index] = entry;
SetPrimitiveDirty(index);
}
/// <summary>
/// 更新单个点的颜色
/// </summary>
public void UpdatePointColor(int index, Color color)
{
if (index < 0 || index >= m_Primitives.Count) return;
var entry = m_Primitives[index];
entry.@params.bgColor = color;
m_Primitives[index] = entry;
SetPrimitiveDirty(index);
}
/// <summary>更新全局形状参数并重建所有点</summary>
public void UpdateShapeParams()
{
for (int i = 0; i < m_Primitives.Count; i++)
{
var entry = m_Primitives[i];
entry.type = pointType;
entry.sizeMode = sizeMode;
entry.size = new Vector2(pointSize, pointSize);
entry.angle = angle;
entry.@params.sideCount = sideCount;
entry.@params.chamferSize = chamferSize;
entry.@params.chamferSegments = chamferSegments;
entry.@params.borderThickness = borderThickness;
entry.@params.borderColor = borderColor;
entry.@params.centerColor = centerColor;
m_Primitives[i] = entry;
}
RebuildAll();
}
// ── 编辑器 ────────────────────────────────────────────────
#if UNITY_EDITOR
protected override void OnValidate()
{
base.OnValidate();
if (sideCount < 3) sideCount = 3;
if (pointSize < 0.5f) pointSize = 0.5f;
}
#endif
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 91affc3968f75e44fab8e970b6f725f5
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant: