[code] add comment

This commit is contained in:
monitor1394
2022-07-04 08:30:43 +08:00
parent 197402dcb7
commit f5c2e73098
9 changed files with 75 additions and 24 deletions

View File

@@ -19,12 +19,12 @@ namespace XCharts.Runtime
{ {
/// <summary> /// <summary>
/// Numerical axis, suitable for continuous data. /// Numerical axis, suitable for continuous data.
/// ||数值轴。适用于连续数据。 /// |数值轴。适用于连续数据。
/// </summary> /// </summary>
Value, Value,
/// <summary> /// <summary>
/// Category axis, suitable for discrete category data. Data should only be set via data for this type. /// Category axis, suitable for discrete category data. Data should only be set via data for this type.
/// ||类目轴。适用于离散的类目数据,为该类型时必须通过 data 设置类目数据。 /// |类目轴。适用于离散的类目数据,为该类型时必须通过 data 设置类目数据。serie的数据第0维数据对应坐标轴data的index。
/// </summary> /// </summary>
Category, Category,
/// <summary> /// <summary>
@@ -74,12 +74,12 @@ namespace XCharts.Runtime
} }
[SerializeField] protected bool m_Show = true; [SerializeField] protected bool m_Show = true;
[SerializeField] protected AxisType m_Type; [SerializeField] protected Axis.AxisType m_Type;
[SerializeField] protected AxisMinMaxType m_MinMaxType; [SerializeField] protected Axis.AxisMinMaxType m_MinMaxType;
[SerializeField] protected int m_GridIndex; [SerializeField] protected int m_GridIndex;
[SerializeField] protected int m_PolarIndex; [SerializeField] protected int m_PolarIndex;
[SerializeField] protected int m_ParallelIndex; [SerializeField] protected int m_ParallelIndex;
[SerializeField] protected AxisPosition m_Position; [SerializeField] protected Axis.AxisPosition m_Position;
[SerializeField] protected float m_Offset; [SerializeField] protected float m_Offset;
[SerializeField] protected double m_Min; [SerializeField] protected double m_Min;
[SerializeField] protected double m_Max; [SerializeField] protected double m_Max;

View File

@@ -33,7 +33,7 @@ namespace XCharts.Runtime
} }
[SerializeField] private bool m_Show = true; [SerializeField] private bool m_Show = true;
[SerializeField] private AreaOrigin m_Origin; [SerializeField] private AreaStyle.AreaOrigin m_Origin;
[SerializeField] private Color32 m_Color; [SerializeField] private Color32 m_Color;
[SerializeField] private Color32 m_ToColor; [SerializeField] private Color32 m_ToColor;
[SerializeField][Range(0, 1)] private float m_Opacity = 0.6f; [SerializeField][Range(0, 1)] private float m_Opacity = 0.6f;

View File

@@ -22,6 +22,10 @@ namespace XCharts.Runtime
/// |是否显示注解组件。 /// |是否显示注解组件。
/// </summary> /// </summary>
public bool show { get { return m_Show; } set { if (PropertyUtil.SetStruct(ref m_Show, value)) SetComponentDirty(); } } public bool show { get { return m_Show; } set { if (PropertyUtil.SetStruct(ref m_Show, value)) SetComponentDirty(); } }
/// <summary>
/// The items of comment.
/// |注解项。每个注解组件可以设置多个注解项。
/// </summary>
public List<CommentItem> items { get { return m_Items; } set { m_Items = value; SetComponentDirty(); } } public List<CommentItem> items { get { return m_Items; } set { m_Items = value; SetComponentDirty(); } }
/// <summary> /// <summary>
/// The text style of all comments. /// The text style of all comments.

View File

@@ -40,10 +40,35 @@ namespace XCharts.Runtime
private ChartLabel m_Label; private ChartLabel m_Label;
private List<float> m_FpsList = new List<float>(); private List<float> m_FpsList = new List<float>();
/// <summary>
/// Whether show debug component.
/// |是否显示Debug组件。
/// </summary>
public bool show { get { return m_Show; } set { m_Show = value; } }
/// <summary>
/// Whether show children components of chart in hierarchy view.
/// |是否在Hierarchy试图显示所有chart下的节点。
/// </summary>
public bool showAllChartObject { get { return m_ShowAllChartObject; } set { m_ShowAllChartObject = value; } } public bool showAllChartObject { get { return m_ShowAllChartObject; } set { m_ShowAllChartObject = value; } }
/// <summary>
/// Whether to fold series in inspector view.
/// |是否在Inspector上折叠Serie。
/// </summary>
public bool foldSeries { get { return m_FoldSeries; } set { m_FoldSeries = value; } } public bool foldSeries { get { return m_FoldSeries; } set { m_FoldSeries = value; } }
/// <summary>
/// frame rate.
/// |当前帧率。
/// </summary>
public float fps { get; private set; } public float fps { get; private set; }
/// <summary>
/// The average frame rate.
/// |平均帧率。
/// </summary>
public float avgFps { get; private set; } public float avgFps { get; private set; }
/// <summary>
/// The fefresh count of chart per second.
/// |图表每秒刷新次数。
/// </summary>
public int refreshCount { get; internal set; } public int refreshCount { get; internal set; }
internal int clickChartCount { get; set; } internal int clickChartCount { get; set; }

View File

@@ -97,7 +97,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Type of legend. /// Type of legend.
/// |图例类型。 /// |图例类型。
/// [default:Type.Auto]
/// </summary> /// </summary>
public Type iconType public Type iconType
{ {
@@ -107,7 +106,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Selected mode of legend, which controls whether series can be toggled displaying by clicking legends. /// Selected mode of legend, which controls whether series can be toggled displaying by clicking legends.
/// |选择模式。控制是否可以通过点击图例改变系列的显示状态。默认开启图例选择,可以设成 None 关闭。 /// |选择模式。控制是否可以通过点击图例改变系列的显示状态。默认开启图例选择,可以设成 None 关闭。
/// [default:SelectedMode.Multiple]
/// </summary> /// </summary>
public SelectedMode selectedMode public SelectedMode selectedMode
{ {
@@ -117,7 +115,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Specify whether the layout of legend component is horizontal or vertical. /// Specify whether the layout of legend component is horizontal or vertical.
/// |布局方式是横还是竖。 /// |布局方式是横还是竖。
/// [default:Orient.Horizonal]
/// </summary> /// </summary>
public Orient orient public Orient orient
{ {
@@ -127,7 +124,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// The location of legend. /// The location of legend.
/// |图例显示的位置。 /// |图例显示的位置。
/// [default:Location.defaultTop]
/// </summary> /// </summary>
public Location location public Location location
{ {
@@ -137,7 +133,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Image width of legend symbol. /// Image width of legend symbol.
/// |图例标记的图形宽度。 /// |图例标记的图形宽度。
/// [default:24f]
/// </summary> /// </summary>
public float itemWidth public float itemWidth
{ {
@@ -147,7 +142,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Image height of legend symbol. /// Image height of legend symbol.
/// |图例标记的图形高度。 /// |图例标记的图形高度。
/// [default:12f]
/// </summary> /// </summary>
public float itemHeight public float itemHeight
{ {
@@ -157,7 +151,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// The distance between each legend, horizontal distance in horizontal layout, and vertical distance in vertical layout. /// The distance between each legend, horizontal distance in horizontal layout, and vertical distance in vertical layout.
/// |图例每项之间的间隔。横向布局时为水平间隔,纵向布局时为纵向间隔。 /// |图例每项之间的间隔。横向布局时为水平间隔,纵向布局时为纵向间隔。
/// [default:10f]
/// </summary> /// </summary>
public float itemGap public float itemGap
{ {
@@ -167,7 +160,6 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Whether the legend symbol matches the color automatically. /// Whether the legend symbol matches the color automatically.
/// |图例标记的图形是否自动匹配颜色。 /// |图例标记的图形是否自动匹配颜色。
/// [default:true]
/// </summary> /// </summary>
public bool itemAutoColor public bool itemAutoColor
{ {
@@ -189,7 +181,6 @@ namespace XCharts.Runtime
/// 使用Axx的形式A是格式说明符的单字符支持C货币、D十进制、E指数、F定点数、G常规、N数字、P百分比、R往返、X十六进制的。xx是精度说明从0-99。 /// 使用Axx的形式A是格式说明符的单字符支持C货币、D十进制、E指数、F定点数、G常规、N数字、P百分比、R往返、X十六进制的。xx是精度说明从0-99。
/// 参考https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/standard-numeric-format-strings /// 参考https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/standard-numeric-format-strings
/// </summary> /// </summary>
/// <value></value>
public string numericFormatter public string numericFormatter
{ {
get { return m_NumericFormatter; } get { return m_NumericFormatter; }
@@ -235,7 +226,7 @@ namespace XCharts.Runtime
/// <summary> /// <summary>
/// Data array of legend. An array item is usually a name representing string. (If it is a pie chart, /// Data array of legend. An array item is usually a name representing string. (If it is a pie chart,
/// it could also be the name of a single data in the pie chart) of a series. /// it could also be the name of a single data in the pie chart) of a series.
/// |If data is not specified, it will be auto collected from series. /// If data is not specified, it will be auto collected from series.
/// |图例的数据数组。数组项通常为一个字符串,每一项代表一个系列的 name如果是饼图也可以是饼图单个数据的 name /// |图例的数据数组。数组项通常为一个字符串,每一项代表一个系列的 name如果是饼图也可以是饼图单个数据的 name
/// 如果 data 没有被指定会自动从当前系列中获取。指定data时里面的数据项和serie匹配时才会生效。 /// 如果 data 没有被指定会自动从当前系列中获取。指定data时里面的数据项和serie匹配时才会生效。
/// </summary> /// </summary>
@@ -254,7 +245,7 @@ namespace XCharts.Runtime
} }
/// <summary> /// <summary>
/// the colors of legend item. /// the colors of legend item.
/// 图例标记的颜色列表。 /// |图例标记的颜色列表。
/// </summary> /// </summary>
public List<Color> colors public List<Color> colors
{ {

View File

@@ -55,7 +55,7 @@ namespace XCharts.Runtime
/// The name of indicator. /// The name of indicator.
/// |指示器名称。 /// |指示器名称。
/// </summary> /// </summary>
public string name { get { return FormatterHelper.TrimAndReplaceLine(m_Name); } set { m_Name = value; } } public string name { get { return m_Name; } set { m_Name = value; } }
/// <summary> /// <summary>
/// The maximum value of indicator, with default value of 0, but we recommend to set it manually. /// The maximum value of indicator, with default value of 0, but we recommend to set it manually.
/// |指示器的最大值,默认为 0 无限制。 /// |指示器的最大值,默认为 0 无限制。

View File

@@ -122,7 +122,10 @@ namespace XCharts.Runtime
get { return m_TickColor; } get { return m_TickColor; }
set { if (PropertyUtil.SetColor(ref m_TickColor, value)) SetVerticesDirty(); } set { if (PropertyUtil.SetColor(ref m_TickColor, value)) SetVerticesDirty(); }
} }
/// <summary>
/// the colors of split area.
/// |坐标轴分隔区域的颜色。
/// </summary>
public List<Color32> splitAreaColors public List<Color32> splitAreaColors
{ {
get { return m_SplitAreaColors; } get { return m_SplitAreaColors; }

View File

@@ -27,18 +27,38 @@ namespace XCharts.Runtime
get { return m_LineWidth; } get { return m_LineWidth; }
set { if (PropertyUtil.SetStruct(ref m_LineWidth, value)) SetVerticesDirty(); } set { if (PropertyUtil.SetStruct(ref m_LineWidth, value)) SetVerticesDirty(); }
} }
/// <summary>
/// the symbol size of line serie.
/// |折线图的Symbol大小。
/// </summary>
public float lineSymbolSize public float lineSymbolSize
{ {
get { return m_LineSymbolSize; } get { return m_LineSymbolSize; }
set { if (PropertyUtil.SetStruct(ref m_LineSymbolSize, value)) SetVerticesDirty(); } set { if (PropertyUtil.SetStruct(ref m_LineSymbolSize, value)) SetVerticesDirty(); }
} }
/// <summary>
/// the selected symbol size of line serie.
/// |折线图Symbol在被选中状态时的大小。
/// </summary>
public float lineSymbolSelectedSize { get { return lineSymbolSize * selectedRate; } } public float lineSymbolSelectedSize { get { return lineSymbolSize * selectedRate; } }
/// <summary>
/// the symbol size of scatter serie.
/// |散点图的Symbol大小。
/// </summary>
public float scatterSymbolSize public float scatterSymbolSize
{ {
get { return m_ScatterSymbolSize; } get { return m_ScatterSymbolSize; }
set { if (PropertyUtil.SetStruct(ref m_ScatterSymbolSize, value)) SetVerticesDirty(); } set { if (PropertyUtil.SetStruct(ref m_ScatterSymbolSize, value)) SetVerticesDirty(); }
} }
/// <summary>
/// the selected symbol size of scatter serie.
/// |散点图的Symbol在被选中状态时的大小。
/// </summary>
public float scatterSymbolSelectedSize { get { return scatterSymbolSize * selectedRate; } } public float scatterSymbolSelectedSize { get { return scatterSymbolSize * selectedRate; } }
/// <summary>
/// the rate of symbol size of line or scatter serie.
/// |折线图或散点图在被选中时的放大倍数。
/// </summary>
public float selectedRate public float selectedRate
{ {
get { return m_SelectedRate; } get { return m_SelectedRate; }
@@ -46,7 +66,8 @@ namespace XCharts.Runtime
} }
/// <summary> /// <summary>
/// 饼图鼠标移到高亮时的额外半径 /// the extra radius of pie when actived by tooltip.
/// |饼图鼠标移到高亮时的额外半径
/// </summary> /// </summary>
public float pieTooltipExtraRadius public float pieTooltipExtraRadius
{ {
@@ -54,7 +75,8 @@ namespace XCharts.Runtime
set { if (PropertyUtil.SetStruct(ref m_PieTooltipExtraRadius, value < 0 ? 0f : value)) SetVerticesDirty(); } set { if (PropertyUtil.SetStruct(ref m_PieTooltipExtraRadius, value < 0 ? 0f : value)) SetVerticesDirty(); }
} }
/// <summary> /// <summary>
/// 饼图选中时的中心点偏移 /// the center offset of pie if selected.
/// |饼图选中时的中心点偏移。
/// </summary> /// </summary>
public float pieSelectedOffset public float pieSelectedOffset
{ {

View File

@@ -58,17 +58,23 @@ namespace XCharts.Runtime
{ {
get { return sharedTheme.themeType; } get { return sharedTheme.themeType; }
} }
/// <summary>
/// theme name.
/// |主题名字。
/// </summary>
public string themeName public string themeName
{ {
get { return sharedTheme.themeName; } get { return sharedTheme.themeName; }
} }
/// <summary>
/// the asset of theme.
/// |主题配置。
/// </summary>
public Theme sharedTheme public Theme sharedTheme
{ {
get { return m_SharedTheme; } get { return m_SharedTheme; }
set { m_SharedTheme = value; SetAllDirty(); } set { m_SharedTheme = value; SetAllDirty(); }
} }
/// <summary> /// <summary>
/// the contrast color of chart. /// the contrast color of chart.
/// |对比色。 /// |对比色。
@@ -91,7 +97,7 @@ namespace XCharts.Runtime
} }
/// <summary> /// <summary>
/// Whether the background color is transparent. When true, the background color is not drawn. /// Whether the background color is transparent. When true, the background color is not drawn.
/// 是否透明背景颜色。当设置为true时不绘制背景颜色。 /// |是否透明背景颜色。当设置为true时不绘制背景颜色。
/// </summary> /// </summary>
public bool transparentBackground public bool transparentBackground
{ {