3.8.0

2026-05-16 21:40:41 +00:00 · 2023-07-11 23:11:05 +08:00
parent 1229c1bfa2
commit eca0c6ea46
7 changed files with 171 additions and 42 deletions
--- a/Documentation~/en/api.md
+++ b/Documentation~/en/api.md
@@ -7,6 +7,7 @@ slug: /api

 ## All Class

+- [AnimationInfoContext](#animationinfocontext)
 - [AnimationStyleHelper](#animationstylehelper)
 - [AxisContext](#axiscontext)
 - [AxisHandler&lt;T&gt;](#axishandlert)
@@ -111,6 +112,10 @@ slug: /api
 - [XCThemeMgr](#xcthememgr)


+## AnimationInfoContext
+
+> XCharts.Runtime.AnimationInfoContext
+
 ## AnimationStyleHelper

 > XCharts.Runtime.AnimationStyleHelper
@@ -119,7 +124,7 @@ slug: /api
 |--|--|--|
 |CheckDataAnimation()||public static float CheckDataAnimation(BaseChart chart, Serie serie, int dataIndex, float destProgress, float startPorgress = 0)|
 |GetAnimationPosition()||public static bool GetAnimationPosition(AnimationStyle animation, bool isY, Vector3 lp, Vector3 cp, float progress, ref Vector3 ip)|
-|UpdateAnimationType()||public static void UpdateAnimationType(AnimationStyle animation, AnimationType defaultType)|
+|UpdateAnimationType()||public static void UpdateAnimationType(AnimationStyle animation, AnimationType defaultType, bool enableSerieDataAnimation)|
 |UpdateSerieAnimation()||public static void UpdateSerieAnimation(Serie serie)|

 ## AxisContext
@@ -206,12 +211,14 @@ slug: /api
 |AddXAxisIcon()||public void AddXAxisIcon(Sprite icon, int xAxisIndex = 0)<br/>Add an icon to xAxis. |
 |AddYAxisData()||public void AddYAxisData(string category, int yAxisIndex = 0)<br/>Add a category data to yAxis. |
 |AddYAxisIcon()||public void AddYAxisIcon(Sprite icon, int yAxisIndex = 0)<br/>Add an icon to yAxis. |
-|AnimationEnable()||public void AnimationEnable(bool flag)<br/>Whether series animation enabel. |
-|AnimationFadeIn()||public void AnimationFadeIn(bool reset = true)<br/>fadeIn animation. |
-|AnimationFadeOut()||public void AnimationFadeOut()<br/>fadeIn animation. |
-|AnimationPause()||public void AnimationPause()<br/>Pause animation. |
-|AnimationReset()||public void AnimationReset()<br/>Reset animation. |
-|AnimationResume()||public void AnimationResume()<br/>Stop play animation. |
+|AnimationEnable()||public void AnimationEnable(bool flag)<br/>Whether enable serie animations. |
+|AnimationFadein()||public void AnimationFadein(bool reset = true)<br/>Start all serie fadein animations. |
+|AnimationFadeIn()||public void AnimationFadeIn(bool reset = true)|
+|AnimationFadeout()||public void AnimationFadeout()<br/>Start all serie fadeout animations. |
+|AnimationFadeOut()||public void AnimationFadeOut()|
+|AnimationPause()||public void AnimationPause()<br/>Pause all animations. |
+|AnimationReset()||public void AnimationReset()<br/>Reset all animations. |
+|AnimationResume()||public void AnimationResume()<br/>Resume all animations. |
 |CanAddChartComponent()||public bool CanAddChartComponent(Type type)|
 |CanAddSerie()||public bool CanAddSerie(Type type)|
 |CanAddSerie&lt;T&gt;()||public bool CanAddSerie&lt;T&gt;() where T : Serie|
@@ -599,6 +606,7 @@ slug: /api
 |public method|since|description|
 |--|--|--|
 |DefaultAnimationAttribute()||public DefaultAnimationAttribute(AnimationType handler)|
+|DefaultAnimationAttribute()||public DefaultAnimationAttribute(AnimationType handler, bool enableSerieDataAddedAnimation)|

 ## DefineSymbolsUtil

--- a/Documentation~/en/configuration.md
+++ b/Documentation~/en/configuration.md
@@ -166,6 +166,11 @@ import APITable from '@site/src/components/APITable';

 ## Other

+- [AnimationAddition](#animationaddition)
+- [AnimationChange](#animationchange)
+- [AnimationFadeIn](#animationfadein)
+- [AnimationFadeout](#animationfadeout)
+- [AnimationInfo](#animationinfo)
 - [BaseSerie](#baseserie)
 - [ChartText](#charttext)
 - [ChildComponent](#childcomponent)
@@ -209,11 +214,67 @@ Angle axis of Polar Coordinate.

 > XCharts.Runtime.AngleAxisTheme : [BaseAxisTheme](#baseaxistheme)

+## AnimationAddition
+
+> XCharts.Runtime.AnimationAddition : [AnimationInfo](#animationinfo)
+
+> Since `v3.8.0`
+
+Data addition animation.
+
+## AnimationChange
+
+> XCharts.Runtime.AnimationChange : [AnimationInfo](#animationinfo)
+
+> Since `v3.8.0`
+
+Data change animation.
+
+## AnimationFadeIn
+
+> XCharts.Runtime.AnimationFadeIn : [AnimationInfo](#animationinfo)
+
+> Since `v3.8.0`
+
+Fade in animation.
+
+## AnimationFadeout
+
+> XCharts.Runtime.AnimationFadeout : [AnimationInfo](#animationinfo)
+
+> Since `v3.8.0`
+
+Fade out animation.
+
+## AnimationInfo
+
+> XCharts.Runtime.AnimationInfo / Subclasses: [AnimationFadeIn](#animationfadein), [AnimationFadeout](#animationfadeout), [AnimationChange](#animationchange), [AnimationAddition](#animationaddition)
+
+> Since `v3.8.0`
+
+the animation info.
+
+```mdx-code-block
+<APITable name="AnimationInfo">
+```
+
+
+|field|default|since|comment|
+|--|--|--|--|
+|enable|true|v3.8.0|whether enable animation.
+|reverse|false|v3.8.0|whether enable reverse animation.
+|delay|0|v3.8.0|the delay time before animation start.
+|duration|1000|v3.8.0|the duration of animation.
+
+```mdx-code-block
+</APITable>
+```
+
 ## AnimationStyle

 > XCharts.Runtime.AnimationStyle : [ChildComponent](#childcomponent)

-the animation of serie.
+the animation of serie. support animation type: fadeIn, fadeOut, change, addition.

 ```mdx-code-block
 <APITable name="AnimationStyle">
@@ -224,18 +285,13 @@ the animation of serie.
 |--|--|--|--|
 |enable|true||Whether to enable animation.
 |type|||The type of animation.<br/>`AnimationType`:<br/>- `Default`: he default. An animation playback mode will be selected according to the actual situation.<br/>- `LeftToRight`: Play the animation from left to right.<br/>- `BottomToTop`: Play the animation from bottom to top.<br/>- `InsideOut`: Play animations from the inside out.<br/>- `AlongPath`: Play the animation along the path.<br/>- `Clockwise`: Play the animation clockwise.<br/>|
-|easting|||Easing method used for the first animation.<br/>`AnimationEasing`:<br/>- `Linear`: <br/>|
+|easting|||<br/>`AnimationEasing`:<br/>- `Linear`: <br/>|
 |threshold|2000||Whether to set graphic number threshold to animation. Animation will be disabled when graphic number is larger than threshold.
-|fadeInDuration|1000||The milliseconds duration of the fadeIn animation.
-|fadeInDelay|0||The milliseconds delay before updating the first animation.
-|fadeOutDuration|1000f||The milliseconds duration of the fadeOut animation.
-|fadeOutDelay|0||渐出动画延时（毫秒）。如果要设置单个数据项的延时，可以用代码定制：customFadeOutDelay。
-|dataChangeEnable|true||是否开启数据变更动画。
-|dataChangeDuration|500||The milliseconds duration of the data change animation.
-|actualDuration|||The milliseconds actual duration of the first animation.
 |unscaledTime||v3.4.0|Animation updates independently of Time.timeScale.
-|dataAddEnable|true|v3.8.0|Whether to enable data add animation.
-|dataAddDuration|500|v3.8.0|The milliseconds duration of the data add animation.
+|fadein||v3.8.0|Fade in animation configuration. [AnimationFadeIn](#animationfadein)|
+|fadeout||v3.8.0|Fade out animation configuration. [AnimationFadeout](#animationfadeout)|
+|change||v3.8.0|Update data animation configuration. [AnimationChange](#animationchange)|
+|addition||v3.8.0|Add data animation configuration. [AnimationAddition](#animationaddition)|

 ```mdx-code-block
 </APITable>
--- a/Documentation~/zh/api.md
+++ b/Documentation~/zh/api.md
@@ -7,6 +7,7 @@ slug: /api

 ## 所有类

+- [AnimationInfoContext](#animationinfocontext)
 - [AnimationStyleHelper](#animationstylehelper)
 - [AxisContext](#axiscontext)
 - [AxisHandler&lt;T&gt;](#axishandlert)
@@ -111,6 +112,10 @@ slug: /api
 - [XCThemeMgr](#xcthememgr)


+## AnimationInfoContext
+
+> XCharts.Runtime.AnimationInfoContext
+
 ## AnimationStyleHelper

 > XCharts.Runtime.AnimationStyleHelper
@@ -119,7 +124,7 @@ slug: /api
 |--|--|--|
 |CheckDataAnimation()||public static float CheckDataAnimation(BaseChart chart, Serie serie, int dataIndex, float destProgress, float startPorgress = 0)|
 |GetAnimationPosition()||public static bool GetAnimationPosition(AnimationStyle animation, bool isY, Vector3 lp, Vector3 cp, float progress, ref Vector3 ip)|
-|UpdateAnimationType()||public static void UpdateAnimationType(AnimationStyle animation, AnimationType defaultType)|
+|UpdateAnimationType()||public static void UpdateAnimationType(AnimationStyle animation, AnimationType defaultType, bool enableSerieDataAnimation)|
 |UpdateSerieAnimation()||public static void UpdateSerieAnimation(Serie serie)|

 ## AxisContext
@@ -206,12 +211,14 @@ slug: /api
 |AddXAxisIcon()||public void AddXAxisIcon(Sprite icon, int xAxisIndex = 0)<br/>添加一个图标到指定的x轴。 |
 |AddYAxisData()||public void AddYAxisData(string category, int yAxisIndex = 0)<br/>添加一个类目数据到指定的y轴。 |
 |AddYAxisIcon()||public void AddYAxisIcon(Sprite icon, int yAxisIndex = 0)<br/>添加一个图标到指定的y轴。 |
-|AnimationEnable()||public void AnimationEnable(bool flag)<br/>启用或关闭起始动画。 |
-|AnimationFadeIn()||public void AnimationFadeIn(bool reset = true)<br/>开始渐入动画。 |
-|AnimationFadeOut()||public void AnimationFadeOut()<br/>开始渐出动画。 |
-|AnimationPause()||public void AnimationPause()<br/>暂停动画。 |
-|AnimationReset()||public void AnimationReset()<br/>重置动画。 |
-|AnimationResume()||public void AnimationResume()<br/>继续动画。 |
+|AnimationEnable()||public void AnimationEnable(bool flag)<br/>是否启用Serie动画。 |
+|AnimationFadein()||public void AnimationFadein(bool reset = true)<br/>开始所有Serie的渐入动画。 |
+|AnimationFadeIn()||public void AnimationFadeIn(bool reset = true)|
+|AnimationFadeout()||public void AnimationFadeout()<br/>开始所有Serie的渐出动画。 |
+|AnimationFadeOut()||public void AnimationFadeOut()|
+|AnimationPause()||public void AnimationPause()<br/>暂停所有Serie的动画。 |
+|AnimationReset()||public void AnimationReset()<br/>重置所有Serie的动画。 |
+|AnimationResume()||public void AnimationResume()<br/>继续所有Serie的动画。 |
 |CanAddChartComponent()||public bool CanAddChartComponent(Type type)|
 |CanAddSerie()||public bool CanAddSerie(Type type)|
 |CanAddSerie&lt;T&gt;()||public bool CanAddSerie&lt;T&gt;() where T : Serie|
@@ -599,6 +606,7 @@ slug: /api
 |public method|since|description|
 |--|--|--|
 |DefaultAnimationAttribute()||public DefaultAnimationAttribute(AnimationType handler)|
+|DefaultAnimationAttribute()||public DefaultAnimationAttribute(AnimationType handler, bool enableSerieDataAddedAnimation)|

 ## DefineSymbolsUtil

--- a/Documentation~/zh/changelog.md
+++ b/Documentation~/zh/changelog.md
@@ -7,6 +7,7 @@ slug: /changelog

 [master](#master)  
 [v3.7.0](#v370)  
+[v3.6.0](#v360)  
 [v3.5.0](#v350)  
 [v3.4.0](#v340)  
 [v3.3.0](#v330)  
@@ -72,7 +73,7 @@ slug: /changelog

 日志详情：

-* (2023.07.03) 增加`Animation`的添加动画支持
+* (2023.07.11) 重构`Animation`动画系统，增加`Addition`新增动画支持
 * (2023.06.30) 增加`PolarCood`的`indicatorLabelOffset`设置指示文本偏移的支持
 * (2023.06.30) 修复`Axis`的`IndicatorLabel`的背景颜色可能不正常的问题
 * (2023.06.30) 增加`Axis`的`IndicatorLabel`可自定义`color`的支持
--- a/Documentation~/zh/configuration.md
+++ b/Documentation~/zh/configuration.md
@@ -166,6 +166,11 @@ import APITable from '@site/src/components/APITable';

 ## Other 其他

+- [AnimationAddition](#animationaddition)
+- [AnimationChange](#animationchange)
+- [AnimationFadeIn](#animationfadein)
+- [AnimationFadeout](#animationfadeout)
+- [AnimationInfo](#animationinfo)
 - [BaseSerie](#baseserie)
 - [ChartText](#charttext)
 - [ChildComponent](#childcomponent)
@@ -209,11 +214,67 @@ import APITable from '@site/src/components/APITable';

 > XCharts.Runtime.AngleAxisTheme : [BaseAxisTheme](#baseaxistheme)

+## AnimationAddition
+
+> XCharts.Runtime.AnimationAddition : [AnimationInfo](#animationinfo)
+
+> 从 `v3.8.0` 开始支持
+
+数据新增动画。
+
+## AnimationChange
+
+> XCharts.Runtime.AnimationChange : [AnimationInfo](#animationinfo)
+
+> 从 `v3.8.0` 开始支持
+
+数据变更动画。
+
+## AnimationFadeIn
+
+> XCharts.Runtime.AnimationFadeIn : [AnimationInfo](#animationinfo)
+
+> 从 `v3.8.0` 开始支持
+
+淡入动画。
+
+## AnimationFadeout
+
+> XCharts.Runtime.AnimationFadeout : [AnimationInfo](#animationinfo)
+
+> 从 `v3.8.0` 开始支持
+
+淡出动画。
+
+## AnimationInfo
+
+> XCharts.Runtime.AnimationInfo / Subclasses: [AnimationFadeIn](#animationfadein), [AnimationFadeout](#animationfadeout), [AnimationChange](#animationchange), [AnimationAddition](#animationaddition)
+
+> 从 `v3.8.0` 开始支持
+
+动画配置参数。
+
+```mdx-code-block
+<APITable name="AnimationInfo">
+```
+
+
+|field|default|since|comment|
+|--|--|--|--|
+|enable|true|v3.8.0|是否开启动画效果。
+|reverse|false|v3.8.0|是否开启反向动画效果。
+|delay|0|v3.8.0|动画开始前的延迟时间。
+|duration|1000|v3.8.0|动画的时长。
+
+```mdx-code-block
+</APITable>
+```
+
 ## AnimationStyle

 > XCharts.Runtime.AnimationStyle : [ChildComponent](#childcomponent)

-动画表现。
+动画表现。支持配置四种动画表现：FadeIn（渐入动画），FadeOut（渐出动画），Change（变更动画），Addition（新增动画）。

 ```mdx-code-block
 <APITable name="AnimationStyle">
@@ -224,18 +285,13 @@ import APITable from '@site/src/components/APITable';
 |--|--|--|--|
 |enable|true||是否开启动画效果。
 |type|||动画类型。<br/>`AnimationType`:<br/>- `Default`: 默认。内部会根据实际情况选择一种动画播放方式。<br/>- `LeftToRight`: 从左往右播放动画。<br/>- `BottomToTop`: 从下往上播放动画。<br/>- `InsideOut`: 由内到外播放动画。<br/>- `AlongPath`: 沿着路径播放动画。当折线图从左到右无序或有折返时，可以使用该模式。<br/>- `Clockwise`: 顺时针播放动画。<br/>|
-|easting|||动画的缓动效果。<br/>`AnimationEasing`:<br/>- `Linear`: <br/>|
+|easting|||<br/>`AnimationEasing`:<br/>- `Linear`: <br/>|
 |threshold|2000||是否开启动画的阈值，当单个系列显示的图形数量大于这个阈值时会关闭动画。
-|fadeInDuration|1000||设定的渐入动画时长（毫秒）。如果要设置单个数据项的渐入时长，可以用代码定制：customFadeInDuration。
-|fadeInDelay|0||渐入动画延时（毫秒）。如果要设置单个数据项的延时，可以用代码定制：customFadeInDelay。
-|fadeOutDuration|1000f||设定的渐出动画时长（毫秒）。如果要设置单个数据项的渐出时长，可以用代码定制：customFadeOutDuration。
-|fadeOutDelay|0||渐出动画延时（毫秒）。如果要设置单个数据项的延时，可以用代码定制：customFadeOutDelay。
-|dataChangeEnable|true||是否开启数据变更动画。
-|dataChangeDuration|500||数据变更的动画时长（毫秒）。
-|actualDuration|||实际的动画时长（毫秒）。
 |unscaledTime||v3.4.0|动画是否受TimeScaled的影响。默认为 false 受TimeScaled的影响。
-|dataAddEnable|true|v3.8.0|是否开启数据增加动画。
-|dataAddDuration|500|v3.8.0|数据增加的动画时长（毫秒）。
+|fadein||v3.8.0|渐入动画配置。 [AnimationFadeIn](#animationfadein)|
+|fadeout||v3.8.0|渐出动画配置。 [AnimationFadeout](#animationfadeout)|
+|change||v3.8.0|数据变更动画配置。 [AnimationChange](#animationchange)|
+|addition||v3.8.0|数据新增动画配置。 [AnimationAddition](#animationaddition)|

 ```mdx-code-block
 </APITable>
--- a/Runtime/Internal/XChartsMgr.cs
+++ b/Runtime/Internal/XChartsMgr.cs
@@ -21,8 +21,8 @@ namespace XCharts.Runtime
    [ExecuteInEditMode]
    public static class XChartsMgr
    {
-        public static readonly string version = "3.7.0";
-        public static readonly int versionDate = 20230601;
+        public static readonly string version = "3.8.0";
+        public static readonly int versionDate = 20230801;
        public static string fullVersion { get { return version + "-" + versionDate; } }

        internal static List<BaseChart> chartList = new List<BaseChart>();
--- a/package.json
+++ b/package.json
@@ -1,9 +1,9 @@
 {
  "name": "com.monitor1394.xcharts",
  "displayName": "XCharts",
-  "version": "3.7.0",
-  "date": "20230601",
-  "checkdate": "20230601",
+  "version": "3.8.0",
+  "date": "20230801",
+  "checkdate": "20230801",
  "desc": "如果 XCharts 对您有帮助，希望您能在 Github 上点 Star 支持，非常感谢！",
  "unity": "2018.3",
  "description": "A charting and data visualization library for Unity.",