资源
快速开始
配置
从 XCharts-Team/XCharts: A charting and data visualization library for Unity. Unity 数据可视化图表插件。(github.com) 把工程加载到 Assets/
下的一个地方。
之后就可以在 Hierarchy
右键创建一个 XCharts
,我们创建一个 LineChart
。
可以在这个 LineChart
组件的基础上再绑上其它控制脚本。绑定 Examples/Example01_RandomData.cs
。
自定义
自定义脚本创建 LineChart
:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
| using System.Collections; using System.Collections.Generic; using UnityEngine; using XCharts.Runtime;
public class ChartController : MonoBehaviour { void Start() { var chart = gameObject.GetComponent<LineChart>(); if (chart == null) { chart = gameObject.AddComponent<LineChart>(); chart.Init(); } chart.SetSize(580, 300); var title = chart.EnsureChartComponent<Title>(); title.text = "Simple Line"; var tooltip = chart.EnsureChartComponent<Tooltip>(); tooltip.show = true;
var legend = chart.EnsureChartComponent<Legend>(); legend.show = false; var xAxis = chart.EnsureChartComponent<XAxis>(); xAxis.splitNumber = 10; xAxis.boundaryGap = true; xAxis.type = Axis.AxisType.Category;
var yAxis = chart.EnsureChartComponent<YAxis>(); yAxis.type = Axis.AxisType.Value; chart.RemoveData(); chart.AddSerie<Line>("line"); for (int i = 0; i < 10; i++) { chart.AddXAxisData(i + ""); chart.AddData(0, Random.Range(10, 20)); } }
void Update() { } }
|
写一个按下按钮追加数据的逻辑:
1 2 3 4 5
| public void onClick() { chart.AddXAxisData(chart.series[0].GetDataList().Count + ""); chart.AddData(0, Random.Range(10, 20)); }
|
你还可以用代码控制更多的参数,Examples
下还有更多的其他例子,凡是 Inspector
上看到的可配置的参数,都可以通过代码来设置。XCharts 配置项手册 里面的所有参数都是可以通过代码控制的。
另外,除非定制,建议调用 Chart
下提供的 public
接口,特别是数据相关操作部分。这些接口内部会做一些关联处理,比如刷新图表等。常见的接口有:
chart.ClearData()
:清空图表数据(不移除 Series)
chart.RemoveData()
:清除图表数据(会移除所有 Series)
chart.AddSerie()
:添加 Serie
chart.AddXAxisData()
:添加 X 轴数据
chart.AddData()
:添加 Serie 数据
chart.UpdateData()
:更新 Serie 数据
chart.UpdateXAxisData()
:更新 X 轴数据
chart.UpdateDataName()
:更新 Serie 数据的名字