增加Serie的minRadius可设置最小半径

2026-05-28 20:28:46 +00:00 · 2023-07-27 07:58:10 +08:00
parent 0c09d40654
commit fc7655fd76
8 changed files with 182 additions and 29 deletions
--- a/Documentation~/en/api.md
+++ b/Documentation~/en/api.md
@@ -57,6 +57,7 @@ slug: /api
 - [MainComponentHandler](#maincomponenthandler)
 - [MainComponentHandler&lt;T&gt;](#maincomponenthandlert)
 - [MathUtil](#mathutil)
+- [MonoBehaviour](#monobehaviour)
 - [Painter](#painter)
 - [ParallelChart](#parallelchart)
 - [ParallelCoordContext](#parallelcoordcontext)
@@ -110,6 +111,7 @@ slug: /api
 - [XChartsMgr](#xchartsmgr)
 - [XCResourceImporterWindow](#xcresourceimporterwindow)
 - [XCThemeMgr](#xcthememgr)
+- [XLog](#xlog)


 ## AnimationInfoContext
@@ -665,14 +667,19 @@ slug: /api
 |Reset()||public void Reset()|
 |SetColor()||public void SetColor(ref bool needInteract, Color32 color)|
 |SetColor()||public void SetColor(ref bool needInteract, Color32 color, Color32 toColor)|
-|SetValue()||public void SetValue(ref bool needInteract, float size)|
-|SetValue()||public void SetValue(ref bool needInteract, float size, bool highlight, float rate = 1.3f)|
+|SetPosition()||public void SetPosition(ref bool needInteract, Vector3 pos)|
+|SetValue()||public void SetValue(ref bool needInteract, float value)|
+|SetValue()||public void SetValue(ref bool needInteract, float value, bool highlight, float rate = 1.3f)|
 |SetValueAndColor()||public void SetValueAndColor(ref bool needInteract, float value, Color32 color)|
 |SetValueAndColor()||public void SetValueAndColor(ref bool needInteract, float value, Color32 color, Color32 toColor)|
+|ToString()||public override string ToString()|
 |TryGetColor()||public bool TryGetColor(ref Color32 color, ref bool interacting, float animationDuration = 250)|
 |TryGetColor()||public bool TryGetColor(ref Color32 color, ref Color32 toColor, ref bool interacting, float animationDuration = 250)|
+|TryGetPosition()||public bool TryGetPosition(ref Vector3 pos, ref bool interacting, float animationDuration = 250)|
 |TryGetValue()||public bool TryGetValue(ref float value, ref bool interacting, float animationDuration = 250)|
 |TryGetValueAndColor()||public bool TryGetValueAndColor(ref float value, ref Color32 color, ref Color32 toColor, ref bool interacting, float animationDuration = 250)|
+|TryGetValueAndColor()||public bool TryGetValueAndColor(ref float value, ref Vector3 pos, ref bool interacting, float animationDuration = 250)|
+|TryGetValueAndColor()||public bool TryGetValueAndColor(ref float value, ref Vector3 pos, ref Color32 color, ref Color32 toColor, ref bool interacting, float animationDuration = 250)|

 ## IPropertyChanged

@@ -720,7 +727,7 @@ The interface for serie data component.

 |public method|since|description|
 |--|--|--|
-|CheckDataHighlighted()||public static bool CheckDataHighlighted(Serie serie, string legendName, bool heighlight)|
+|CheckDataHighlighted()||public static int CheckDataHighlighted(Serie serie, string legendName, bool heighlight)|
 |CheckDataShow()||public static bool CheckDataShow(Serie serie, string legendName, bool show)|
 |GetContentColor()||public static Color GetContentColor(BaseChart chart, int legendIndex, string legendName, Legend legend, ThemeStyle theme, bool active)|
 |GetIconColor()||public static Color GetIconColor(BaseChart chart, Legend legend, int readIndex, string legendName, bool active)|
@@ -826,6 +833,10 @@ The interface for serie data component.
 |IsInteger()||public static bool IsInteger(double value)|
 |Lerp()||public static double Lerp(double a, double b, double t)|

+## MonoBehaviour
+
+> .MonoBehaviour / Subclasses: [XLog](#xlog) 
+
 ## ObjectPool&lt;T&gt; where T

 > XCharts.Runtime.ObjectPool&lt;T&gt; where T : [new()](#new())
@@ -1131,7 +1142,7 @@ the data of serie event.
 |GetSerieState()||public static SerieState GetSerieState(SerieData serieData)|
 |GetSerieSymbol()||public static SerieSymbol GetSerieSymbol(Serie serie, SerieData serieData, SerieState state = SerieState.Auto)|
 |GetStateStyle()||public static StateStyle GetStateStyle(Serie serie, SerieData serieData, SerieState state)|
-|GetSysmbolSize()||public static float GetSysmbolSize(Serie serie, SerieData serieData, ThemeStyle theme, float defaultSize, SerieState state = SerieState.Auto)|
+|GetSysmbolSize()||public static float GetSysmbolSize(Serie serie, SerieData serieData, float defaultSize, SerieState state = SerieState.Auto)|
 |GetTitleStyle()||public static TitleStyle GetTitleStyle(Serie serie, SerieData serieData)|
 |IsAllZeroValue()||public static bool IsAllZeroValue(Serie serie, int dimension = 1)<br/>Whether the data for the specified dimension of serie are all 0. |
 |IsDownPoint()||public static bool IsDownPoint(Serie serie, int index)|
@@ -1416,3 +1427,26 @@ UI帮助类。
 |ReloadThemeList()||public static void ReloadThemeList()<br/>重新加载主题列表 |
 |SwitchTheme()||public static void SwitchTheme(BaseChart chart, string themeName)|

+## XLog
+
+> XCharts.Runtime.XLog : [MonoBehaviour](#monobehaviour)
+Log system. Used to output logs with date and log type, support output to file, support custom output log type.
+
+|public method|since|description|
+|--|--|--|
+|CanLog()||public static bool CanLog(int level)|
+|ClearAllLog()||public static void ClearAllLog()|
+|Debug()||public static void Debug(string log)|
+|EnableLog()||public static void EnableLog(int logType)|
+|Error()||public static void Error(string log)|
+|FlushLog()||public static void FlushLog()|
+|GetNowTime()||public static string GetNowTime(string formatter = null)|
+|GetTimestamp()||public static ulong GetTimestamp()|
+|Info()||public static void Info(string log)|
+|Log()||public static void Log(string log)|
+|LogError()||public static void LogError(string log)|
+|LogWarning()||public static void LogWarning(string log)|
+|Proto()||public static void Proto(string log)|
+|Vital()||public static void Vital(string log)|
+|Warning()||public static void Warning(string log)|
+
--- a/Documentation~/en/configuration.md
+++ b/Documentation~/en/configuration.md
@@ -112,6 +112,7 @@ import APITable from '@site/src/components/APITable';
 - [MarkAreaData](#markareadata)
 - [MarkLineData](#marklinedata)
 - [MarqueeStyle](#marqueestyle)
+- [MLValue](#mlvalue)
 - [Padding](#padding)
 - [PolarAxisTheme](#polaraxistheme)
 - [RadarAxisTheme](#radaraxistheme)
@@ -170,6 +171,7 @@ import APITable from '@site/src/components/APITable';
 - [AnimationChange](#animationchange)
 - [AnimationFadeIn](#animationfadein)
 - [AnimationFadeOut](#animationfadeout)
+- [AnimationHiding](#animationhiding)
 - [AnimationInfo](#animationinfo)
 - [AnimationInteraction](#animationinteraction)
 - [BaseSerie](#baseserie)
@@ -247,9 +249,17 @@ Fade in animation.

 Fade out animation.

+## AnimationHiding
+
+> XCharts.Runtime.AnimationHiding : [AnimationInfo](#animationinfo)
+
+> Since `v3.8.0`
+
+Data hiding animation.
+
 ## AnimationInfo

-> XCharts.Runtime.AnimationInfo / Subclasses: [AnimationFadeIn](#animationfadein), [AnimationFadeOut](#animationfadeout), [AnimationChange](#animationchange), [AnimationAddition](#animationaddition), [AnimationInteraction](#animationinteraction)
+> XCharts.Runtime.AnimationInfo / Subclasses: [AnimationFadeIn](#animationfadein), [AnimationFadeOut](#animationfadeout), [AnimationChange](#animationchange), [AnimationAddition](#animationaddition), [AnimationHiding](#animationhiding), [AnimationInteraction](#animationinteraction)

 > Since `v3.8.0`

@@ -286,8 +296,9 @@ Interactive animation of charts.

 |field|default|since|comment|
 |--|--|--|--|
-|widthRate|1.3f|v3.8.0|the size rate of the width.
-|radiusRate|1.3f|v3.8.0|the size rate of the radius.
+|width||v3.8.0|the mlvalue of width. [MLValue](#mlvalue)|
+|radius||v3.8.0|the mlvalue of radius. [MLValue](#mlvalue)|
+|offset||v3.8.0|the mlvalue of offset. Such as the offset of the pie chart when the sector is selected. [MLValue](#mlvalue)|

 ```mdx-code-block
 </APITable>
@@ -315,6 +326,7 @@ the animation of serie. support animation type: fadeIn, fadeOut, change, additio
 |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)|
+|hiding||v3.8.0|Data hiding animation configuration. [AnimationHiding](#animationhiding)|
 |interaction||v3.8.0|Interaction animation configuration. [AnimationInteraction](#animationinteraction)|

 ```mdx-code-block
@@ -706,7 +718,7 @@ Configurations of blur state.

 ## ChildComponent

-> XCharts.Runtime.ChildComponent / Subclasses: [AnimationStyle](#animationstyle), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)
+> XCharts.Runtime.ChildComponent / Subclasses: [AnimationStyle](#animationstyle), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MLValue](#mlvalue), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)

 ## Comment

@@ -1501,6 +1513,28 @@ Marquee style. It can be used for the DataZoom component. 选取框样式。可
 </APITable>
 ```

+## MLValue
+
+> XCharts.Runtime.MLValue : [ChildComponent](#childcomponent)
+
+> Since `v3.8.0`
+
+多样式数值。
+
+```mdx-code-block
+<APITable name="MLValue">
+```
+
+
+|field|default|since|comment|
+|--|--|--|--|
+|type|||<br/>`MLValue.Type`:<br/>- `Percent`: Percent value form.<br/>- `Absolute`: Absolute value form.<br/>- `Extra`: Extra value form.<br/>|
+|value|||
+
+```mdx-code-block
+</APITable>
+```
+
 ## Padding

 > XCharts.Runtime.Padding : [ChildComponent](#childcomponent) / Subclasses: [TextPadding](#textpadding)
@@ -1699,6 +1733,7 @@ Configurations of select state.
 |gap|||gap of item.
 |center|||the center of chart.
 |radius|||the radius of chart.
+|minRadius|0f|v3.8.0|the min radius of chart. It can be used to limit the minimum radius of the rose chart.
 |showDataDimension|||数据项里的数据维数。
 |showDataName|||在Editor的inpsector上是否显示name参数
 |clip|false||If clip the overflow on the coordinate system.
@@ -1798,8 +1833,6 @@ A data item of serie.
 |lineWidth|||the color of text.
 |lineSymbolSize|||the symbol size of line serie.
 |scatterSymbolSize|||the symbol size of scatter serie.
-|pieTooltipExtraRadius|||the extra radius of pie when actived by tooltip.
-|pieSelectedOffset|||the center offset of pie if selected.
 |candlestickColor|Color32(235, 84, 84, 255)||K线图阳线（涨）填充色
 |candlestickColor0|Color32(71, 178, 98, 255)||K线图阴线（跌）填充色
 |candlestickBorderWidth|1||K线图边框宽度
@@ -2344,8 +2377,6 @@ The x axis in cartesian(rectangular) coordinate.
 |lineSegmentDistance|3f||
 |cicleSmoothness|2f||
 |visualMapTriangeLen|20f||
-|pieTooltipExtraRadius|8f||
-|pieSelectedOffset|8f||
 |customThemes|||

 ```mdx-code-block