From cc6452f7ce7b5255e50d8b4436246fe22d2e5594 Mon Sep 17 00:00:00 2001 From: monitor1394 Date: Wed, 15 Jul 2020 09:11:35 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/xcharts-configuration-EN.md | 159 +++++++++++----------- Runtime/Component/Main/DataZoom.cs | 14 +- Runtime/Component/Main/Tooltip.cs | 9 ++ Runtime/Component/Main/Vessel.cs | 18 ++- Runtime/Component/Main/VisualMap.cs | 46 ++++++- 5 files changed, 159 insertions(+), 87 deletions(-) diff --git a/Documentation/xcharts-configuration-EN.md b/Documentation/xcharts-configuration-EN.md index cd1c00b9..a623242d 100644 --- a/Documentation/xcharts-configuration-EN.md +++ b/Documentation/xcharts-configuration-EN.md @@ -27,9 +27,9 @@ Main component: * [Serie-Liquid](#Serie-Liquid) * [Settings](#Settings) * [Theme](#Theme) +* [Title](#Title) * [Tooltip](#Tooltip) * [Vessel](#Vessel) -* [Title](#Title) * [VisualMap](#VisualMap) Sub component: @@ -104,7 +104,7 @@ Parameters: Sub component for serie title. * `show`: Whether to show serie title. -* `textStyle`: The text style of title. +* `textStyle`: The text style of title [TextStyle](#TextStyle). ## `Legend` @@ -227,99 +227,94 @@ Tooltip component. * `titleFormatter`: The string template formatter for the tooltip title content. Support for wrapping lines with `\n`. This is only valid if the `itemFormatter` is in effect. The placeholder `{I}` can be set separately to indicate that the title is ignored and not displayed. * `itemFormatter`: a string template formatter for a single Serie or data item content. Support for wrapping lines with `\n`. When `formatter` is not null, use `formatter` first, otherwise use `itemFormatter`. * `numericFormatter`: Standard numeric format string. Used to format numeric values to display as strings. Using 'Axx' form: 'A' is the single character of the format specifier, supporting 'C' currency, 'D' decimal, 'E' exponent, 'F' number of vertices, 'G' regular, 'N' digits, 'P' percentage, 'R' round tripping, 'X' hex etc. 'XX' is the precision specification, from '0' - '99'. see: -* `fixedWidth`: 固定宽度。当同时设置 `fixedWidth` 和 `minWidth` 时，`fixedWidth` 比 `minWidth` 优先级高。 -* `fixedHeight`: 固定高度。当同时设置 `fixedHeight` 和 `minHeight` 时，`fixedHeight` 比 `minHeight` 优先级高。 -* `minWidth`: 最小宽度。当同时设置 `fixedWidth` 和 `minWidth` 时，`fixedWidth` 比 `minWidth` 优先级高。 -* `minHeight`: 最小高度。当同时设置 f`ixedHeight` 和 `minHeight` 时，`fixedHeight` 比 `minHeight` 优先级高。 -* `paddingLeftRight`: 文字和边框的左右边距。 -* `paddingTopBottom`: 文字和边框的上下边距。 -* `backgroundImage`: 提示框的背景图。 -* `ignoreDataDefaultContent`: 被忽略数据的默认显示字符信息。 -* `alwayShow`: 是否触发后一直显示。 -* `offset`: `(since v1.5.3)`提示框相对于鼠标位置的偏移。 - -* `lineStyle`: 指示器线条样式 [LineStyle](#LineStyle)。 -* `textStyle`: 显示内容文本样式 [TextStyle](#TextStyle)。 +* `fixedWidth`: Fixed width. Higher priority than `minWidth`. +* `fixedHeight`: Fixed height. Higher priority than `minHeight`. +* `minWidth`: Minimum width. If `fixedWidth` has a value, get `fixedWidth` first. +* `minHeight`: Minimum height. If `fixedHeight` has a value, get `fixedHeight` first. +* `paddingLeftRight`: the text padding of left and right. [defaut: `5f`]. +* `paddingTopBottom`: the text padding of top and bottom. [defaut: `5f`]. +* `backgroundImage`: The image of icon. +* `ignoreDataDefaultContent`: The default display character information for ignored data. +* `alwayShow`: Whether to trigger after always display. +* `offset`: `(since v1.5.3)`The position offset of tooltip relative to the mouse position. +* `lineStyle`: the line style of indicator line [LineStyle](#LineStyle). +* `textStyle`: the text style of content [TextStyle](#TextStyle). ## `Vessel` -容器组件。一般用于LiquidChart。 +Vessel component for liquid chart. There can be multiple vessels in a Chart, which can be matched by vesselIndex in Serie. -相关参数: - -* `show`: 是否显示容器组件。 -* `shape`: 容器形状。 -* `shapeWidth`: 容器的厚度。 -* `gap`: 间隙。容器和液体的间隙。 -* `center`: 中心点。数组的第一项是横坐标，第二项是纵坐标。当值为0-1之间时表示百分比，设置成百分比时表示图表宽高最小值的百分比。 -* `radius`: 半径。 -* `smoothness`: 开启或关闭缩放区域功能。 -* `backgroundColor`: 背景色，默认透明。 -* `color`: 容器颜色。当`autoColor`为`false`时生效。 -* `autoColor`: 是否自动颜色。默认`true`。为`true`时颜色会和`serie`一致。 +* `show`: Whether to show the vessel. [defaut: `true`] +* `shape`: The shape of vessel. [default: `Shape.Circle`] +* `shapeWidth`: Thickness of vessel. [defaut: `5f`] +* `gap`: The gap between the vessel and the liquid. [defaut: `10f`] +* `center`: The center of vessel. The `center[0]` is the x-coordinate, and the `center[1]` is the y-coordinate. When value between `0` and `1` represents a percentage relative to the chart. [default: `[0.5f,0.45f]`] +* `radius`: The radius of vessel. When value between 0 and 1 represents a percentage relative to the chart. [default: `0.35f`] +* `smoothness`: The smoothness of wave. [default: `1f`] +* `backgroundColor`: Background color of polar, which is transparent by default. [default: `Color.clear`] +* `color`: Vessel color. The default is consistent with Serie. [default: `Color32(70, 70, 240, 255)`] +* `autoColor`: Whether automatic color. If true, the color matches serie. [default: `true`] ## `DataZoom` -区域缩放组件。用于区域缩放，从而能自由关注细节的数据信息，或者概览数据整体，或者去除离群点的影响。 -目前只支持控制 `X` 轴。 +DataZoom component is used for zooming a specific area, which enables user to investigate data in detail, or get an overview of the data, or get rid of outlier points. +Currently only the control 'X' axis is supported. -相关参数: - -* `enable`: 开启或关闭缩放区域功能。 -* `supportInside`: 是否支持内置缩放。内置于坐标系中，可在坐标系上通过鼠标拖拽、鼠标滚轮、手指滑动（触屏上）来缩放或漫游坐标系。 -* `supportSlider`: 是否支持滑动条缩放。有单独的滑动条，可在滑动条上进行缩放或漫游。 -* ~~`filterMode`: 数据过滤，暂未启用。支持以下几种类型: ~~ - * ~~`Filter`: 当前数据窗口外的数据，被 过滤掉。即 会 影响其他轴的数据范围。每个数据项，只要有一个维度在数据窗口外，整个数据项就会被过滤掉。~~ - * ~~`WeakFilter`: 当前数据窗口外的数据，被 过滤掉。即 会 影响其他轴的数据范围。每个数据项，只有当全部维度都在数据窗口同侧外部，整个数据项才会被过滤掉。~~ - * ~~`Empty`: 当前数据窗口外的数据，被 设置为空。即 不会 影响其他轴的数据范围。~~ - * ~~`None`: 不过滤数据，只改变数轴范围。~~ -* ~~`xAxisIndex`: 控制哪一个 `x` 轴。~~ -* ~~`yAxisIndex`: 控制哪一个 `y` 轴。~~ -* `showDataShadow`: 是否显示数据阴影。数据阴影可以简单地反应数据走势。 -* `showDetail`: 是否显示 `detail`，即拖拽时候显示详细数值信息。 -* `zoomLock`: 是否锁定选择区域（或叫做数据窗口）的大小。如果设置为 `true` 则锁定选择区域的大小，也就是说，只能平移，不能缩放。 -* ~~`realtime`: 拖动时，是否实时更新系列的视图。如果设置为 `false`，则只在拖拽结束的时候更新。~~ -* ~~`backgroundColor`: 组件的背景颜色。~~ -* `bottom`: 组件离容器下侧的距离。 -* `height`: 组件高度。 -* `rangeMode`: 取值类型是取绝对值还是百分比。 - * `Percent`: 百分比。 -* `start`: 数据窗口范围的起始百分比。范围是: 0 ~ 100。 -* `end`: 数据窗口范围的结束百分比。范围是: 0 ~ 100。 -* `scrollSensitivity`: 缩放区域组件的敏感度。值越高每次缩放所代表的数据越多。 -* `fontSize`: 字体大小。 -* `fontStyle`: 字体样式。 -* `minShowNum`: 最小显示数据个数。当DataZoom放大到最大时，最小显示的数据个数。 +* `enable`: Whether to show dataZoom. +* `supportInside`: Whether built-in support is supported. Built into the coordinate system to allow the user to zoom in and out of the coordinate system by mouse dragging, mouse wheel, finger swiping (on the touch screen). +* `supportSlider`: Whether a slider is supported. There are separate sliders on which the user zooms or roams. +* ~~`filterMode`: The mode of data filter, not support yet.~~ + * ~~`Filter`: data that outside the window will be filtered, which may lead to some changes of windows of other axes. For each data item, it will be filtered if one of the relevant dimensions is out of the window.~~ + * ~~`WeakFilter`: data that outside the window will be filtered, which may lead to some changes of windows of other axes. For each data item, it will be filtered only if all of the relevant dimensions are out of the same side of the window.~~ + * ~~`Empty`: data that outside the window will be set to NaN, which will not lead to changes of windows of other axes.~~ + * ~~`None`: Do not filter data.~~ +* ~~`xAxisIndex`: Specify which xAxis is controlled by the dataZoom.~~ +* ~~`yAxisIndex`: Specify which yAxis is controlled by the dataZoom.~~ +* `showDataShadow`: Whether to show data shadow, to indicate the data tendency in brief. [default: `true`] +* `showDetail`: Whether to show detail, that is, show the detailed data information when dragging. [default: `false`] +* `zoomLock`: Specify whether to lock the size of window (selected area). [default: `false`] +* ~~`realtime`: Whether to show data shadow in dataZoom-silder component, to indicate the data tendency in brief. [default: `true`]~~ +* ~~`backgroundColor`: The background color of the component.~~ +* `bottom`: Distance between dataZoom component and the bottom side of the container. bottom value is a instant pixel value like 10. [default: `10f`] +* `height`: The height of dataZoom component. height value is a instant pixel value like 10. [default: `50f`] +* `rangeMode`: Use absolute value or percent value in `DataZoom.start` and `DataZoom.end`. [default: `RangeMode.Percent`]. + * `Percent`: percent. +* `start`: The start percentage of the window out of the data extent, in the range of `0 ~ 100`. [default: `30f`] +* `end`: The end percentage of the window out of the data extent, in the range of 0 ~ 100. [default: `70f`] +* `scrollSensitivity`: The sensitivity of dataZoom scroll. The larger the number, the more sensitive it is. [default: `10f`] +* `fontSize`: font size of datazoom label. +* `fontStyle`: font style of datazoom label. +* `minShowNum`: Minimum number of display data. Minimum number of data displayed when DataZoom is enlarged to maximum. [default: `1`] ## `VisualMap` -视觉映射组件。用于进行『视觉编码』，也就是将数据映射到视觉元素（视觉通道）。 +VisualMap component. mapping data to visual elements such as colors. -* `enable`: 开启或关闭视觉映射功能。 -* `show`: 是否显示组件。如果设置为 `false`，不会显示，但是数据映射的功能还存在。 -* `type`: 组件类型。支持以下类型: - * `Continuous`: 连续型。 - * ~~`Piecewise`: 分段型。~~ -* ~~`selectedMode`: 分段型的选择模式，支持以下模式: ~~ - * ~~`Multiple`: 多选。~~ - * ~~`Single`: 单选。~~ -* `min`: 允许的最小值。'min' 必须用户指定。[visualMap.min, visualMap.max] 形成了视觉映射的『定义域』。 -* `max`: 允许的最大值。'max' 必须用户指定。[visualMap.min, visualMax.max] 形成了视觉映射的『定义域』。 -* `range`: 指定手柄对应数值的位置。range 应在 min max 范围内。 -* ~~`text`: 两端的文本，如 ['High', 'Low']。~~ -* ~~`textGap`: 两端文字主体之间的距离，单位为px。~~ -* `splitNumber`: 对于连续型数据，自动平均切分成几段，默认为0时自动匹配inRange颜色列表大小。 -* `calculable`: 是否显示拖拽用的手柄（手柄能拖拽调整选中范围）。 -* ~~`realtime`: 拖拽时，是否实时更新。~~ -* `itemWidth`: 图形的宽度，即颜色条的宽度。 -* `itemHeight`: 图形的高度，即颜色条的高度。 +* `enable`: Whether enable visualMap component. [default: false] +* `show`: Whether to display components. If set to false, it will not show up, but the data mapping function still exists. [default: true] +* `type`: the type of visualmap component. + * `Continuous`: Continuous. + * ~~`Piecewise`: Piecewise.~~ +* ~~`selectedMode`: the selected mode for Piecewise visualMap.~~ + * ~~`Multiple`: Multiple.~~ + * ~~`Single`: Single.~~ +* `min`: The minimum allowed. `min` must be user specified. `[min, max]` forms the domain of the visualMap. +* `max`: The maximum allowed. `max` must be user specified. `[min, max]` forms the domain of the visualMap. +* `range`: Specifies the position of the numeric value corresponding to the handle. Range should be within the range of [min,max]. +* ~~`text`: Text on both ends. such as ['High', 'Low'].~~ +* ~~`textGap`: The distance between the two text bodies.~~ +* `splitNumber`: For continuous data, it is automatically evenly divided into several segments and automatically matches the size of inRange color list when the default is 0. +* `calculable`: Whether the handle used for dragging is displayed (the handle can be dragged to adjust the selected range). +* ~~`realtime`: Whether to update in real time while dragging.~~ +* `itemWidth`: The width of the figure, that is, the width of the color bar. +* `itemHeight`: The height of the figure, that is, the height of the color bar. * `borderWidth`: 边框线宽，单位px。 -* `dimension`: 指定用数据的『哪个维度』，映射到视觉元素上。『数据』即 series.data。从1开始，默认为0取 data 中最后一个维度。 -* `hoverLink`: 打开 hoverLink 功能时，鼠标悬浮到 visualMap 组件上时，鼠标位置对应的数值 在 图表中对应的图形元素，会高亮。 -* `orient`: 布局方式是横还是竖。 -* `location`: 组件显示在图表中的位置。 -* `inRange`: 定义 在选中范围中 的视觉颜色。 -* ~~`outOfRange`: 定义 在选中范围外 的视觉颜色。~~ +* `dimension`: Specifies which `dimension` of the `Data` to map to the visual element. `Data` is series.data. Starting at 1, the default is 0 to take the last dimension in data. +* `hoverLink`: When the hoverLink function is turned on, when the mouse hovers over the visualMap component, the corresponding value of the mouse position is highlighted in the corresponding graphic element in the diagram. Conversely, when the mouse hovers over a graphic element in a diagram, the corresponding value of the visualMap component is triangulated in the corresponding position. +* `orient`: Is the layout horizontal or vertical. +* `location`: The location of component. +* `inRange`: Defines the visual color in the selected range. +* ~~`outOfRange`: Defines a visual color outside of the selected range.~~ ## `Grid` diff --git a/Runtime/Component/Main/DataZoom.cs b/Runtime/Component/Main/DataZoom.cs index 43fa6c3f..bfb259b6 100644 --- a/Runtime/Component/Main/DataZoom.cs +++ b/Runtime/Component/Main/DataZoom.cs @@ -14,6 +14,7 @@ namespace XCharts /// DataZoom component is used for zooming a specific area, /// which enables user to investigate data in detail, /// or get an overview of the data, or get rid of outlier points. + /// /// DataZoom 组件 用于区域缩放，从而能自由关注细节的数据信息，或者概览数据整体，或者去除离群点的影响。 /// [System.Serializable] @@ -23,6 +24,7 @@ namespace XCharts /// Generally dataZoom component zoom or roam coordinate system through data filtering /// and set the windows of axes internally. /// Its behaviours vary according to filtering mode settings. + /// /// dataZoom 的运行原理是通过 数据过滤 来达到 数据窗口缩放 的效果。数据过滤模式的设置不同，效果也不同。 /// public enum FilterMode @@ -30,17 +32,20 @@ namespace XCharts /// /// data that outside the window will be filtered, which may lead to some changes of windows of other axes. /// For each data item, it will be filtered if one of the relevant dimensions is out of the window. + /// /// 当前数据窗口外的数据，被 过滤掉。即 会 影响其他轴的数据范围。每个数据项，只要有一个维度在数据窗口外，整个数据项就会被过滤掉。 /// Filter, /// /// data that outside the window will be filtered, which may lead to some changes of windows of other axes. /// For each data item, it will be filtered only if all of the relevant dimensions are out of the same side of the window. + /// /// 当前数据窗口外的数据，被 过滤掉。即 会 影响其他轴的数据范围。每个数据项，只有当全部维度都在数据窗口同侧外部，整个数据项才会被过滤掉。 /// WeakFilter, /// /// data that outside the window will be set to NaN, which will not lead to changes of windows of other axes. + /// /// 当前数据窗口外的数据，被 设置为空。即 不会 影响其他轴的数据范围。 /// Empty, @@ -123,6 +128,10 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_YAxisIndex, value)) SetVerticesDirty(); } } /// + /// Whether built-in support is supported. + /// Built into the coordinate system to allow the user to zoom in and out of the coordinate system by mouse dragging, + /// mouse wheel, finger swiping (on the touch screen). + /// /// 是否支持内置。内置于坐标系中，使用户可以在坐标系上通过鼠标拖拽、鼠标滚轮、手指滑动（触屏上）来缩放或漫游坐标系。 /// public bool supportInside @@ -131,6 +140,7 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_SupportInside, value)) SetVerticesDirty(); } } /// + /// Whether a slider is supported. There are separate sliders on which the user zooms or roams. /// 是否支持滑动条。有单独的滑动条，用户在滑动条上进行缩放或漫游。 /// public bool supportSlider @@ -159,6 +169,7 @@ namespace XCharts /// /// Whether to show detail, that is, show the detailed data information when dragging. /// 是否显示detail，即拖拽时候显示详细数值信息。 + /// [default: false] /// public bool showDetail { @@ -225,7 +236,7 @@ namespace XCharts } /// /// The start percentage of the window out of the data extent, in the range of 0 ~ 100. - /// default:30 + /// [default:30]. /// 数据窗口范围的起始百分比。范围是：0 ~ 100。 /// public float start @@ -244,6 +255,7 @@ namespace XCharts set { m_End = value; if (m_End < 0) m_End = 0; if (m_End > 100) m_End = 100; SetVerticesDirty(); } } /// + /// Minimum number of display data. Minimum number of data displayed when DataZoom is enlarged to maximum. /// 最小显示数据个数。当DataZoom放大到最大时，最小显示的数据个数。 /// public int minShowNum diff --git a/Runtime/Component/Main/Tooltip.cs b/Runtime/Component/Main/Tooltip.cs index 45741588..7aab7490 100644 --- a/Runtime/Component/Main/Tooltip.cs +++ b/Runtime/Component/Main/Tooltip.cs @@ -140,18 +140,22 @@ namespace XCharts public string itemFormatter { get { return m_ItemFormatter; } set { m_ItemFormatter = value; } } /// + /// Fixed width. Higher priority than minWidth. /// 固定宽度。比 minWidth 优先。 /// public float fixedWidth { get { return m_FixedWidth; } set { m_FixedWidth = value; } } /// + /// Fixed height. Higher priority than minHeight. /// 固定高度。比 minHeight 优先。 /// public float fixedHeight { get { return m_FixedHeight; } set { m_FixedHeight = value; } } /// + /// Minimum width. If fixedWidth has a value, get fixedWidth first. /// 最小宽度。如若 fixedWidth 设有值，优先取 fixedWidth。 /// public float minWidth { get { return m_MinWidth; } set { m_MinWidth = value; } } /// + /// Minimum height. If fixedHeight has a value, take priority over fixedHeight. /// 最小高度。如若 fixedHeight 设有值，优先取 fixedHeight。 /// public float minHeight { get { return m_MinHeight; } set { m_MinHeight = value; } } @@ -185,6 +189,7 @@ namespace XCharts /// public float paddingTopBottom { get { return m_PaddingTopBottom; } set { m_PaddingTopBottom = value; } } /// + /// The default display character information for ignored data. /// 被忽略数据的默认显示字符信息。 /// public string ignoreDataDefaultContent { get { return m_IgnoreDataDefaultContent; } set { m_IgnoreDataDefaultContent = value; } } @@ -194,14 +199,17 @@ namespace XCharts /// public Sprite backgroundImage { get { return m_BackgroundImage; } set { m_BackgroundImage = value; SetBackground(m_BackgroundImage); } } /// + /// Whether to trigger after always display. /// 是否触发后一直显示。 /// public bool alwayShow { get { return m_AlwayShow; } set { m_AlwayShow = value; } } /// + /// The position offset of tooltip relative to the mouse position. /// 提示框相对于鼠标位置的偏移。 /// public Vector2 offset { get { return m_Offset; } set { m_Offset = value; } } /// + /// the text style of content. /// 提示框内容文本样式。 /// public TextStyle textStyle @@ -210,6 +218,7 @@ namespace XCharts set { if (value != null) { m_TextStyle = value; SetComponentDirty(); } } } /// + /// the line style of indicator line. /// 指示线样式。 /// public LineStyle lineStyle diff --git a/Runtime/Component/Main/Vessel.cs b/Runtime/Component/Main/Vessel.cs index f80f1b00..a0617bdd 100644 --- a/Runtime/Component/Main/Vessel.cs +++ b/Runtime/Component/Main/Vessel.cs @@ -11,10 +11,10 @@ using UnityEngine; namespace XCharts { /// - /// Vessel component for liquid chart. + /// Vessel component for liquid chart. There can be multiple vessels in a Chart, which can be matched by vesselIndex in Serie. /// /// 容器组件。 - /// 一般用于LiquidChart。可以有多个Vessel，Serie中用vesselIndex来对应。 + /// 一般用于LiquidChart。一个Chart中可以有多个Vessel，Serie中用vesselIndex来对应。 /// /// [Serializable] @@ -57,6 +57,7 @@ namespace XCharts /// /// Whether to show the vessel. /// 是否显示容器组件。 + /// [defaut: true] /// public bool show { @@ -66,6 +67,7 @@ namespace XCharts /// /// The shape of vessel. /// 容器形状。 + /// [default: Shape.Circle] /// public Shape shape { @@ -75,6 +77,7 @@ namespace XCharts /// /// Thickness of vessel. /// 容器厚度。 + /// [defaut: 5f] /// public float shapeWidth { @@ -84,6 +87,7 @@ namespace XCharts /// /// The gap between the vessel and the liquid. /// 间隙。容器和液体的间隙。 + /// [defaut: 10f] /// public float gap { @@ -91,8 +95,11 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Gap, value)) SetVerticesDirty(); } } /// + /// The center of vesselß. The center[0] is the x-coordinate, and the center[1] is the y-coordinate. + /// When value between 0 and 1 represents a percentage relative to the chart. /// 中心点。数组的第一项是横坐标，第二项是纵坐标。 /// 当值为0-1之间时表示百分比，设置成百分比时表示图表宽高最小值的百分比。 + /// [default:[0.5f,0.45f]] /// public float[] center { @@ -101,7 +108,9 @@ namespace XCharts } /// /// The radius of vessel. + /// When value between 0 and 1 represents a percentage relative to the chart. /// 半径。 + /// [default: 0.35f] /// public float radius { @@ -111,6 +120,7 @@ namespace XCharts /// /// The smoothness of wave. /// 水波平滑度。 + /// [default: 1f] /// public float smoothness { @@ -120,6 +130,7 @@ namespace XCharts /// /// Background color of polar, which is transparent by default. /// 背景色，默认透明。 + /// [default: `Color.clear`] /// public Color backgroundColor { @@ -127,6 +138,7 @@ namespace XCharts set { if (PropertyUtility.SetColor(ref m_BackgroundColor, value)) SetVerticesDirty(); } } /// + /// Vessel color. The default is consistent with Serie. /// 容器颜色。默认和serie一致。 /// public Color color @@ -135,7 +147,9 @@ namespace XCharts set { if (PropertyUtility.SetColor(ref m_Color, value)) SetVerticesDirty(); } } /// + /// Whether automatic color. If true, the color matches serie. /// 是否自动颜色。为true时颜色会和serie一致。 + /// [default: true] /// public bool autoColor { diff --git a/Runtime/Component/Main/VisualMap.cs b/Runtime/Component/Main/VisualMap.cs index 7504c40e..6a964941 100644 --- a/Runtime/Component/Main/VisualMap.cs +++ b/Runtime/Component/Main/VisualMap.cs @@ -11,7 +11,7 @@ using UnityEngine; namespace XCharts { /// - /// VisualMap component. + /// VisualMap component. Mapping data to visual elements such as colors. /// 视觉映射组件。用于进行『视觉编码』，也就是将数据映射到视觉元素（视觉通道）。 /// [System.Serializable] @@ -71,7 +71,11 @@ namespace XCharts [SerializeField] private List m_OutOfRange = new List(); /// + /// Whether enable visualMap component. + /// /// 是否开启组件功能。 + /// + /// [default: false] /// public bool enable { @@ -79,7 +83,11 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Enable, value)) SetVerticesDirty(); } } /// + /// Whether to display components. If set to false, it will not show up, but the data mapping function still exists. + /// /// 是否显示组件。如果设置为 false，不会显示，但是数据映射的功能还存在。 + /// + /// [default: true] /// public bool show { @@ -87,6 +95,7 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Enable, value)) SetVerticesDirty(); } } /// + /// the type of visualmap component. /// 组件类型。 /// public Type type @@ -95,6 +104,7 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Type, value)) SetVerticesDirty(); } } /// + /// the selected mode for Piecewise visualMap. /// 选择模式。 /// public SelectedMode selectedMode @@ -103,6 +113,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_SelectedMode, value)) SetVerticesDirty(); } } /// + /// The minimum allowed. 'min' must be user specified. [visualmap.min, visualmap.max] forms the "domain" of the visualMap. + /// /// 允许的最小值。'min' 必须用户指定。[visualMap.min, visualMap.max] 形成了视觉映射的『定义域』。 /// public float min @@ -111,6 +123,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Min, value)) SetVerticesDirty(); } } /// + /// The maximum allowed. 'max' must be user specified. [visualmap.min, visualmap.max] forms the "domain" of the visualMap. + /// /// 允许的最大值。'max' 必须用户指定。[visualMap.min, visualMax.max] 形成了视觉映射的『定义域』。 /// public float max @@ -119,18 +133,25 @@ namespace XCharts set { m_Max = value < min ? min + 1 : value; SetVerticesDirty(); } } /// - /// 指定手柄对应数值的位置。range 应在 min max 范围内。 + /// Specifies the position of the numeric value corresponding to the handle. Range should be within the range of [min,max]. + /// + /// 指定手柄对应数值的位置。range 应在[min,max]范围内。 /// public float[] range { get { return m_Range; } } /// + /// Text on both ends. /// 两端的文本，如 ['High', 'Low']。 /// public string[] text { get { return m_Text; } } /// + /// The distance between the two text bodies. /// 两端文字主体之间的距离，单位为px。 /// public float[] textGap { get { return m_TextGap; } } /// + /// For continuous data, it is automatically evenly divided into several segments + /// and automatically matches the size of inRange color list when the default is 0. + /// /// 对于连续型数据，自动平均切分成几段，默认为0时自动匹配inRange颜色列表大小。 /// /// @@ -140,6 +161,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_SplitNumber, value)) SetVerticesDirty(); } } /// + /// Whether the handle used for dragging is displayed (the handle can be dragged to adjust the selected range). + /// /// 是否显示拖拽用的手柄（手柄能拖拽调整选中范围）。 /// public bool calculable @@ -148,6 +171,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Calculable, value)) SetVerticesDirty(); } } /// + /// Whether to update in real time while dragging. + /// /// 拖拽时，是否实时更新。 /// public bool realtime @@ -156,6 +181,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Realtime, value)) SetVerticesDirty(); } } /// + /// The width of the figure, that is, the width of the color bar. + /// /// 图形的宽度，即颜色条的宽度。 /// public float itemWidth @@ -164,6 +191,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_ItemWidth, value)) SetVerticesDirty(); } } /// + /// The height of the figure, that is, the height of the color bar. + /// /// 图形的高度，即颜色条的高度。 /// public float itemHeight @@ -172,6 +201,8 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_ItemHeight, value)) SetVerticesDirty(); } } /// + /// Border line width. + /// /// 边框线宽，单位px。 /// public float borderWidth @@ -180,6 +211,9 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_BorderWidth, value)) SetVerticesDirty(); } } /// + /// Specifies "which dimension" of the data to map to the visual element. "Data" is series.data. + /// Starting at 1, the default is 0 to take the last dimension in data. + /// /// 指定用数据的『哪个维度』，映射到视觉元素上。『数据』即 series.data。从1开始，默认为0取 data 中最后一个维度。 /// public int dimension @@ -188,6 +222,11 @@ namespace XCharts set { if (PropertyUtility.SetStruct(ref m_Dimension, value)) SetVerticesDirty(); } } /// + /// When the hoverLink function is turned on, when the mouse hovers over the visualMap component, + /// the corresponding value of the mouse position is highlighted in the corresponding graphic element in the diagram. + /// Conversely, when the mouse hovers over a graphic element in a diagram, + /// the corresponding value of the visualMap component is triangulated in the corresponding position. + /// /// 打开 hoverLink 功能时，鼠标悬浮到 visualMap 组件上时，鼠标位置对应的数值 在 图表中对应的图形元素，会高亮。 /// 反之，鼠标悬浮到图表中的图形元素上时，在 visualMap 组件的相应位置会有三角提示其所对应的数值。 /// @@ -199,6 +238,7 @@ namespace XCharts } /// /// Specify whether the layout of component is horizontal or vertical. + /// /// 布局方式是横还是竖。 /// public Orient orient @@ -216,6 +256,7 @@ namespace XCharts set { if (PropertyUtility.SetClass(ref m_Location, value)) SetVerticesDirty(); } } /// + /// Defines the visual color in the selected range. /// 定义 在选中范围中 的视觉颜色。 /// public List inRange @@ -224,6 +265,7 @@ namespace XCharts set { if (value != null) { m_InRange = value; SetVerticesDirty(); } } } /// + /// Defines a visual color outside of the selected range. /// 定义 在选中范围外 的视觉颜色。 /// public List outOfRange