3.11.0

XCharts-Team · Jun 16, 2024 · 24270e5 · 24270e5
1 parent e3fb568
commit 24270e5
Show file tree

Hide file tree

Showing 10 changed files with 157 additions and 119 deletions.
diff --git a/Documentation~/en/api.md b/Documentation~/en/api.md
@@ -1480,6 +1480,7 @@ The edge of graph.
 |public method|since|description|
 |--|--|--|
 |GraphEdge()||public GraphEdge(GraphNode node1, GraphNode node2, double value)|
+|IsPointInEdge()||public bool IsPointInEdge(Vector2 point)|
 
 ## GraphNode
 

diff --git a/Documentation~/en/changelog.md b/Documentation~/en/changelog.md
@@ -2,6 +2,7 @@
 # 更新日志
 
 [master](#master)  
+[v3.11.0](#v3110)  
 [v3.10.2](#v3102)  
 [v3.10.1](#v3101)  
 [v3.10.0](#v3100)  
@@ -68,6 +69,41 @@
 
 ## master
 
+## v3.11.0
+
+Release Highlights:
+
+* Added `Line3DChart` for 3D line charts
+* Added `GraphChart` for relationship graphs
+* Added support for 3D coordinate systems
+* Added `triggerOn` setting for `Tooltip` to define trigger conditions
+* Various bug fixes and optimizations
+
+Changelog Details:
+
+* (2024.06.16) Released version `v3.11.0`
+* (2024.06.15) Added buttons for adding, deleting, and moving data up and down under `Editor`
+* (2024.06.11) Fixed issue where `Axis`'s `IndicatorLabel` might overlap with `Tooltip`
+* (2024.06.11) Fixed issue where `Tooltip`'s `Axis` `IndicatorLabel` might not display when in `Cross` mode (#315)
+* (2024.06.10) Renamed `Tooltip`'s `Corss` to `Cross`
+* (2024.06.09) Added `minCategorySpacing` setting for `Axis` to define the default minimum category spacing
+* (2024.06.09) Fixed inaccurate indicator position of `Tooltip`'s `Cross` when `Axis` is a category axis and `DataZoom` is enabled
+* (2024.06.06) Fixed animation issue when `Serie` is cloned (#320)
+* (2024.06.04) Fixed issue where `Serie`'s `state` does not refresh when set dynamically via code
+* (2024.05.29) Adjusted the right-click menu of `XCharts` in the `Hierarchy` view to `UI/XCharts`
+* (2024.05.29) Added support for 3D coordinate systems to category axes
+* (2024.05.19) Optimized editing performance in `Editor`
+* (2024.05.09) Added utility class `JsonUtil`
+* (2024.04.23) Fixed chart exception issue after multiple calls to `ConvertXYAxis()`
+* (2024.04.22) Fixed potential incorrect retrieval of `GridCoord` when `DataZoom` controls multiple axes (#317)
+* (2024.04.22) Added 3D coordinate system
+* (2024.04.15) Optimized `DateTimeUtil` for timezone issues when converting timestamps to `DateTime`
+* (2024.04.15) Optimized `GridCoord` to display `Left` `Right` `Top` `Bottom` parameters even when `GridLayout` is enabled (#316)
+* (2024.04.14) Fixed incorrect label position of `Tooltip`'s `Cross` when `DataZoom` is enabled (#315)
+* (2024.04.12) Fixed incorrect effect of `Candlesticks` (#313)
+* (2024.03.20) Added `triggerOn` setting for `Tooltip` to define trigger conditions
+* (2024.03.19) Fixed color issue when setting `opacity` in `Pie`'s `ItemStyle` (#309)
+
 ## v3.10.2
 
 * (2024.03.11) Release `v3.10.2`

diff --git a/Documentation~/zh/api.md b/Documentation~/zh/api.md
@@ -1480,6 +1480,7 @@ DataZoom 组件 用于区域缩放，从而能自由关注细节的数据信息
 |API|版本|描述|
 |--|--|--|
 |GraphEdge()||public GraphEdge(GraphNode node1, GraphNode node2, double value)|
+|IsPointInEdge()||public bool IsPointInEdge(Vector2 point)|
 
 ## GraphNode
 

diff --git a/Documentation~/zh/changelog.md b/Documentation~/zh/changelog.md
@@ -6,6 +6,7 @@ slug: /changelog
 # 更新日志
 
 [master](#master)  
+[v3.11.0](#v3110)  
 [v3.10.2](#v3102)  
 [v3.10.1](#v3101)  
 [v3.10.0](#v3100)  
@@ -73,6 +74,19 @@ slug: /changelog
 
 ## master
 
+## v3.11.0
+
+版本要点：
+
+* 增加`Line3DChart`3D折线图
+* 增加`GraphChart`关系图
+* 增加`3D`坐标系支持
+* 增加`Tooltip`的`triggerOn`设置触发条件
+* 其他问题修复和优化
+
+日志详情：
+
+* (2024.06.16) 发布`v3.11.0`版本
 * (2024.06.15) 增加`Editor`下`Data`的添加、删除、上下移动操作按钮
 * (2024.06.11) 修复`Axis`的`IndicatorLabel`可能会遮挡住`Tooltip`的问题
 * (2024.06.11) 修复`Tooltip`在`Cross`时`Axis`的`IndicatorLabel`可能不显示的问题 (#315)

diff --git a/Documentation~/zh/support.md b/Documentation~/zh/support.md
@@ -79,11 +79,14 @@ slug: /support
 | 102 | [漏斗图](https://xcharts-team.github.io/docs/funnel)      |FunnelChart        | 98¥   |
 | 103 | [3D金字塔](https://xcharts-team.github.io/docs/pyramid)    |PyramidChart       | 98¥   |
 | 104 | [树形矩图](https://xcharts-team.github.io/docs/treemap)    |TreemapChart       | 98¥   |
+| 105 | [桑基图](https://xcharts-team.github.io/docs/sankey)    |SankeyChart       | 98¥   |
 | 201 | [3D柱图](https://xcharts-team.github.io/docs/bar3d)      |Bar3DChart         | 198¥  |
 | 202 | [3D饼图](https://xcharts-team.github.io/docs/pie3d)      |Pie3DChart         | 198¥  |
 | 203 | [甘特图](https://xcharts-team.github.io/docs/gantt)      |GanttChart         | 198¥  |
 | 204 | [仪表盘](https://xcharts-team.github.io/docs/gauge)      |GaugeChart         | 198¥  |
 | 205 | [水位图](https://xcharts-team.github.io/docs/liquid)      |LiquidChart        | 198¥  |
+| 206 | [3D折线图](https://xcharts-team.github.io/docs/line3d)      |Line3DChart        | 198¥  |
+| 207 | [关系图](https://xcharts-team.github.io/docs/graph)      |GraphChart        | 198¥  |
 
 扩展图表的在线效果图也可以查看[WebGL在线Demo](https://xcharts-team.github.io/examples/)
 

diff --git a/Documentation~/zh/tutorial01.md b/Documentation~/zh/tutorial01.md
@@ -44,7 +44,7 @@ XCharts可通过以下任意一种方式导入到项目：
 
 ## 添加一个简单图表
 
-在`Hierarchy`视图下右键或菜单栏`GameObject`下拉选择`XCharts->LineChart`，即可快速创建一个默认的折线图出来：
+在`Hierarchy`视图下右键`UI->XCharts->LineChart`或菜单栏`GameObject`下拉选择`XCharts->LineChart`，即可快速创建一个默认的折线图出来：
 
 ![linechart1](img/tutorial01_linechart1.png)
 

diff --git a/README-en.md b/README-en.md
@@ -45,94 +45,79 @@
 
 ![XCharts](Documentation~/zh/img/xcharts.png)
 
-A powerful and easy-to-use data visualization library for Unity.  It supports more than ten built-in charts, including line, bar, pie, radar, scatter, heatmap, ring, candlestick, polar, parallel coordinates, as well as extended charts such as 3d pie, 3d bar, 3d pyramid, funnel, gauge, liquid, pictorialbar, gantt, and treemap.
-
-[XCharts3.0 Homepage](https://xcharts-team.github.io)
-
-[XCharts3.0 Tutorial](Documentation~/en/tutorial01.md)  
-[XCharts3.0 API](Documentation~/en/api.md)  
-[XCharts3.0 FAQ](Documentation~/en/faq.md)  
-[XCharts3.0 Configurate](Documentation~/en/configuration.md)  
-[XCharts3.0 Changelog](Documentation~/en/changelog.md)  
-[XCharts3.0 Support](Documentation~/en/support.md)  
-
-## Features
-
-* __Pure code rendering__: The chart is completely rendered with pure code, without the need for additional texture or shader resources.
-* __Visual configuration__: Visual configuration of parameters with real-time preview of the effect, and support for dynamic modification of configuration and data during runtime.
-* __High customizability__: Supports arbitrary adjustments from theme and configuration parameters; supports custom drawing, callback functions, and custom implementations of charts.
-* __Multiple built-in charts__: Supports various built-in charts such as line charts, bar charts, pie charts, radar charts, scatter plots, heat maps, polar charts, K-line charts, parallel coordinates, etc.
-* __Multiple extended charts__: Supports extended charts such as 3D column charts, 3D pie charts, funnel charts, pyramids, dashboards, water level charts, iconic bar charts, Gantt charts, and tree maps.
-* __Multiple extended features__: Supports extended UI components such as tables and statistical values.
-* __Multiple chart combinations__: Supports arbitrary combinations of built-in charts, with multiple same or different types of charts displayed simultaneously in the same chart.
-* __Various coordinate systems__: Supports coordinate systems such as Cartesian coordinates, polar coordinates, and single axes.
-* __Rich components__: Supports common components such as titles, legends, tooltips, markings, marking areas, data area zooming, and visual mapping.
-* __Rich line charts__: Supports various line charts such as straight line charts, curved line charts, dashed line charts, area charts, step line charts, etc.
-* __Rich bar charts__: Supports various bar charts such as stacked bar charts, stacked percentage bar charts, zebra bar charts, and capsule bar charts.
-* __Rich pie charts__: Supports various pie charts such as ring charts, rose charts, ring rose charts, etc.
-* __Rich lines__: Supports various lines such as solid lines, curves, step lines, dashed lines, dot lines, dotted lines, and double dot-dashed lines.
-* __Custom drawing__: Supports custom chart content drawing with powerful drawing APIs for drawing points, lines, and other graphics.
-* __Large data rendering__: Supports rendering of tens of thousands of data points; supports sampling rendering; special simplified charts support better performance.
-* __Custom themes__: Supports theme customization and import/export; includes both light and dark default themes.
-* __Animations and interactions__: Supports various animations such as fade-in animation, fade-out animation, change animation, addition animation, and * interactive animation; supports interactive operations such as data filtering, view zooming, and detailed display on multiple platforms.
-* __Third-party extensions__: Supports integration with TexMeshPro and New Input System.
-* __Version and compatibility__: Supports all Unity versions above 5.6 and runs on all platforms.
+## Overview
+
+A powerful and easy-to-use data visualization library for Unity.  It supports more than ten built-in charts, including line, bar, pie, radar, scatter, heatmap, ring, candlestick, polar, parallel coordinates, as well as extended charts such as 3d pie, 3d bar, 3d pyramid, funnel, gauge, liquid, pictorialbar, gantt, treemap, sankey, line3d and graph chart.
+
+## Key Features
+
+- __Pure Code Rendering__: Charts are rendered with pure code, eliminating the need for extra texture or shader resources.
+- __Visual Configuration__: Configure parameters visually with real-time preview and support for dynamic configuration and data adjustments at runtime.
+- __High Customizability__: Themes and configuration parameters can be adjusted as needed, with support for custom drawing and callbacks.
+- __Built-in and Extended Charts__: Supports a variety of chart types, including 3D charts and special chart types like gauges and treemaps.
+- __Multiple Chart Combinations__: Combine multiple charts of the same or different types within a single instance.
+- __Various Coordinate Systems__: Supports different coordinate systems such as Cartesian, polar, and single axes.
+- __Rich Components__: Includes titles, legends, tooltips, and more.
+- __Custom Drawing__: Utilize a powerful API for custom drawing of points, lines, and other graphics.
+- __Large Data Rendering__: Capable of rendering tens of thousands of data points with support for sampling rendering.
+- __Custom Themes__: Customize themes and use the included light and dark default themes.
+- __Animations and Interactions__: Supports various animations and interactions for a dynamic user experience.
+- __Third-Party Extensions__: Integrates with TextMeshPro and the New Input System.
+- __Version and Compatibility__: Compatible with all Unity versions above 5.6 and runs on all platforms.
+
+## Documentation
+
+- [XCharts3.0 Homepage](https://xcharts-team.github.io)
+- [XCharts3.0 Tutorial](Documentation~/en/tutorial01.md)  
+- [XCharts3.0 API](Documentation~/en/api.md)  
+- [XCharts3.0 FAQ](Documentation~/en/faq.md)  
+- [XCharts3.0 Configurate](Documentation~/en/configuration.md)  
+- [XCharts3.0 Changelog](Documentation~/en/changelog.md)  
+- [XCharts3.0 Support](Documentation~/en/support.md)  
 
 ## Screenshots
 
 ![buildinchart](Documentation~/en/img/readme_buildinchart.png)
 
 ![extendchart](Documentation~/en/img/readme_extendchart.png)
 
-## Attention
+## Important Notes
 
-* `XCharts3.0` is not fully compatible with `XCharts2.0` version, upgrading `3.0` may require some code adjustments, and some chart configurations need to be readjusting. It is recommended that old projects can continue to use `XCharts2.0`, and new projects are recommended to use `XCharts3.0`.
-* `XCharts2.0` enters the maintenance phase, and only serious `bugs` will be fixed later, in principle, no more new features will be added.
-* `XCharts` theoretically supports `Unity 5.6` and above, but due to limited version testing, it is inevitable to slip up, and version compatibility issues can be raised.
-* This repository only contains `XCharts` source code, does not contain `Demo` sample section. Need to look at ` Demo ` please go to the sample source code [XCharts - Demo](https://github.com/XCharts-Team/XCharts-Demo) repo. You can also view the running effect of `WebGL` in your browser [Online Demo](https://xcharts-team.github.io/examples/).
+- `XCharts3.0` is not fully compatible with `XCharts2.0`. Upgrading to 3.0 may require code adjustments and reconfiguration of some charts.
+- `XCharts2.0` is in the maintenance phase with only critical bug fixes applied.
+- While XCharts supports Unity 5.6 and above, compatibility issues may arise due to limited testing.
+- This repository contains only the `XCharts` source code. For demos, visit the [XCharts-Demo](https://github.com/XCharts-Team/XCharts-Demo) repo or the [Online Demo](https://xcharts-team.github.io/examples/).
 
-## Use
+## Getting Started
 
-* Import `XCharts` unitypackage or source code into the project.
-* Right-click `Hierarchy` view and choose `XCharts->LineChart` to create a default LineChart.
-* You can adjust the parameters of each component in `Inspector` and see the real-time effects in `Game` view.
-* For more details, see [[XCharts Tutorial: 5-minute tutorial]](Documentation~/en/tutorial01.md)
-* For the first time, it is recommended to read the tutorial carefully.
+1. Import the `XCharts` unitypackage or source code into your Unity project.
+2. Create a chart by right-clicking in the `Hierarchy` view and selecting `UI->XCharts->LineChart`.
+3. Adjust component parameters in the `Inspector` to see real-time effects in the `Game` view.
+4. For more details, refer to the [5-minute tutorial](Documentation~/en/tutorial01.md).
 
-## Branch
+## Branch Information
 
-* `master` : indicates the development branch. The latest changes and new features are first committed to the `master` branch, and after some time from the `master` branch `merge` to the `3.0` branch, and the `release` version.
-* `3.0` : Stable branch of XCharts 3.0. It is generally updated once a month, with the latest changes from the `master` branch `merge`, and the `release` version is released.
-* `2.0` : A stable branch of XCharts 2.0. With Demo, currently no longer maintenance, only to modify serious bugs.
-* `2.0-upm` : Stable UMP branch of XCharts 2.0. Only the Package part is included without Demo. It is dedicated to the UMP and is not maintained.
-* `1.0` : Stable branch of XCharts 1.0. With Demo, no maintenance.
-* `1.0-upm` : stable UMP branch of XCharts 1.0. No Demo, no maintenance.
+- __master__ indicates the development branch. The latest changes and new features are first committed to the `master` branch, and after some time from the `master` branch `merge` to the `3.0` branch, and the `release` version.
+- __3.0__ Stable branch of XCharts 3.0. It is generally updated once a month, with the latest changes from the `master` branch `merge`, and the `release` version is released.
+- __2.0__ A stable branch of XCharts 2.0. With Demo, currently no longer maintenance, only to modify serious bugs.
+- __2.0-upm__ Stable UMP branch of XCharts 2.0. Only the Package part is included without Demo. It is dedicated to the UMP and is not maintained.
+- __1.0__ Stable branch of XCharts 1.0. With Demo, no maintenance.
+- __1.0-upm__ stable UMP branch of XCharts 1.0. No Demo, no maintenance.
 
 ## FAQ
 
-* Is `XCharts` free to use?  
-A: `XCharts` uses the `MIT` licence and is free to use. You can also subscribe to `VIP` to enjoy more value-added services.
-
-* Does `XCharts` support code to dynamically add and modify data? Does it support getting data from `Excel` or a database?  
-A: Support code to dynamically add and modify data, but data needs to be parsed or retrieved by itself, and then added to `XCharts` by calling the public interface of `XCharts`.
-
-* Does this plugin work on other platforms (e.g. Winform or WPF) besides Unity?  
-A: It is currently only supported on Unity. Theoretically any version of Unity that supports `UGUI` can run `XCharts`.
-
-* What about the jags? What magnitude of data is supported?
-A: XCharts is based on UGUI implementation, so the problems encountered in UGUI will also exist in XCharts. For example, the sawtooth problem, such as the number of vertices in `Mesh` exceeds `65535`. Solutions to these two problems can be found in [Q&A 16](Documentation~/en/faq.md) and [Q&A 27](Documentation~/en/faq.md).
-Due to the `Mesh` of the `65535` vertex limit, the current `XCharts` single `Line` supports about `20,000` of data, of course, open sampling can support more data to draw, but at the same time it will consume more CPU.
+- __Is XCharts free to use?__ Yes, XCharts is free under the MIT license and includes value-added VIP services.
+- __Does XCharts support dynamic data addition and modification?__ Yes, but data must be parsed or retrieved by the user.
+- __Does this plugin work on platforms other than Unity?__ No, it is designed for Unity only.
 
 ## Changelog
 
-* [Changelog](Documentation~/en/changelog.md)  
+- [Changelog](Documentation~/en/changelog.md)  
 
 ## Licenses
 
-* [MIT License](https://github.com/XCharts-Team/XCharts/blob/master/LICENSE.md)
-* Free commercial, secondary development
-* The extended charts and advanced features sections require a separate purchase license
+- XCharts is released under the [MIT License](https://github.com/XCharts-Team/XCharts/blob/master/LICENSE.md).
 
-## Other
+## Contact
 
-email: `monitor1394@gmail.com`
+- For more information or support, contact us at `monitor1394@gmail.com`.