unity-ugui-xcharts

3.9.0 • Public • Published

XCharts

A powerful, easy-to-use, configurable charting and data visualization library for Unity.
Unity数据可视化图表插件。
English README

XCharts

一款基于UGUI的功能强大、简单易用的数据可视化图表插件。支持折线图柱状图饼图雷达图散点图热力图环形图K线图极坐标平行坐标等十多种内置图表,以及3D饼图3D柱图3D金字塔漏斗图仪表盘水位图象形柱图甘特图矩形树图等扩展图表。

XCharts 官方主页
XCharts 在线示例

XCharts 教程:5分钟上手 XCharts
XCharts API文档
XCharts 问答
XCharts 配置项手册
XCharts 更新日志
XCharts 订阅服务

特性

  • 纯代码绘制:图表完全纯代码绘制,无需额外的贴图和Shader资源。
  • 可视化配置:参数可视化配置,效果实时预览,也支持运行时代码动态修改配置和数据。
  • 高自由定制:支持从主题和配置参数上任意调整;支持代码自定义绘制,自定义回调以及自定义实现图表。
  • 多内置图表:支持线图、柱状图、饼图、雷达图、散点图、热力图、环形图、K线图、极坐标、平行坐标等多种内置图表。
  • 多扩展图表:支持3D柱图、3D饼图、漏斗图、金字塔、仪表盘、水位图、象形柱图、甘特图、矩形树图等多种扩展图表。
  • 多扩展组件:支持表格、统计数值等扩展UI组件。
  • 多图表组合:支持内置图表的任意组合,同一图中可同时显示多个相同或不同类型的图表。
  • 多种坐标系:支持直角坐标系、极坐标系、单轴等多种坐标系。
  • 丰富的组件:支持标题、图例、提示框、标线、标域、数据区域缩放、视觉映射等常用组件。
  • 多样式线图:支持直线图、曲线图、虚线图、面积图、阶梯线图等多种线图。
  • 多样式柱图:支持并列柱图、堆叠柱图、堆积百分比柱图、斑马柱图、胶囊柱图等多种柱状图。
  • 多样式饼图:支持环形图、玫瑰图、环形玫瑰图等多种饼图。
  • 丰富的线条:支持实线、曲线、阶梯线、虚线、点线、点划线、双点划线等线条。
  • 自定义绘制:支持自定义图表内容绘制,提供绘制点、线、面等其他图形的强大的绘图API。
  • 大数据绘制:支持万级大数据量绘制;支持采样绘制;特殊的简化图表支持更优的性能。
  • 自定义主题:支持主题定制、导入和导出,内置明暗两种默认主题。
  • 动画和交互:支持渐入动画、渐出动画、变更动画、新增动画、交互动画等多种动画;支持多平台的数据筛选、视图缩放、细节展示等交互操作。
  • 第三方扩展:支持无缝接入TexMeshProNew Input System
  • 版本和兼容:支持所有5.6以上的Unity版本;支持全平台运行。

截图

内置图表

扩展图表

注意

  • XCharts3.0 不完全兼容 XCharts2.0 版本,升级3.0时,部分代码和配置可能需要重新调整。建议旧项目可以继续使用XCharts2.0,新项目推荐使用XCharts3.0
  • XCharts2.0 进入维护阶段,后续只修复严重bug,原则上不再加新功能。
  • XCharts 理论上支持Unity 5.6及以上版本,但由于版本测试有限难免疏漏,发现版本兼容问题可提Issue
  • 本仓库只包含XCharts源码,不包含Demo示例部分。需要查看Demo示例源码请到XCharts-Demo仓库。也可以在浏览器查看WebGL下的运行效果 在线Demo

仓库

使用

  • 导入XChartsunitypackage或者源码到项目。建议也导入XCharts守护程序XCharts-Daemon
  • Hierarchy视图下右键选择XCharts->LineChart,即可创建一个默认的折线图。
  • Inspector视图下的Add SerieAdd Main Component按钮可以添加Serie组件
  • Inspector视图可以调整各个组件的参数,Game视图可看到实时效果。
  • 更多细节,请看【XCharts教程:5分钟上手教程】
  • 首次使用,建议先认真看一遍教程。

分支

  • master:开发分支。最新的修改和新功能都先提交到master分支,一段时间后再从master分支merge3.0分支,并发布release版本。
  • 3.0:XCharts 3.0的稳定分支。一般一个月一更新,从master分支merge最新改动过来,并发布release版本。
  • 2.0:XCharts 2.0的稳定分支。带Demo,目前基本不再维护,仅修改严重bug。
  • 2.0-upm:XCharts 2.0的稳定UMP分支。不带Demo,只包含Package部分,专门给UMP用,不再维护。
  • 1.0:XCharts 1.0的稳定分支。带Demo,不再维护。
  • 1.0-upm:XCharts 1.0的稳定UMP分支。不带Demo,不再维护。

FAQ

  • XCharts可以免费使用吗?
    答:XCharts使用MIT协议,可以免费使用。也可以订阅VIP享受更多增值服务。

  • XCharts支持代码动态添加和修改数据吗?支持从Excel或数据库中获取数据吗?
    答:XCharts提供了各种数据操作的接口,支持代码动态修改配置,添加和修改数据,但数据来源需要自己解析和获取,再调用XCharts的接口添加到图表。

  • XCharts除了用在Unity平台,还能用在WinformWPF等平台吗?
    答:XCharts只支持在Unity平台使用。理论上任何支持UGUIUnity版本都能运行XCharts

  • 锯齿怎么解决?支持多大量级的数据?
    答:XCharts是基于UGUI实现的,所以UGUI中碰到的问题,在XCharts中也会存在。比如锯齿问题,比如Mesh顶点数超65535的问题。这两个问题的解决可参考问答16问答27
    由于Mesh65535顶点数的限制,目前XCharts的单条Line支持约2万的数据量,当然开启采样可以支持更多数据的绘制,但同时也会更消耗CPU。

Licenses

  • MIT License
  • 可免费商用,可二次开发
  • 扩展图表和高级功能部分需单独购买授权

日志

订阅

  • XCharts核心库是开源的,可免费使用的。在此基础上,我们也提供多种订阅服务以满足不同用户的需求,订阅详情☞ 请看这里
  • 订阅不是必须的,不影响XCharts的核心功能使用。
  • 订阅是按年付费,订阅到期后,不要求必须续订,但中断订阅期间无法享受技术支持等服务。如需继续服务,可从当日起续订即可。

其他

  • 邮箱:monitor1394@gmail.com
  • QQ群:XCharts交流群(202030963
  • VIP群:XCharts VIP群(867291970
  • 捐助、合作、订阅和技术支持:☞ 看这里

Package Sidebar

Install

npm i unity-ugui-xcharts

Weekly Downloads

30

Version

3.9.0

License

MIT

Unpacked Size

5.45 MB

Total Files

850

Last publish

Collaborators

  • monitor1394