3.10.0

2026-05-17 22:10:11 +00:00 · 2024-01-21 21:17:34 +08:00
parent d0448a5b11
commit e68e41a939
7 changed files with 27 additions and 31 deletions
--- a/Documentation~/en/api.md
+++ b/Documentation~/en/api.md
@@ -201,7 +201,6 @@ slug: /api
 - [StateStyle](#statestyle)
 - [SubTitleTheme](#subtitletheme)
 - [SVG](#svg)
- [SVGImage](#svgimage)
 - [SVGPath](#svgpath)
 - [SVGPathSeg](#svgpathseg)
 - [SymbolStyle](#symbolstyle)
@@ -1086,6 +1085,7 @@ A candlestick chart is a style of financial chart used to describe price movemen
 |SetActive()||public static void SetActive(Image image, bool active)|
 |SetActive()||public static void SetActive(Text text, bool active)|
 |SetActive()||public static void SetActive(Transform transform, bool active)<br/>通过设置scale实现是否显示，优化性能，减少GC |
+|SetBackground()||public static void SetBackground(Image background, Background imageStyle)|
 |SetBackground()||public static void SetBackground(Image background, ImageStyle imageStyle)|
 |SetColorOpacity()||public static void SetColorOpacity(ref Color32 color, float opacity)|

@@ -1856,6 +1856,7 @@ Line chart relates all the data points symbol by broken lines, which is used to
 |--|--|--|
 |DefaultAreaLineChart()||public void DefaultAreaLineChart()<br/>default area line chart. |
 |DefaultDashLineChart()||public void DefaultDashLineChart()<br/>default dash line chart. |
+|DefaultLogLineChart()||public void DefaultLogLineChart()<br/>default logarithmic line chart. |
 |DefaultSmoothAreaLineChart()||public void DefaultSmoothAreaLineChart()<br/>default smooth area line chart. |
 |DefaultSmoothLineChart()||public void DefaultSmoothLineChart()<br/>default smooth line chart. |
 |DefaultStackAreaLineChart()||public void DefaultStackAreaLineChart()<br/>default stack area line chart. |
@@ -2417,7 +2418,7 @@ Configurations of select state.
 |CompareTo()||public int CompareTo(object obj)|
 |EnsureComponent()||public ISerieComponent EnsureComponent(Type type)|
 |EnsureComponent&lt;T&gt;()||public T EnsureComponent&lt;T&gt;() where T : ChildComponent, ISerieComponent<br/>Ensure the serie has the component. If not, add it. |
-|GetBarWidth()||public float GetBarWidth(float categoryWidth, int barCount = 0)|
+|GetBarWidth()||public float GetBarWidth(float categoryWidth, int barCount = 0, float defaultRate = 0.6f)|
 |GetComponent()||public ISerieComponent GetComponent(Type type)|
 |GetComponent&lt;T&gt;()||public T GetComponent&lt;T&gt;() where T : ChildComponent, ISerieComponent|
 |GetData()||public double GetData(int index, int dimension, DataZoom dataZoom = null)<br/>获得指定index指定维数的数据 |
@@ -2940,11 +2941,6 @@ the state style of serie.
 |DrawPath()||public static void DrawPath(VertexHelper vh, SVGPath path)|
 |Test()||public static void Test(VertexHelper vh)|

-## SVGImage
-
-> class in XCharts.Runtime / Inherits from: [MaskableGraphic](https://docs.unity3d.com/ScriptReference/30_search.html?q=maskablegraphic)
-
-
 ## SVGPath

 > class in XUGL
@@ -3246,16 +3242,16 @@ UI组件基类。
 > class in XCharts.Runtime / Inherits from: [ChildComponent](#childcomponent)


+|public method|since|description|
+|--|--|--|
+|GetBackgroundColor()||public Color32 GetBackgroundColor(Background background)|
+
 ## UIHelper

 > class in XCharts.Runtime

 UI帮助类。

-|public method|since|description|
-|--|--|--|
-|GetBackgroundColor()||public static Color32 GetBackgroundColor(UIComponent component)|
-
 ## VisualMap

 > class in XCharts.Runtime / Inherits from: [MainComponent](#maincomponent)
--- a/Documentation~/en/configuration.md
+++ b/Documentation~/en/configuration.md
@@ -657,6 +657,8 @@ Background component.
 |image|||the image of background.
 |imageType|||the fill type of background image.
 |imageColor|||背景图颜色。
+|imageWidth|0|v3.10.0|the width of background image.
+|imageHeight|0|v3.10.0|the height of background image.
 |autoColor|true||Whether to use theme background color for component color when the background component is on.
 |borderStyle||v3.10.0|the border style of background. [BorderStyle](#borderstyle)|

--- a/Documentation~/zh/api.md
+++ b/Documentation~/zh/api.md
@@ -201,7 +201,6 @@ slug: /api
 - [StateStyle](#statestyle)
 - [SubTitleTheme](#subtitletheme)
 - [SVG](#svg)
- [SVGImage](#svgimage)
 - [SVGPath](#svgpath)
 - [SVGPathSeg](#svgpathseg)
 - [SymbolStyle](#symbolstyle)
@@ -1086,6 +1085,7 @@ slug: /api
 |SetActive()||public static void SetActive(Image image, bool active)|
 |SetActive()||public static void SetActive(Text text, bool active)|
 |SetActive()||public static void SetActive(Transform transform, bool active)<br/>通过设置scale实现是否显示，优化性能，减少GC |
+|SetBackground()||public static void SetBackground(Image background, Background imageStyle)|
 |SetBackground()||public static void SetBackground(Image background, ImageStyle imageStyle)|
 |SetColorOpacity()||public static void SetColorOpacity(ref Color32 color, float opacity)|

@@ -1856,6 +1856,7 @@ Drawing grid in rectangular coordinate. Line chart, bar chart, and scatter chart
 |--|--|--|
 |DefaultAreaLineChart()||public void DefaultAreaLineChart()<br/>默认面积折线图。 |
 |DefaultDashLineChart()||public void DefaultDashLineChart()<br/>默认虚线折线图。 |
+|DefaultLogLineChart()||public void DefaultLogLineChart()<br/>默认对数轴折线图。 |
 |DefaultSmoothAreaLineChart()||public void DefaultSmoothAreaLineChart()<br/>默认平滑面积折线图。 |
 |DefaultSmoothLineChart()||public void DefaultSmoothLineChart()<br/>默认平滑折线图。 |
 |DefaultStackAreaLineChart()||public void DefaultStackAreaLineChart()<br/>默认堆叠面积折线图。 |
@@ -2417,7 +2418,7 @@ Radar coordinate conponnet for radar charts. 雷达图坐标系组件，只适
 |CompareTo()||public int CompareTo(object obj)|
 |EnsureComponent()||public ISerieComponent EnsureComponent(Type type)|
 |EnsureComponent&lt;T&gt;()||public T EnsureComponent&lt;T&gt;() where T : ChildComponent, ISerieComponent<br/>确保系列有该组件。如果没有，则添加。 |
-|GetBarWidth()||public float GetBarWidth(float categoryWidth, int barCount = 0)|
+|GetBarWidth()||public float GetBarWidth(float categoryWidth, int barCount = 0, float defaultRate = 0.6f)|
 |GetComponent()||public ISerieComponent GetComponent(Type type)|
 |GetComponent&lt;T&gt;()||public T GetComponent&lt;T&gt;() where T : ChildComponent, ISerieComponent|
 |GetData()||public double GetData(int index, int dimension, DataZoom dataZoom = null)<br/>获得指定index指定维数的数据 |
@@ -2940,11 +2941,6 @@ Serie的状态样式。Serie的状态有正常，高亮，淡出，选中四种
 |DrawPath()||public static void DrawPath(VertexHelper vh, SVGPath path)|
 |Test()||public static void Test(VertexHelper vh)|

-## SVGImage
-
-> class in XCharts.Runtime / 继承自: [MaskableGraphic](https://docs.unity3d.com/ScriptReference/30_search.html?q=maskablegraphic)
-
-
 ## SVGPath

 > class in XUGL
@@ -3246,16 +3242,16 @@ UI组件基类。
 > class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)


+|API|版本|描述|
+|--|--|--|
+|GetBackgroundColor()||public Color32 GetBackgroundColor(Background background)|
+
 ## UIHelper

 > class in XCharts.Runtime

 UI帮助类。

-|API|版本|描述|
-|--|--|--|
-|GetBackgroundColor()||public static Color32 GetBackgroundColor(UIComponent component)|
-
 ## VisualMap

 > class in XCharts.Runtime / 继承自: [MainComponent](#maincomponent)
--- a/Documentation~/zh/configuration.md
+++ b/Documentation~/zh/configuration.md
@@ -640,6 +640,8 @@ import APITable from '@site/src/components/APITable';
 |image|||背景图。
 |imageType|||背景图填充类型。
 |imageColor|||背景图颜色。
+|imageWidth|0|v3.10.0|背景图宽度。
+|imageHeight|0|v3.10.0|背景图高度。
 |autoColor|true||当background组件开启时，是否自动使用主题背景色作为backgrounnd组件的颜色。当设置为false时，用imageColor作为颜色。
 |borderStyle||v3.10.0|背景边框样式。 [BorderStyle](#borderstyle)|

--- a/Editor/Windows/XChartsEditor.cs
+++ b/Editor/Windows/XChartsEditor.cs
@@ -162,15 +162,15 @@ namespace XCharts.Editor
            chart.DefaultMultipleRingChart();
        }

-        [MenuItem("XCharts/CandlestickChart", priority = 54)]
-        [MenuItem("GameObject/XCharts/CandlestickChart", priority = 54)]
+        [MenuItem("XCharts/CandlestickChart/Candlestick", priority = 54)]
+        [MenuItem("GameObject/XCharts/CandlestickChart/Candlestick", priority = 54)]
        public static void CandlestickChart()
        {
            AddChart<CandlestickChart>("CandlestickChart");
        }

-        [MenuItem("XCharts/ParallelChart", priority = 55)]
-        [MenuItem("GameObject/XCharts/ParallelChart", priority = 55)]
+        [MenuItem("XCharts/ParallelChart/Parallel", priority = 55)]
+        [MenuItem("GameObject/XCharts/ParallelChart/Parallel", priority = 55)]
        public static void ParallelChart()
        {
            AddChart<ParallelChart>("ParallelChart");
--- 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.9.0";
-        public static readonly int versionDate = 20231201;
+        public static readonly string version = "3.10.0";
+        public static readonly int versionDate = 20240125;
        public static string fullVersion { get { return version + "-" + versionDate; } }

        internal static List<BaseChart> chartList = new List<BaseChart>();
--- a/package.json
+++ b/package.json
@@ -3,9 +3,9 @@
  "displayName": "XCharts",
  "author": "monitor1394",
  "license": "MIT",
-  "version": "3.9.0",
-  "date": "20231201",
-  "checkdate": "20231201",
+  "version": "3.10.0",
+  "date": "20240125",
+  "checkdate": "20240125",
  "unity": "2018.3",
  "description": "A charting and data visualization library for Unity. Support line chart, bar chart, pie chart, radar chart, scatter chart, heatmap chart, ring chart, candlestick chart, polar chart and parallel coordinates.",
  "keywords": [