using System.Collections.Generic;
using UnityEngine;
namespace XCharts.Runtime
{
///
/// 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]
[ComponentHandler(typeof(DataZoomHandler), true)]
public class DataZoom : MainComponent, IUpdateRuntimeData
{
///
/// 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
{
///
/// 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,
///
/// Do not filter data.
/// |不过滤数据,只改变数轴范围。
///
None
}
///
/// The value type of start and end.取值类型
///
public enum RangeMode
{
//Value,
///
/// percent value.
/// |百分比。
///
Percent
}
[SerializeField] private bool m_Enable = true;
[SerializeField] private FilterMode m_FilterMode;
[SerializeField] private List m_XAxisIndexs = new List() { 0 };
[SerializeField] private List m_YAxisIndexs = new List() { };
[SerializeField] private bool m_SupportInside;
[SerializeField] private bool m_SupportInsideScroll = true;
[SerializeField] private bool m_SupportInsideDrag = true;
[SerializeField] private bool m_SupportSlider;
[SerializeField] private bool m_SupportSelect;
[SerializeField] private bool m_ShowDataShadow;
[SerializeField] private bool m_ShowDetail;
[SerializeField] private bool m_ZoomLock;
//[SerializeField] private bool m_Realtime;
[SerializeField] protected Color32 m_FillerColor;
[SerializeField] protected Color32 m_BorderColor;
[SerializeField] protected float m_BorderWidth;
[SerializeField] protected Color32 m_BackgroundColor;
[SerializeField] private float m_Left;
[SerializeField] private float m_Right;
[SerializeField] private float m_Top;
[SerializeField] private float m_Bottom;
[SerializeField] private RangeMode m_RangeMode;
[SerializeField] private float m_Start;
[SerializeField] private float m_End;
//[SerializeField] private float m_StartValue;
//[SerializeField] private float m_EndValue;
[SerializeField] private int m_MinShowNum = 1;
[Range(1f, 20f)]
[SerializeField] private float m_ScrollSensitivity = 1.1f;
[SerializeField] private Orient m_Orient = Orient.Horizonal;
[SerializeField] private LabelStyle m_LabelStyle = new LabelStyle();
[SerializeField] private LineStyle m_LineStyle = new LineStyle(LineStyle.Type.Solid);
[SerializeField] private AreaStyle m_AreaStyle = new AreaStyle();
public DataZoomContext context = new DataZoomContext();
///
/// Whether to show dataZoom.
/// |是否显示缩放区域。
///
public bool enable
{
get { return m_Enable; }
set { if (PropertyUtil.SetStruct(ref m_Enable, value)) SetVerticesDirty(); }
}
///
/// The mode of data filter.
/// |数据过滤类型。
///
public FilterMode filterMode
{
get { return m_FilterMode; }
set { if (PropertyUtil.SetStruct(ref m_FilterMode, value)) SetVerticesDirty(); }
}
///
/// Specify which xAxis is controlled by the dataZoom.
/// |控制的 x 轴索引列表。
///
public List xAxisIndexs
{
get { return m_XAxisIndexs; }
set { if (PropertyUtil.SetClass(ref m_XAxisIndexs, value)) SetVerticesDirty(); }
}
///
/// Specify which yAxis is controlled by the dataZoom.
/// |控制的 y 轴索引列表。
///
public List yAxisIndexs
{
get { return m_YAxisIndexs; }
set { if (PropertyUtil.SetClass(ref m_YAxisIndexs, 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
{
get { return m_SupportInside; }
set { if (PropertyUtil.SetStruct(ref m_SupportInside, value)) SetVerticesDirty(); }
}
///
/// 是否支持坐标系内滚动
///
public bool supportInsideScroll
{
get { return m_SupportInsideScroll; }
set { if (PropertyUtil.SetStruct(ref m_SupportInsideScroll, value)) SetVerticesDirty(); }
}
///
/// 是否支持坐标系内拖拽
///
public bool supportInsideDrag
{
get { return m_SupportInsideDrag; }
set { if (PropertyUtil.SetStruct(ref m_SupportInsideDrag, value)) SetVerticesDirty(); }
}
///
/// Whether a slider is supported. There are separate sliders on which the user zooms or roams.
/// |是否支持滑动条。有单独的滑动条,用户在滑动条上进行缩放或漫游。
///
public bool supportSlider
{
get { return m_SupportSlider; }
set { if (PropertyUtil.SetStruct(ref m_SupportSlider, value)) SetVerticesDirty(); }
}
///
/// 是否支持框选。提供一个选框进行数据区域缩放。
///
public bool supportSelect
{
get { return m_SupportSelect; }
set { if (PropertyUtil.SetStruct(ref m_SupportSelect, value)) SetVerticesDirty(); }
}
///
/// Whether to show data shadow, to indicate the data tendency in brief.
/// |是否显示数据阴影。数据阴影可以简单地反应数据走势。
///
public bool showDataShadow
{
get { return m_ShowDataShadow; }
set { if (PropertyUtil.SetStruct(ref m_ShowDataShadow, value)) SetVerticesDirty(); }
}
///
/// Whether to show detail, that is, show the detailed data information when dragging.
/// |是否显示detail,即拖拽时候显示详细数值信息。
///
public bool showDetail
{
get { return m_ShowDetail; }
set { if (PropertyUtil.SetStruct(ref m_ShowDetail, value)) SetVerticesDirty(); }
}
///
/// Specify whether to lock the size of window (selected area).
/// |是否锁定选择区域(或叫做数据窗口)的大小。
/// 如果设置为 true 则锁定选择区域的大小,也就是说,只能平移,不能缩放。
///
public bool zoomLock
{
get { return m_ZoomLock; }
set { if (PropertyUtil.SetStruct(ref m_ZoomLock, value)) SetVerticesDirty(); }
}
///
/// Whether to show data shadow in dataZoom-silder component, to indicate the data tendency in brief.
/// |拖动时,是否实时更新系列的视图。如果设置为 false,则只在拖拽结束的时候更新。默认为true,暂不支持修改。
///
public bool realtime { get { return true; } }
///
/// The background color of the component.
/// |组件的背景颜色。
///
public Color backgroundColor
{
get { return m_BackgroundColor; }
set { if (PropertyUtil.SetStruct(ref m_BackgroundColor, value)) SetVerticesDirty(); }
}
///
/// the color of dataZoom data area.
/// |数据区域颜色。
///
public Color32 fillerColor
{
get { return m_FillerColor; }
set { if (PropertyUtil.SetColor(ref m_FillerColor, value)) SetVerticesDirty(); }
}
///
/// the color of dataZoom border.
/// |边框颜色。
///
public Color32 borderColor
{
get { return m_BorderColor; }
set { if (PropertyUtil.SetColor(ref m_BorderColor, value)) SetComponentDirty(); }
}
///
/// 边框宽。
///
public float borderWidth
{
get { return m_BorderWidth; }
set { if (PropertyUtil.SetStruct(ref m_BorderWidth, value)) SetComponentDirty(); }
}
///
/// Distance between dataZoom component and the bottom side of the container.
/// bottom value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器下侧的距离。
///
public float bottom
{
get { return m_Bottom; }
set { if (PropertyUtil.SetStruct(ref m_Bottom, value)) SetVerticesDirty(); }
}
///
/// Distance between dataZoom component and the top side of the container.
/// top value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器上侧的距离。
///
public float top
{
get { return m_Top; }
set { if (PropertyUtil.SetStruct(ref m_Top, value)) SetVerticesDirty(); }
}
///
/// Distance between dataZoom component and the left side of the container.
/// left value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器左侧的距离。
///
public float left
{
get { return m_Left; }
set { if (PropertyUtil.SetStruct(ref m_Left, value)) SetVerticesDirty(); }
}
///
/// Distance between dataZoom component and the right side of the container.
/// right value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器右侧的距离。
///
public float right
{
get { return m_Right; }
set { if (PropertyUtil.SetStruct(ref m_Right, value)) SetVerticesDirty(); }
}
///
/// Use absolute value or percent value in DataZoom.start and DataZoom.end.
/// |取绝对值还是百分比。
///
public RangeMode rangeMode
{
get { return m_RangeMode; }
set { if (PropertyUtil.SetStruct(ref m_RangeMode, value)) SetVerticesDirty(); }
}
///
/// The start percentage of the window out of the data extent, in the range of 0 ~ 100.
/// |数据窗口范围的起始百分比。范围是:0 ~ 100。
///
public float start
{
get { return m_Start; }
set { m_Start = value; if (m_Start < 0) m_Start = 0; if (m_Start > 100) m_Start = 100; SetVerticesDirty(); }
}
///
/// The end percentage of the window out of the data extent, in the range of 0 ~ 100.
/// |数据窗口范围的结束百分比。范围是:0 ~ 100。
///
public float end
{
get { return m_End; }
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
{
get { return m_MinShowNum; }
set { if (PropertyUtil.SetStruct(ref m_MinShowNum, value)) SetVerticesDirty(); }
}
///
/// The sensitivity of dataZoom scroll.
/// The larger the number, the more sensitive it is.
/// |缩放区域组件的敏感度。值越高每次缩放所代表的数据越多。
///
public float scrollSensitivity
{
get { return m_ScrollSensitivity; }
set { if (PropertyUtil.SetStruct(ref m_ScrollSensitivity, value)) SetVerticesDirty(); }
}
///
/// Specify whether the layout of dataZoom component is horizontal or vertical. What's more,
/// it indicates whether the horizontal axis or vertical axis is controlled by default in catesian coordinate system.
/// |布局方式是横还是竖。不仅是布局方式,对于直角坐标系而言,也决定了,缺省情况控制横向数轴还是纵向数轴。
///
public Orient orient
{
get { return m_Orient; }
set { if (PropertyUtil.SetStruct(ref m_Orient, value)) SetVerticesDirty(); }
}
///
/// label style.
/// |文本标签格式。
///
public LabelStyle labelStyle
{
get { return m_LabelStyle; }
set { if (PropertyUtil.SetClass(ref m_LabelStyle, value)) SetComponentDirty(); }
}
///
/// 阴影线条样式。
///
public LineStyle lineStyle
{
get { return m_LineStyle; }
set { if (PropertyUtil.SetClass(ref m_LineStyle, value)) SetComponentDirty(); }
}
///
/// 阴影填充样式。
///
public AreaStyle areaStyle
{
get { return m_AreaStyle; }
set { if (PropertyUtil.SetClass(ref m_AreaStyle, value)) SetComponentDirty(); }
}
class AxisIndexValueInfo
{
public double min;
public double max;
}
private Dictionary m_XAxisIndexInfos = new Dictionary();
private Dictionary m_YAxisIndexInfos = new Dictionary();
///
/// The start label.
/// |组件的开始信息文本。
///
private ChartLabel m_StartLabel { get; set; }
///
/// The end label.
/// |组件的结束信息文本。
///
private ChartLabel m_EndLabel { get; set; }
public override void SetDefaultValue()
{
supportInside = true;
supportSlider = true;
filterMode = FilterMode.None;
xAxisIndexs = new List() { 0 };
yAxisIndexs = new List() { };
showDataShadow = true;
showDetail = false;
zoomLock = false;
m_Bottom = 10;
m_Left = 10;
m_Right = 10;
m_Top = 0.9f;
rangeMode = RangeMode.Percent;
start = 30;
end = 70;
m_Orient = Orient.Horizonal;
m_ScrollSensitivity = 10;
m_LabelStyle = new LabelStyle();
m_LineStyle = new LineStyle(LineStyle.Type.Solid)
{
opacity = 0.3f
};
m_AreaStyle = new AreaStyle()
{
show = true,
opacity = 0.3f
};
}
///
/// 给定的坐标是否在缩放区域内
///
///
///
///
///
public bool IsInZoom(Vector2 pos)
{
if (pos.x < context.x - 1 || pos.x > context.x + context.width + 1 ||
pos.y < context.y - 1 || pos.y > context.y + context.height + 1)
{
return false;
}
return true;
}
///
/// 给定的坐标是否在选中区域内
///
///
///
public bool IsInSelectedZoom(Vector2 pos)
{
switch (m_Orient)
{
case Orient.Horizonal:
var start = context.x + context.width * m_Start / 100;
var end = context.x + context.width * m_End / 100;
return ChartHelper.IsInRect(pos, start, end, context.y, context.y + context.height);
case Orient.Vertical:
start = context.y + context.height * m_Start / 100;
end = context.y + context.height * m_End / 100;
return ChartHelper.IsInRect(pos, context.x, context.x + context.width, start, end);
default:
return false;
}
}
public bool IsInSelectedZoom(int totalIndex, int index, bool invert)
{
if (totalIndex <= 0)
return false;
var tstart = invert ? 100 - end : start;
var tend = invert ? 100 - start : end;
var range = Mathf.RoundToInt(totalIndex * (tend - tstart) / 100);
var min = Mathf.FloorToInt(totalIndex * tstart / 100);
var max = Mathf.CeilToInt(totalIndex * tend / 100);
if (min == 0) max = min + range;
if (max == totalIndex) min = max - range;
var flag = index >= min && index < min + range;
return flag;
}
///
/// 给定的坐标是否在开始活动条触发区域内
///
///
///
///
///
public bool IsInStartZoom(Vector2 pos)
{
switch (m_Orient)
{
case Orient.Horizonal:
var start = context.x + context.width * m_Start / 100;
return ChartHelper.IsInRect(pos, start - 10, start + 10, context.y, context.y + context.height);
case Orient.Vertical:
start = context.y + context.height * m_Start / 100;
return ChartHelper.IsInRect(pos, context.x, context.x + context.width, start - 10, start + 10);
default:
return false;
}
}
///
/// 给定的坐标是否在结束活动条触发区域内
///
///
///
///
///
public bool IsInEndZoom(Vector2 pos)
{
switch (m_Orient)
{
case Orient.Horizonal:
var end = context.x + context.width * m_End / 100;
return ChartHelper.IsInRect(pos, end - 10, end + 10, context.y, context.y + context.height);
case Orient.Vertical:
end = context.y + context.height * m_End / 100;
return ChartHelper.IsInRect(pos, context.x, context.x + context.width, end - 10, end + 10);
default:
return false;
}
}
public bool IsContainsAxis(Axis axis)
{
if (axis == null)
return false;
else if (axis is XAxis)
return xAxisIndexs.Contains(axis.index);
else if (axis is YAxis)
return yAxisIndexs.Contains(axis.index);
else
return false;
}
public bool IsContainsXAxis(int index)
{
return xAxisIndexs != null && xAxisIndexs.Contains(index);
}
public bool IsContainsYAxis(int index)
{
return yAxisIndexs != null && yAxisIndexs.Contains(index);
}
public Color32 GetFillerColor(Color32 themeColor)
{
if (ChartHelper.IsClearColor(fillerColor))
return themeColor;
else
return fillerColor;
}
public Color32 GetBackgroundColor(Color32 themeColor)
{
if (ChartHelper.IsClearColor(backgroundColor))
return themeColor;
else
return backgroundColor;
}
public Color32 GetBorderColor(Color32 themeColor)
{
if (ChartHelper.IsClearColor(borderColor))
return themeColor;
else
return borderColor;
}
///
/// 是否显示文本
///
///
internal void SetLabelActive(bool flag)
{
m_StartLabel.SetActive(flag);
m_EndLabel.SetActive(flag);
}
///
/// 设置开始文本内容
///
///
internal void SetStartLabelText(string text)
{
if (m_StartLabel != null) m_StartLabel.SetText(text);
}
///
/// 设置结束文本内容
///
///
internal void SetEndLabelText(string text)
{
if (m_EndLabel != null) m_EndLabel.SetText(text);
}
internal void SetStartLabel(ChartLabel startLabel)
{
m_StartLabel = startLabel;
}
internal void SetEndLabel(ChartLabel endLabel)
{
m_EndLabel = endLabel;
}
internal void UpdateStartLabelPosition(Vector3 pos)
{
m_StartLabel.SetPosition(pos);
}
internal void UpdateEndLabelPosition(Vector3 pos)
{
m_EndLabel.SetPosition(pos);
}
public void UpdateRuntimeData(float chartX, float chartY, float chartWidth, float chartHeight)
{
var runtimeLeft = left <= 1 ? left * chartWidth : left;
var runtimeBottom = bottom <= 1 ? bottom * chartHeight : bottom;
var runtimeTop = top <= 1 ? top * chartHeight : top;
var runtimeRight = right <= 1 ? right * chartWidth : right;
context.x = chartX + runtimeLeft;
context.y = chartY + runtimeBottom;
context.width = chartWidth - runtimeLeft - runtimeRight;
context.height = chartHeight - runtimeTop - runtimeBottom;
}
internal void SetXAxisIndexValueInfo(int xAxisIndex, double min, double max)
{
if (!m_XAxisIndexInfos.ContainsKey(xAxisIndex))
{
m_XAxisIndexInfos[xAxisIndex] = new AxisIndexValueInfo()
{
min = min,
max = max
};
}
else
{
m_XAxisIndexInfos[xAxisIndex].min = min;
m_XAxisIndexInfos[xAxisIndex].max = max;
}
}
internal void SetYAxisIndexValueInfo(int yAxisIndex, double min, double max)
{
if (!m_YAxisIndexInfos.ContainsKey(yAxisIndex))
{
m_YAxisIndexInfos[yAxisIndex] = new AxisIndexValueInfo()
{
min = min,
max = max
};
}
else
{
m_YAxisIndexInfos[yAxisIndex].min = min;
m_YAxisIndexInfos[yAxisIndex].max = max;
}
}
internal bool IsXAxisIndexValue(int axisIndex)
{
return m_XAxisIndexInfos.ContainsKey(axisIndex);
}
internal bool IsYAxisIndexValue(int axisIndex)
{
return m_YAxisIndexInfos.ContainsKey(axisIndex);
}
internal void GetXAxisIndexValue(int axisIndex, out double min, out double max)
{
min = 0;
max = 0;
if (m_XAxisIndexInfos.ContainsKey(axisIndex))
{
var info = m_XAxisIndexInfos[axisIndex];
min = info.min;
max = info.max;
}
}
internal void GetYAxisIndexValue(int axisIndex, out double min, out double max)
{
min = 0;
max = 0;
if (m_YAxisIndexInfos.ContainsKey(axisIndex))
{
var info = m_YAxisIndexInfos[axisIndex];
min = info.min;
max = info.max;
}
}
}
}