3.0 - unitypackage

2026-05-24 18:00:26 +00:00 · 2022-01-05 21:40:48 +08:00
parent c160867765
commit 228a4b2840
846 changed files with 105 additions and 467693 deletions
--- a/README.md
+++ b/README.md
@@ -9,7 +9,6 @@
  <br>
  一款基于UGUI的数据可视化图表插件。
  <br>
-  <a href="Assets/XCharts/README.md">English Doc</a>
 </p>
 <p align="center">
  <a href="https://github.com/monitor1394/unity-ugui-XCharts/blob/master/LICENSE">
@@ -18,12 +17,12 @@
  <a href="https://github.com/monitor1394/unity-ugui-XCharts/releases">
    <img src="https://img.shields.io/github/v/release/monitor1394/unity-ugui-XCharts?include_prereleases">
  </a>
-  <a href="">
-    <img src="https://img.shields.io/github/repo-size/monitor1394/unity-ugui-xcharts">
-  </a>
  <a href="">
    <img src="https://img.shields.io/github/languages/code-size/monitor1394/unity-ugui-xcharts">
  </a>
+  <a href="https://www.npmjs.org/package/unity-ugui-xcharts">
+    <img src="https://img.shields.io/npm/dm/unity-ugui-xcharts?label=npm%20downloads%20">
+  </a>
  <a href="">
    <img src="https://img.shields.io/badge/Unity-5.6+-green">
  </a>
@@ -43,96 +42,88 @@
  </a>
 </p>

-一款基于`UGUI`的功能强大、易用、参数可配置的数据可视化图表插件。支持折线图、柱状图、饼图、雷达图、散点图、热力图、仪表盘、环形图、极坐标、水位图、K线图等常见图表。
+A powerful, easy-to-use, configurable charting and data visualization library for Unity.  Supporting line, bar, pie, radar, scatter, heatmap, gauge, ring, polar, liquid and other common chart.

-[XCharts问答](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts问答.md)  
-[XChartsAPI手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XChartsAPI.md)  
-[XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md)  
-[XCharts更新日志](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md)  
-[教程：5分钟上手XCharts](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/教程：5分钟上手XCharts.md)  
+[XCharts Homepage](https://github.com/monitor1394/unity-ugui-XCharts)  
+[XCharts Q&A](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-questions-and-answers-EN.md)  
+[XCharts API](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-api-EN.md)  
+[XCharts Configuration](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-configuration-EN.md)  
+[XCharts Changelog](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG-EN.md)  
+[Tutorial - Get start with XCharts in 5 minute](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/tutorial--get-start-with-xcharts-in-5-minute-EN.md)

 ## XCharts 2.0

-* 底层重构，分层绘制，优化可扩展性，支持更多数据。
-* 支持多组件模式。
-* 支持大部分图表的任意组合。
-* 支持主题定制、导入和导出，更多的主题配置参数。
-* 支持全局配置参数调整。
-* 支持自定义图表的快速定制。
-* 新增 `TextMeshPro` 的支持。
-* 新增 `CandlestickChart` K线图。
-* __注意：__ `2.0` 版本进行了大量的重构和调整，并不完全兼容 `1.0` 版本，升级后部分参数设置可能被重置为默认值，请谨慎升级。
+* Underlevel reconstruction, layered rendering, optimized scalability, support more data.
+* Support for multi-component patterns.
+* Support for any combination of most charts.
+* Support theme customization, import and export, and more theme configuration parameters.
+* Support global adjustment of configuration parameters.
+* Added support for `TextMeshPro`.
+* Added `CandlestickChart`.
+* __ Note:__ `2.0` has undergone a lot of refactoring and adjustments and is not fully compatible with version `1.0`, so `1.0` should not be directly upgraded to `2.0`. Some parameter Settings may be reset to default values after upgrading.

-## 特性
+## Features

-* 内置丰富示例和模板，参数可视化配置，效果实时预览，纯代码绘制。
-* 支持折线图、柱状图、饼图、雷达图、散点图、热力图、热力图、仪表盘、环形图、极坐标、水位图等十种常见图表。
-* 支持直线图、曲线图、面积图、阶梯线图等折线图。
-* 支持并列柱图、堆叠柱图、堆积百分比柱图、斑马柱图等柱状图。
-* 支持环形图、玫瑰图等饼图。
-* 支持大部分图表的任意组合，同一图表中可同时显示多个相同或不同类型的图表。
-* 支持实线、曲线、阶梯线、虚线、点线、点划线、双点划线等线条。
-* 支持主题定制、导入和导出，内置三种默认主题。
-* 支持自定义图表内容绘制，提供绘制点、直线、曲线、三角形、四边形、圆形、环形、扇形、边框、箭头等绘图API。
-* 支持PC端和手机端上的数据筛选、视图缩放、细节展示等交互操作。
-* 支持万级大数据绘制。
-* 支持`TexMeshPro`。
+* Rich built-in examples and templates, parameter visualization configuration, effect real-time preview, pure code drawing.
+* Support line, bar, pie, radar, scatter, heatmaps, gauge, ring, polar, liquid and other common chart.
+* Support line graph, curve graph, area graph, step graph and other LineChart.
+* Support parallel bar, stack bar, stack percentage bar, zebra bar and other BarChart.
+* Support ring, rose and other PieChart.
+* Support line-bar chart, scatter-line chart and other combination chart.
+* Support solid line, curve, ladder line, dotted line, dash line, dot line, double dot line and other lines.
+* Support custom theme, built-in theme switching.
+* Support custom chart content drawing, drawing points, line, curve, triangle, quadrilateral, circle, ring, sector, border, arrow and other drawing API.
+* Support interactive operations such as data filtering, view zooming and detail display on PC and mobile terminals.
+* Support 10,000-level big data rendering.

-## 截图
+## Screenshot

-![linechart](Doc/screenshot/xcharts-line.png)
-![barchart](Doc/screenshot/xcharts-bar.png)
-![piechart](Doc/screenshot/xcharts-pie.png)
-![radarchart](Doc/screenshot/xcharts-radar.png)
-![scatterchart](Doc/screenshot/xcharts-scatter.png)
-![heatmapchart](Doc/screenshot/xcharts-heatmap.png)
-![gaugechart](Doc/screenshot/xcharts-gauge.png)
-![ringchart](Doc/screenshot/xcharts-ring.png)
-![polarchart](Doc/screenshot/xcharts-polar.png)
-![liquidchart](Doc/screenshot/xcharts-liquid.png)
-![combinations](Doc/screenshot/xcharts-combinations.png)
+![linechart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-line.png)
+![barchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-bar.png)
+![piechart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-pie.png)
+![radarchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-radar.png)
+![scatterchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-scatter.png)
+![heatmapchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-heatmap.png)
+![gaugechart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-gauge.png)
+![ringchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-ring.png)
+![polarchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-polar.png)
+![liquidchart](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-liquid.png)
+![combinations](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-combinations.png)

-## 术语
+## Cheat Sheet

-![cheatsheet](Doc/screenshot/xcharts-cheatsheet.gif)
+![cheatsheet](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/screenshot/xcharts-cheatsheet.gif)

-XCharts的图表由组件和数据组成。不同的组件和数据可以组合成不同类型的图表。组件分为主组件和子组件，主组件包含子组件。  
+`XCharts` consist of components and data. Different components and data can be combined into different types of charts. The component is divided into main component and sub component. The main component contains the sub components.

-## 组件
+`XCharts` main components:

-| | |
-| ---| --|
-| Theme | 主题组件 |
-| Title | 标题组件 |
-| Legend | 图例组件 |
-| Grid | 网格组件 |
-| Axis | 坐标轴组件 |
-| Series | 系列组件 |
-| Tooltip | 提示框组件 |
-| DataZoom | 区域缩放组件 |
-| VisualMap | 视觉映射组件 |
-| Radar | 雷达组件 |
-| Settings | 全局设置组件 |
+* `Theme` theme component, which can configure the default colors, fonts and so on.
+* `Title` title component, which contains the main title and subtitle.
+* `Legend` legend component, which represent different sets of symbols, colors, and names. You can control which series are not displayed by clicking on the legend.
+* `Grid` grid component, drawing grid in rectangular coordinate system. Up to two X axes and two Y axes can be placed within a grid component. You can draw line, bar and scatter chart on the grid.
+* `Axis` axis component, the axis of a rectangular coordinate system. Supports the upper and lower X axes and the left and right Y axes.
+* `Series` series component, a list of serie. A chart can contain many different series, and each series determines its own chart type by type.
+* `Tooltip` tooltip component, feedback more details of the data indicated by the mouse at the time.
+* `DataZoom` data zoom component, used for area zooming so you can focus on detailed data information, or overview the data as a whole, or remove the impact of outliers.
+* `VisualMap` visual mapping component, you can map data in different colors.
+* `Radar` radar component, suitable for radar chart only.
+* `Settings` global Settings component, Some global parameters can be adjusted. Use the default values in general and adjust them as needed.

-## 图表
+`XCharts` support chart:

-| | |
-| ---| --|
-| LineChart | 这线图 |
-| BarChart | 柱状图 |
-| PieChart | 饼图 |
-| RadarChart | 雷达图 |
-| ScatterChart | 散点图 |
-| HeatmapChart | 热力图 |
-| GuageChart | 仪表盘 |
-| RingChart | 环形图 |
-| LiquidChart | 水位图 |
-| PolarChart | 极坐标图 |
-| CandlestickChart | K线图 |
+* `LineChart`
+* `BarChart`
+* `PieChart`
+* `RadarChart`
+* `ScatterChart`
+* `HeatmapChart`
+* `GuageChart`
+* `RingChart`
+* `PolarChart`
+* `LiquidChart`

-## 关系
-
-以下是LineChart折线图和主组件、子组件的关系结构：
+The following is the relationship structure of LineChart:

 ``` js
 .
@@ -165,46 +156,55 @@ XCharts的图表由组件和数据组成。不同的组件和数据可以组合
    └── Settings
 ```

-## 使用
+## Environment

-* 本项目在`Unity 2017.4.27f1`和`.Net 3.5`下开发，在 `Unity 5`、`Unity 2018`、`Unity 2019`上测试正常。理论上可运行于任何支持`UGUI`的`Unity`版本。
-* 通过下载源码或`unitypackage`包导入到你的项目中。
-* 如果你是`2018.3`及以上版本，可通过`Package Manager`的`Git`来导入包（`2.0-upm`分支对应的`Release`版本，更新速度较慢，但相对更稳定）：
-  1. 打开`Packages`目录下的`manifest.json`文件，在`dependencies`下加入以下内容（或者通过`Package Manager`的`Add package from git URL...`）：  
+* Unity2017.4.27f1
+* .Net 3.5
+* macOS 10.15.4
+
+## Usage
+
+* This project was developed under `Unity 2017.4.27f1` and `.net 3.5`, tested normally on `Unity 5`, `Unity 2018` and `Unity 2019`. It can theoretically run on any version that supports `UGUI`.
+* Download the source code or `unitypackage` to import into your project. If `Unity` version are `2018.3` or above, it is recommended to import packages through `Package Manager`:
+  1. Open the `manifest.json` file under `Packages` directory and add under `dependencies`:
  ``` json
-  "com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#2.0-upm",
+     "com.monitor1394.xcharts": "https://github.com/monitor1394/unity-ugui-XCharts.git#2.0-upm",
  ```
-  2. 回到`Unity`，可能会花3到5分钟进行下载和编译，成功后就可以开始使用`XCharts`了。
-  3. 如果要删除`XCharts`，删除掉1步骤所加的内容即可。
-  4. 如果要更新`XCharts`，删除`manifest.json`文件的`lock`下的`com.monitor1394.xcharts`相关内容即会从新下载编译。在 `Component -> XCharts -> Upgrade Check`可以检测是否有新版本可更新。
-  5. __注意：__ 通过这种方式导入要求本地先装有`Git`。
+  2. Going back to `Unity`, it may take 3 to 5 minutes to download.
+  3. If you want to delete `XCharts`, just delete the content added in step 1.
+  4. If you want to update `XCharts`, open `manifest.json` file , delete the content about `com.monitor1394.xcharts` under `lock`, it will download anagain. Also can check For update in `components-> XCharts -> Check For Update`.

-* 在Editor上快速创建一个图表：
+* Add a chart in Editor quickly:
+  1. In `Hierarchy`, right-click menu `XChart->LineChart`.
+  2. In unity menu bar, `Component->XCharts->LineChart`.
+  3. In `Inspector`,`Add Component->LineChart`.
+  4. Then a simple line chart is done.
+  5. In `Inspector` you can adjust the parameters of components, and in `Game` will feedback the adjustment effect in realtime 。the detail of parameters  go to see: [XCharts Configuration](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-configuration-EN.md).

-  1. 在`Hierarchy`试图下右键或菜单栏`GameObject`下拉：`XCharts->LineChart`，即可快速创建一个简单的折线图出来。
-  2. `Inspector` 视图下可以调整各个组件的参数，`Game` 视图会实时反馈调整的效果。各个组件的详细参数说明可查阅[XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md)。
+* See more examples of code dynamic control: [Tutorial - Get start with XCharts in 5 minute](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/tutorial--get-start-with-xcharts-in-5-minute-EN.md).

-* 更多的代码动态控制的例子请参考[教程：5分钟上手XCharts](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/教程：5分钟上手XCharts.md)  。
+* Enable TextMeshPro:
+  1. `XCharts -> TextMeshPro Enable` or `Project Setting -> XCharts -> Enable TextMeshPro`
+  2. `Project Setting -> XCharts -> Settings -> TMP Font` set the TextMeshPro font.
+  3. If the chart does not initialize properly, you can use the `Remove All Chart Object` button to clean up the chart and reinitialize it.

-## 文档
+## Documents

-* 常见问题看这里☞ [XCharts问答](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts问答.md)  
-* 接口文档看这里☞ [XChartsAPI手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XChartsAPI.md)  
-* 参数配置看这里☞ [XCharts配置项手册](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/XCharts配置项手册.md)  
-* 更新日志看这里☞ [XCharts更新日志](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md)  
-* 新手教程看这里☞ [教程：5分钟上手XCharts](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/教程：5分钟上手XCharts.md)  
+* [XCharts Homepage](https://github.com/monitor1394/unity-ugui-XCharts)  
+* [XCharts Q&A](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-questions-and-answers-EN.md)  
+* [XCharts API](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-api-EN.md)  
+* [XCharts Configuration](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/Documentation/xcharts-configuration-EN.md)
+* [XCharts Changelog](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG-EN.md)  
+* [XCharts Tutorial: Get start with XCharts in 5 minute](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Doc/tutorial--get-start-with-xcharts-in-5-minute-EN.md)

-## 日志
+## Changelog

-[更新日志](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md)  
+[XCharts Changelog](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/CHANGELOG.md)  

 ## Licenses

 [MIT License](https://github.com/monitor1394/unity-ugui-XCharts/blob/master/Assets/XCharts/LICENSE.md)

-## 其他
+## Contact

-邮箱：monitor1394@gmail.com  
-QQ群：XCharts交流群（`202030963`）  
-VIP群：XCharts技术支持VIP群（`867291970`）  
-捐助和技术支持：[☞ 看这里](SUPPORT.md)
+gmail: monitor1394@gmail.com