添加图表功能。
This commit is contained in:
@@ -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:
|
||||
Reference in New Issue
Block a user